home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / rpladd.zip / RPLADD.DOC next >
Text File  |  1996-03-07  |  8KB  |  187 lines
  1.  
  2.           RPLADD.EXE  LAN Server 4.0 Productivity Aids Program
  3.  
  4.  
  5. This program, RPLADD.EXE, can be used to create LAN Server Version 4.0
  6. or above, remote IPL client definitions from an OS/2 command line.
  7. The files included in this package are:
  8.  
  9.      RPLADD.EXE - Executable program
  10.      RPLADD.FIL - Sample input file
  11.      RPLADD.DOC - This README document
  12.      RPLADD.ICO - Icon file
  13.  
  14.  
  15. USING RPLADD
  16. ============
  17.  
  18. RPLADD can be used to create remote IPL definitions from any OS/2 workstation
  19. within the same domain.  The local workstation and the target remote IPL
  20. server must both be running LAN Server Version 4.0 or above.  The local
  21. workstation must be logged on with administrator level privilege.  The target
  22. remote IPL server must have the Server service started, but does not require
  23. that the Remoteboot service be started.
  24.  
  25.  
  26. COMMAND LINE PARAMETERS
  27. =======================
  28.  
  29.   REQUIRED PARAMETERS
  30.  
  31.     /F:input_filename
  32.       This required parameter specifies the path and file name of the source
  33.       input file containing the formatted records that will be used as
  34.       input to the RPLADD.EXE program.  See the INPUT FILE FORMAT section
  35.       of this document for an explanation of the input file format.
  36.  
  37.  
  38.   OPTIONAL PARAMETERS
  39.  
  40.    /O:output_log_filename
  41.      This optional parameter specifies the path and file name of an ouput
  42.      log file that will be used to record all output from the RPLADD.EXE
  43.      program.  If this parameter is specified, all output that would normally
  44.      be displayed on the display, will be redirected to a file.
  45.  
  46.    /Debug
  47.      This optional parameter specifies to display additional debug information
  48.      about the execution of the RPLADD.EXE program.  This parameter can be
  49.      useful for displaying information about the parameters that are parsed
  50.      from the input file.
  51.  
  52.  
  53. INPUT FILE FORMAT
  54. =================
  55.  
  56. RPLADD.EXE requires an input file containing formatted records.  A sample
  57. input file, RPLADD.FIL, is supplied with this program.  Below is a brief
  58. description of the input file format.
  59.  
  60.   PARAMETER 1 = CREATE TYPE
  61.  
  62.     CREATE TYPE = 2 is specified to create a new machine definition
  63.        and will inherit the default machine configuration.
  64.  
  65.     CREATE TYPE = 12 is specified to create a new machine from an existing
  66.        model machine definition.  The new machine will inherit all of the
  67.        configuration files from the model machine definition.  The new
  68.        machine and the model machine must exist on the same server.
  69.  
  70.   PARAMETER 2 = NAME
  71.  
  72.     The name of the new remote IPL machine definition.  The machine name
  73.        must be a unique name within the Domain.  DOS remote IPL machine
  74.        names cannot exceed 8 characters in length.  Machine names defined
  75.        on a server with a FAT file system cannot exceed 8 characters in
  76.        length.
  77.  
  78.   PARAMETER 3 = ADAPTER ADDRESS
  79.  
  80.     The ADAPTER ADDRESS is the 12 character universal adapter address of
  81.        the remote IPL machine.
  82.  
  83.   PARAMETER 4 = SERVER RECORD IDENTIFIER
  84.  
  85.    The SERVER RECORD IDENTIFIER specifies the operating system plus
  86.        network adapter type configuration information.
  87.        The SERVER RECORD IDENTIFIER specified must exist as an enabled
  88.        server record identifier on the remote IPL server.
  89.  
  90.   OS/2 PARAMETER 5 = OS/2 DRIVE (OS/2 PARAMETER ONLY)
  91.  
  92.     The OS/2 DRIVE specifies the boot drive letter for the OS/2 remote IPL
  93.     machine.
  94.     NOTE:  USE THIS PARAMETER FOR OS/2 MACHINE DEFINITIONS ONLY!
  95.  
  96.   OS/2 PARAMETER 6 = OS/2 CONFIG (OS/2 PARAMETER ONLY)
  97.  
  98.     The OS/2 CONFIG parameter is used to specify OS/2 configuration
  99.     parameters for the OS/2 remote IPL machine.  A combination of 3
  100.     flags(4 flags for DBCS countries) are to be specified, one from
  101.     each of the catagories.  There should be no spaces between the flags.
  102.  
  103.     SWAPPER.DAT LOCATION
  104.        L = SWAPPER.DAT file located on remote IPL machine hard disk
  105.        S = SWAPPER.DAT file located on server hard disk
  106.     BUS ARCHITECTURE
  107.        I = ISA bus architecture
  108.        M = Microchannel bus architecture
  109.     DISPLAY TYPE
  110.        3 = S-3 Super VGA display
  111.        8 = 8514 display
  112.        E = EGA display
  113.        U = Super VGA display(non S-3)
  114.        V = VGA display
  115.        X = XGA display
  116.        N = PS/55 16 color display(DBCS countries)
  117.        O = PS/55 256 color display(DBCS countries)
  118.        P = PS/55 256P color display(DBCS countries)
  119.     KEYBOARD TYPE (DBCS COUNTRIES ONLY)
  120.        A = DBCS AX keyboard
  121.        B = DBCS 101 keyboard
  122.        C = DBCS 103 keyboard
  123.        D = DBCS 106 keyboard
  124.  
  125.     NOTE:  USE THIS PARAMETER FOR OS/2 MACHINE DEFINITIONS ONLY!
  126.  
  127.   DOS PARAMETER 5 = DOS IMAGE (DOS PARAMETER ONLY)
  128.  
  129.     The DOS IMAGE specifies the DOS image file for the remote IPL machine.
  130.     The DOS image file must exist on the target server before the DOS
  131.     remote IPL machine can be defined.  Do not specify a file name extention
  132.     for the DOS IMAGE parameter.
  133.     NOTE:  USE THIS PARAMETER FOR DOS MACHINE DEFINITIONS ONLY!
  134.  
  135.  
  136.   FINAL PARAMETER = SERVERNAME (Optional)
  137.  
  138.     The SERVERNAME is the name of the target server where the remote IPL
  139.     machine will be created.  The server name specified must exist within
  140.     the same domain as the machine where RPLADD is being run.
  141.     The SERVERNAME parameter is optional if the remote IPL machines are
  142.     to be created on the same machine where RPLADD is being run.
  143.  
  144.  
  145. Below are sample input lines...
  146.  
  147. ;CREATE  NAME           ADAPTER       SERVER RECORD  OS/2   OS/2    DOS       [SERVERNAME]
  148. ;TYPE                   ADDRESS       IDENTIFIER     DRIVE  CONFIG  IMAGE     (Optional)
  149. ;------  -------------- ------------  -------------  -----  ------  --------  ------------
  150. 2        OS2_MACH       10005A111111  R_230_OTK      Z      LI3
  151. 2        DOS_MACH       10005A222222  R_DTK                         STD3HFUL
  152. 2        OS2JAPAN       10005A333333  R_21_OTK       J      SMND              SRV_JAPAN
  153.  
  154.  
  155. ;CREATE  NAME           ADAPTER       MODEL         [SERVERNAME]
  156. ;TYPE                   ADDRESS       NAME          (Optional)
  157. ;------  -------------  ------------  ------------  ------------
  158. 12       NEW_MACH       10005A444444  MODEL_MACH    RIPL_SERV
  159.  
  160.  
  161.  
  162. The results expected from each line above are...
  163.  
  164.   A remote IPL definition for OS2_MACH will be created on the local server.
  165.   OS2_MACH will be defined as an OS/2 remote IPL machine and will be created
  166.   from the R_230_OTK standard configuration files.  OS2_MACH will boot from
  167.   drive letter "Z:" and will be configured for a local SWAPPER.DAT file,
  168.   ISA bus architecture and an S3 SVGA display.  Note that the remote IPL
  169.   server must be preconfigured to support SVGA display types.
  170.  
  171.   A remote IPL definition for DOS_MACH will be created on the local server.
  172.   DOS_MACH will be defined as a DOS remote IPL machine and will be created
  173.   from the R_DTK standard configuration files.  DOS_MACH will boot using
  174.   the STD3HFUL DOS image file.
  175.  
  176.   A remote IPL definition for OS2JAPAN will be created on SVR_JAPAN server.
  177.   OS2JAPAN will be defined as an OS/2 remote IPL machine and will be created
  178.   from the R_21_OTK standard configuration files.  OS2JAPAN will boot from
  179.   drive letter "J:" and will be configured for a server SWAPPER.DAT file,
  180.   microchannel bus architecture, PS/55 16 color display and DBCS 106 keyboard.
  181.  
  182.   A remote IPL definition for NEW_MACH will be created on RIPL_SERV server.
  183.   NEW_MACH will inherit all the configuration information of MODEL_MACH.
  184.   NEW_MACH and MODEL_MACH will exist on the same remote IPL server.
  185.  
  186. End of RPLADD.DOC.
  187.