home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / rplkt2.exe / RPLCOM.DOC < prev    next >
Text File  |  1993-10-14  |  32KB  |  742 lines
  1.  
  2.  
  3. Trademarks
  4.  
  5. NetWare and Novell are registered trademarks of Novell, Inc.
  6. IBM is a registered trademark of IBM, Inc.
  7.  
  8.  
  9.  
  10. References
  11.  
  12. The following publications contain information that may be helpful
  13. in reading this document:
  14.  
  15.      1) NOVELL NetWare Version 3.11 Installation
  16.           (See Appendix D: Using DOSGEN to Add Remote Reset)
  17.      2) IBM Local Area Network Technical Reference, SC30-3383-3
  18.      3) IBM Remote Program Load User's Guide, 83X7840
  19.      4) IBM Token-Ring Network Architecture Reference, SC30-3374-02
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26. Introducing RPL.com
  27.  
  28. RPL.com is a DOS Terminate and Stay Resident (TSR) Module that acts
  29. as a Protocol Stack and responds to the IBM architected Remote
  30. Program Load (RPL) frames as defined in the "IBM Remote Program
  31. Load User's Guide".  It is used in networks that have diskless
  32. workstations installed with the RPL BIOS Module.  Currently, this
  33. is supported on the following network adapters:
  34.  
  35.      IBM Ethernet Adapters
  36.      IBM PC Network Adapters
  37.      IBM Token-Ring Network Adapters
  38.  
  39. Specifically, RPL.com will respond to the following frames:
  40.  
  41.      FIND                RPL.com will respond with a FOUND frame.
  42.      SEND.FILE.REQUEST   RPL.com will respond with a
  43.                          FILE.DATA.RESPONSE frame.
  44.  
  45. RPL.com is a Terminate Stay Resident program to be loaded at Novell 
  46. DOS Clients that are also to function as "RPL Servers".  A Novell 
  47. ODI driver, configured for the IEEE 802.2 Frame type, must be loaded
  48. at the Novell DOS Client "RPL Server" before RPL.com will operate 
  49. properly.    
  50.  
  51. In addition, the BOOTNCP.com program must be loaded on the "RPL Server"
  52. in order for it to respond to NetWare Core Protocol (NCP) requests made
  53. by the bootstrap programs.
  54.  
  55.  
  56.  
  57.  
  58. Features of RPL.com
  59.  
  60. RPL.com comes with five new and improved BOOTSTRAP programs:
  61. ETHER.rpl, F1ETH.rpl, PCN2L.rpl, RBOOT.rpl, and TOKEN.rpl. 
  62. Together, these files offer the following features:
  63.  
  64.      BOOTCONF.sys        Wildcard characters (* and ?) are allowed
  65.                          in specifying Node Addresses.  Also, more
  66.                          than one Disk Image File name is allowed
  67.                          per Node Address.  BOOTCONF.sys is parsed
  68.                          by RPL.com at the "RPL Server" to minimize
  69.                          Network Traffic.
  70.  
  71.      IBM LAN Support     RPL now works reliably with the IBM
  72.                          LAN Support Program.
  73.  
  74.      RPLFIX and RPLODI   These two programs are NOT required when
  75.                          booting a workstation with an RPL style 
  76.                          prom installed.
  77.  
  78.      Source Routing      Booting an RPL Client across a Source Routing
  79.                          Bridge is supported..
  80.  
  81.  
  82.      PS/2 REFERENCE      The *.rpl files will communicate with the
  83.                          BIOS on a PS/2 machine and ask it if it needs
  84.                          to run REFERENCE.  If the BIOS says "yes" to
  85.                          this query, RBOOT.RPL, ETHER.RPL, TOKEN.RPL,
  86.                          F1ETH.RPL, AND PCN2L.RPL will automatically
  87.                          present a menu on the workstation screen
  88.                          with a "MXX.REF" boot image file name, where
  89.                          "XX" is the PS/2 Model number returned by
  90.                          the PS/2's BIOS.  This file name is for
  91.                          the reference diskette image that needs to
  92.                          be dosgened and copied into the \LOGIN
  93.                          directory.  An example of one of these file
  94.                          names would be:  MF8.REF where F8 is the model
  95.                          number returned by a PS/2 Model 56LS BIOS.   
  96.  
  97.  
  98.  
  99.  
  100.  
  101. Installing RPL.com
  102.  
  103. The following BOOTSTRAP programs come with RPL.com and should be
  104. installed in a  \LOGIN  directory on the RPL Server.
  105.  
  106.      ETHER.rpl      For IBM MCA Ethernet Adapters
  107.                     (an SMC/WD 8003/A adapter OEM'd by IBM)
  108.      F1ETH.rpl      For IBM Model 25SX Ethernet Adapters
  109.                     (an ISA DLINK ethernet adapter OEM'd by IBM) 
  110.      PCN2L.rpl      For IBM PC Network Adapters
  111.      RBOOT.rpl      For Adapters using the Novell Enhanced Boot Proms
  112.                     (proms engineered to the Novell Boot ROM spec.)
  113.      TOKEN.rpl      For IBM Shared-Ram Token-Ring Network Adapters
  114.  
  115. An appropriate BOOTSTRAP program gets downloaded to the workstation
  116. in response to a SEND.FILE.REQUEST from the Boot ROM RPL Module.
  117.  
  118. RPL.com should be installed on the Hard Disk of the RPL Server.
  119.  
  120.  
  121.  
  122.  
  123. Loading RPL.com on the RPL Server
  124.  
  125. To use RPL.com, you must have installed the RPL ROM Module on your
  126. network adapter board in the RPL Client.  This RPL module must be
  127. capable of sending the IBM architected RPL frame sequence.  See the
  128. "IBM Remote Program Load User's Guide" for information on this
  129. architecture.
  130.  
  131. Implementing the RPL function consists of creating a Disk Image
  132. File in the \LOGIN directory of the drive where RPL.com is loaded.
  133. A description of this process is given in the NOVELL NetWare
  134. Version 3.11 Installation manual.
  135.  
  136. In addition,  certain IBM Micro-Channel computers, such as the new
  137. 386SLC, have a BIOS image file associated with them.  This file
  138. comes with the computer on a diskette, and has a file extension of
  139. .IML.  You MUST create a directory called \LOGIN\IBMLAN\DCDB\IMAGES
  140. and install ALL .IML files in this directory.
  141.  
  142. BOOTNCP.com must be loaded at the DOS command prompt (or from a batch
  143. file) before RPL.com is loaded as follows:
  144.  
  145.           BOOTNCP <ENTER>
  146.  
  147. BOOTNCP.com is a program written for the RPL Server that responds to
  148. NetWare Core Protocol (NCP) frames for accessing the Net$dos.sys file
  149. or other boot image files.
  150.  
  151.  
  152. RPL.com can then be loaded from the DOS command promt or from a batch
  153. file.  RPL.com syntax or command line parameters follow:
  154.  
  155.  
  156.  
  157.           RPL  [ACK] [BIND board] [BUFFERS=nn] [DEFAULT] [FRAME=ff]
  158.                [GNS] [NOACK] [NODEFAULT] [NOGNS] [NOPROTECT] [NOTRO]
  159.                [PROTECT] [PS=server] [TRO] [U] [UNBIND board] 
  160.                [WAIT TIME=ssss] [?] <ENTER>
  161.  
  162.  
  163. RPL.com command line parameters explained in detail:
  164. The parameters specified by "[]" (e.g. [ACK] etc.) are OPTIONAL, 
  165. NOT Case Sensitive, separated by blanks or commas, and may be 
  166. entered in any order.  They are described below:
  167.  
  168.      ACK       Use this parameter if you wish to configure the RPL
  169.                BOOT ROM Module to ACKnowledge FILE.DATA.RESPONSE
  170.                frames sent by RPL.com.  By DEFAULT, RPL.com will
  171.                send FILE.DATA.RESPONSE frames in a BURST mode. 
  172.                This parameter allows pacing by the workstation, if
  173.                the Adapter on the workstation cannot keep up with
  174.                RPL.com.
  175.  
  176.      BIND      Use this parameter to BIND RPL to a specific
  177.                NetWare ODI board that is configured for the IEEE
  178.                802.2 frame type.  board may be specified by name,
  179.                or optionally, by MLID board number (eg BIND #n),
  180.                where n is a DECIMAL number.
  181.                     
  182.                If multiple boards are to be BOUND; specify the
  183.                BIND parameter MULTIPLE times.
  184.  
  185.                If BIND is not specified on the Command Line or in
  186.                the NET.cfg file, RPL.com will search for the FIRST
  187.                802.2 board that is installed and use it.
  188.  
  189.      BUFFERS=nn     nn is a DECIMAL number specifying the number
  190.                     of Receive buffers to configure.  The DEFAULT
  191.                     is FIVE.
  192.  
  193.      DEFAULT   This parameter will OVERRIDE the NODEFAULT
  194.                parameter if it is specified on the BIND command in
  195.                NET.cfg.
  196.  
  197.      FRAME=ff  Use this parameter if you wish to configure the
  198.                BOOTSTRAP program to use a frame type other than
  199.                the default to access the file server.  Valid
  200.                responses are:
  201.  
  202.                FRAME=802.2    This is the DEFAULT.
  203.  
  204.                FRAME=EII      Configure the BOOTSTRAP program for
  205.                               ETHERNET_II.  This option should
  206.                               only be used on ETHERNET networks.
  207.  
  208.                FRAME=SNAP     Configure the BOOTSTRAP program for
  209.                               the SNAP frame type.
  210.  
  211.                If FRAME=EII or FRAME=SNAP is selected, RPL.com 
  212.                will force the BOOTSTRAP program to do a Get
  213.                Nearest Server (GNS).
  214.  
  215.                The FRAME parameter is fully supported on BOOT ROMs
  216.                that use the RBOOT.rpl BOOTSTRAP program.  This
  217.                parameter is IGNORED on BOOT ROMs that use
  218.                PCN2L.rpl and TOKEN.rpl.  However, FRAME=EII or
  219.                FRAME=SNAP will configure ETHER.rpl to use
  220.                ETHERNET_II instead of 802.3.  Specifying FRAME=EII
  221.                on a Token-Ring BOOT ROM will be ignored.
  222.  
  223.      GNS       This parameter specifies that you wish the
  224.                workstation to do a Get Nearest Server request when
  225.                the appropriate BOOTSTRAP program gets downloaded. 
  226.                Normally, RPL.com will fill in the bootstrap
  227.                program with the RPL Server information, so that
  228.                it does NOT need to do a Get Nearest Server request.
  229.            Using this parameter MAY cause the RPL workstation 
  230.                to find a server OTHER than the one where RPL.com 
  231.                is located.
  232.  
  233.      NOACK     This parameter will OVERRIDE the ACK parameter if
  234.                it is specified on the BIND command in NET.cfg.
  235.  
  236.      NODEFAULT This parameter tells RPL.com to NOT respond to a
  237.                FIND frame UNLESS the node address of the
  238.                workstation is found in the BOOTCONF.sys file.  It
  239.                is provided for security reasons.  The workstation
  240.                WILL NOT boot until the system administrator
  241.                inserts into the BOOTCONF.sys file the node address
  242.                and associated Disk Image File name(s) to use when
  243.                booting the workstation.  A further description of
  244.                BOOTCONF.sys is given under the heading of Unique
  245.                Boot Sequences using RPL.com.
  246.  
  247.      NOGNS     This parameter will OVERRIDE the GNS parameter if
  248.                it is specified on the BIND command in NET.cfg.
  249.  
  250.      NOPROTECT This parameter will OVERRIDE the PROTECT parameter
  251.                if it is specified on the BIND command in NET.cfg.
  252.  
  253.      NOTRO     This parameter will OVERRIDE the TRO parameter if
  254.                it is specified on the BIND command in NET.cfg.
  255.  
  256.      PROTECT   This parameter tells RPL.com to configure the
  257.                BOOTSTRAP program so that it will protect itself in
  258.                the workstation memory.  It does this by adjusting
  259.                the Memory Size variable in the BIOS data area
  260.                (40:13) to reflect the amount of memory that it
  261.                uses.  Using this parameter will REDUCE the amount
  262.                of memory that the workstation has available for
  263.                DOS by about 12k.  It is recommended that this
  264.                parameter NOT be USED unless absolutely necessary.
  265.  
  266.      PS=server This parameter tells the BOOTSTRAP program to
  267.                attach to a NetWare file server other than the one
  268.                where RPL.com is loaded.  server is the name of a
  269.                NetWare file server that contains the Image file
  270.                for the workstation.
  271.  
  272.      TRO       This parameter specifies that you wish the
  273.                Bootstrap Program to do a This Ring Only count of
  274.                THREE (3) on all Broadcasts frames.  It is useful
  275.                in a SOURCE ROUTING environment and Servers are
  276.                available on the local ring.
  277.  
  278.      U         This parameter will UNLOAD a previously installed
  279.                RPL.com.  All boards that are BOUND will be
  280.                UNBOUND,  and all memory used returned to DOS.
  281.  
  282.      UNBIND    Use this parameter to UNBIND RPL from a specific
  283.                NetWare ODI board.  board may be specified by name,
  284.                or optionally, by MLID board number (eg UNBIND #n),
  285.                where n is a DECIMAL number.
  286.  
  287.      WAIT TIME=ssss This parameter specifies the number of SECONDS
  288.                     you wish the workstation to wait before
  289.                     automatically selecting the cursored Disk
  290.                     Image Name when multiple Disk Image Names are
  291.                     specified in BOOTCONF.sys.  (See "BOOTCONF.sys
  292.                     Extensions")
  293.  
  294.                     The DEFAULT for this parameter is 0000, which
  295.                     means forever.  Any value from 0000 to 65535
  296.                     is allowed.
  297.  
  298.      ?         This parameter will display a list of all boards
  299.                which RPL.com is currently BOUND.
  300.  
  301.  
  302.  
  303.  
  304. Creating and using NET.cfg
  305.  
  306. The NET.cfg file is used by various ODI modules (including the LSL,
  307. LAN Drivers, and Protocol Stacks) to obtain the network system
  308. configuration information at initialization time.  RPL.com reads
  309. this file and parses it for a section describing the RPL
  310. configuration to use.  Specifically, it searches for the following
  311. MAIN section heading:
  312.  
  313.      PROTOCOL RPL
  314.  
  315. Note that the heading is NOT case sensitive, but the word
  316. "PROTOCOL" MUST begin in column one (1) of the file.
  317.  
  318. After this heading is found, RPL.com looks for the following
  319. INDENTED Keywords to configure itself:
  320.  
  321.      PROTOCOL RPL
  322.           BIND board [ACK] [GNS] [NODEFAULT] [PS=server]
  323.                        [PROTECT] [TRO] [WAIT TIME=ssss]
  324.           BUFFERS nn
  325.  
  326. The parameters specified by "[]" are OPTIONAL, NOT Case Sensitive,
  327. separated by blanks, and may be entered in any order. They are
  328. described below:
  329.  
  330.      BUFFERS=nn     nn is a DECIMAL number specifying the number
  331.                     of Receive buffers to configure.  The DEFAULT
  332.                     is FIVE.  Use this parameter to optimize for
  333.                     performance.
  334.  
  335.      BIND      Use this parameter to BIND RPL to a specific
  336.                NetWare ODI board that is configured for the IEEE
  337.                802.2 frame type.  board may be specified by name,
  338.                or optionally, by MLID board number (eg BIND #n),
  339.                where n is a DECIMAL number specifying the board to
  340.                BIND.
  341.                     
  342.                If multiple boards are to be BOUND; specify the
  343.                BIND parameter MULTIPLE times, each on a DIFFERENT
  344.                line in NET.cfg.
  345.  
  346.                If BIND is not specified on the Command Line or in
  347.                the NET.cfg file, RPL.com will search for the FIRST
  348.                802.2 board that is installed and use it.
  349.  
  350.                The parameters specified with the BIND command are
  351.                OPTIONAL and are described below:
  352.  
  353.           ACK       Use this parameter if you wish to configure
  354.                     the RPL BOOT ROM Module to ACKnowledge
  355.                     FILE.DATA.RESPONSE frames sent by RPL.com.  By
  356.                     DEFAULT, RPL.com will send FILE.DATA.RESPONSE
  357.                     frames in a BURST mode.  This parameter allows
  358.                     pacing by the workstation, if the Adapter on
  359.                     the workstation cannot keep up with RPL.com.
  360.  
  361.           FRAME=ff  Use this parameter if you wish to configure
  362.                     the BOOTSTRAP program to use a frame type
  363.                     other than the default to access the file
  364.                     server.  Valid responses are:
  365.  
  366.                     FRAME=802.2    This is the DEFAULT.
  367.  
  368.                     FRAME=EII      Configure the BOOTSTRAP program
  369.                                    for ETHERNET_II.  This option
  370.                                    should only be used on ETHERNET
  371.                                    networks.
  372.  
  373.                     FRAME=SNAP     Configure the BOOTSTRAP program
  374.                                    for SNAP.
  375.  
  376.                     If FRAME=EII or FRAME=SNAP is selected,
  377.                     RPL.com  will force the BOOTSTRAP program to
  378.                     do a Get Nearest Server (GNS).
  379.  
  380.                     The FRAME parameter is fully supported on BOOT
  381.                     ROMs that use the RBOOT.rpl BOOTSTRAP program. 
  382.                     This parameter is IGNORED on BOOT ROMs that
  383.                     use PCN2L.rpl and TOKEN.rpl.  However,
  384.                     FRAME=EII or FRAME=SNAP will configure
  385.                     ETHER.rpl to use ETHERNET_II instead of 802.3. 
  386.                     Specifying FRAME=EII on a Token-Ring BOOT ROM
  387.                     will be ignored.
  388.  
  389.           GNS       This parameter specifies that you wish the
  390.                     workstation to do a Get Nearest Server request
  391.                     when the appropriate BOOTSTRAP program gets
  392.                     downloaded.  Normally, RPL.com will fill in
  393.                     the bootstrap program with the RPL Server
  394.                     information, so that it does NOT need to do 
  395.                     a Get Nearest Server request.  Using this
  396.                     parameter MAY cause the workstation to find a
  397.                     server OTHER than the one where RPL.com
  398.                     is located.
  399.  
  400.           NODEFAULT This parameter tells RPL.com to NOT respond to
  401.                     a FIND frame UNLESS the node address of the
  402.                     workstation is found in the BOOTCONF.sys file. 
  403.                     It is provided for security reasons.  The
  404.                     workstation WILL NOT boot until the system
  405.                     administrator inserts into the BOOTCONF.sys
  406.                     file the node address and associated Disk
  407.                     Image File name(s) to use when booting the
  408.                     workstation.  A further description of
  409.                     BOOTCONF.sys is given under the heading of
  410.                     Unique Boot Sequences using RPL.com.
  411.  
  412.           PROTECT   This parameter tells RPL.com to configure the
  413.                     BOOTSTRAP program so that it will protect
  414.                     itself in the workstation memory.  It does
  415.                     this by adjusting the Memory Size variable in
  416.                     the BIOS data area (40:13) to reflect the
  417.                     amount of memory that it uses.  Using this
  418.                     parameter will REDUCE the amount of memory
  419.                     that the workstation has available for DOS by
  420.                     about 12k.  It is recommended that this
  421.                     parameter NOT be USED unless absolutely
  422.                     necessary.
  423.  
  424.           PS=server This parameter tells the BOOTSTRAP program to
  425.                     attach to a NetWare file server other than the
  426.                     one where RPL.com is loaded.  server is the
  427.                     name of a NetWare file server that contains
  428.                     the Image file for the workstation.
  429.  
  430.           TRO       This parameter specifies that you wish the
  431.                     Bootstrap Program to do a This Ring Only count
  432.                     of THREE (3) on all Broadcasts frames.  It is
  433.                     useful in a SOURCE ROUTING environment and
  434.                     Servers are available on the local ring.
  435.  
  436.           WAIT TIME=ssss This parameter specifies the number of
  437.                          SECONDS you wish the workstation to wait
  438.                          before automatically selecting the
  439.                          cursored Disk Image Name when multiple
  440.                          Disk Image Names are specified in
  441.                          BOOTCONF.sys.  (See "BOOTCONF.sys
  442.                          Extensions")
  443.  
  444.                          The DEFAULT for this parameter is 0000,
  445.                          which means forever.  Any value from 0000
  446.                          to 65535 is allowed.
  447.  
  448.  
  449.  
  450.  
  451. Unique Boot Sequences using RPL.com
  452.  
  453. BOOTCONF.sys is an ASCII text file that allows you to specify a
  454. unique Disk Image File for each workstation that needs access to
  455. different files.  You create BOOTCONF.sys using your favorite DOS
  456. ASCII text editor.  The process of creating unique Disk Image 
  457. Files is described in detail in the NOVELL NetWare Version 3.11 
  458. Installation manual.
  459.  
  460.  
  461.  
  462.  
  463. BOOTCONF.sys Extensions
  464.  
  465. When RPL.com loads it will search the \LOGIN directory of the
  466. current drive for a BOOTCONF.sys file.  If it finds it, it will
  467. read it into a memory buffer so that it can parse it when a FIND
  468. frame is received from a workstation.  Note that the parsing of
  469. BOOTCONF.sys is done by RPL.com and NOT the BOOTSTRAP program to
  470. minimize the amount of traffic on the network during the RPL
  471. process.  The extensions to BOOTCONF.sys are given in this section.
  472.  
  473.  
  474.  
  475. Using Wildcard Characters in BOOTCONF.sys
  476.  
  477. Wildcard characters (* and ?) are allowed in the line specifying
  478. the node address of the workstation.  This will allow the system
  479. administrator more flexibility in building the BOOTCONF.sys file. 
  480. The rules for these wildcard characters are:
  481.  
  482.      *    Use the ASTERISK character to specify a RANGE of digits
  483.           in the node address. For example, if the node address of
  484.           the workstation is 10005A123456, it may be specified as
  485.           0x*123456 in BOOTCONF.sys.  In this example, RPL.com will
  486.           match the node address with ANY node address that ends in
  487.           123456.
  488.  
  489.           Note that only ONE asterisk (*) may appear in the node
  490.           address.
  491.  
  492.      ?    Use the QUESTION MARK character to specify ANY digit in
  493.           the node address.  In the example above, the node address
  494.           could be specified as 0x??????123456 which is equivalent
  495.           to 0x*123456.
  496.  
  497.           You may use wildcard characters to specify a DEFAULT Disk
  498.           Image File for all workstations on the network that do
  499.           not have a specific Disk Image File.  You do this by
  500.           placing the line:
  501.  
  502.                     0x* = DEFAULT.sys
  503.           or        0x???????????? = DEFAULT.sys
  504.  
  505.           as the LAST line in BOOTCONF.sys.  Either one of these
  506.           lines will match on ALL workstation node addresses.  The
  507.           DEFAULT.sys (or any name you desire) Disk Image File is
  508.           generated by DOSGEN, the same as any Disk Image File.
  509.  
  510.  
  511.  
  512. More than ONE Disk Image File per Node Address
  513.  
  514. Each line in BOOTCONF.sys that contains a node address may specify
  515. more than one Disk Image File name, separated by one or more BLANK
  516. characters.  In this case, the BOOTSTRAP program will present the
  517. workstation user a PROMPT at boot up time to select the Disk Image
  518. File to boot.  For example,  if a workstation's node address is
  519. 10005A123456, the line:
  520.  
  521.      0x10005a123456 = ONE.sys TWO.sys THREE.dos
  522.  
  523.      will cause the BOOTSTRAP program to present:
  524.  
  525.  
  526.  
  527.      Place CURSOR on DISK IMAGE file; Hit ENTER when Ready: 
  528.  
  529.           ONE.sys
  530.           TWO.sys
  531.           THREE.dos
  532.  
  533.  
  534.  
  535.      on the workstation screen.  The BOOTSTRAP program will then
  536.      use NCP calls to open the selected Disk Image File.  If it
  537.      does NOT exist, it will display:
  538.  
  539.           Unable to OPEN Disk Image File
  540.  
  541.      and retry the operation.
  542.  
  543.      Up to TEN Disk Image File names may be entered for each node
  544.      address in BOOTCONF.sys.  Note that they must be separated by
  545.      one or more BLANK characters, and they must all fit on ONE
  546.      line.
  547.  
  548.  
  549.  
  550. Multiple Lines per Node Address
  551.  
  552. The ASCII COLON (:) can be used to allow for multiple lines when
  553. specifying a particular node address in BOOTCONF.sys.  It is
  554. provided for convenience when specifying multiple parameters on the
  555. Node Address line.
  556.  
  557. To use this feature, place the ASCII COLON (:) at the end of the
  558. line.  Note that it must be preceded by at LEAST one ASCII blank:
  559.  
  560.      0x10005a460025 = NET$DOS.sys FRED.sys :
  561.                JOE.sys
  562.  
  563.  
  564.  
  565. BOOTCONF.sys BIND Override Parameters
  566.  
  567. When RPL.com parses BOOTCONF.sys, it allows the user to override
  568. the BIND time parameters with parameters specific to a particular
  569. workstation that is being booted.  By default, the parameters
  570. entered on the Command Line when RPL.com was loaded will be merged
  571. with the parameters that were given by the BIND keyword in NET.cfg
  572. to apply to ALL workstations that are attached to the particular
  573. board RPL.com is BOUND to.  The following commands are allowed
  574. on a per NODE basis, which if used, will override ALL previous
  575. parameters given:
  576.  
  577.      ACK       Use this parameter if you wish to configure the RPL 
  578.                BOOT ROM Module program to ACKnowledge
  579.                FILE.DATA.RESPONSE frames sent by RPL.com.  By
  580.                DEFAULT, RPL.com will send FILE.DATA.RESPONSE
  581.                frames in a BURST mode.  This parameter allows
  582.                pacing by the workstation, if the Adapter on the
  583.                workstation cannot keep up with RPL.com.
  584.  
  585.      FRAME=ff  Use this parameter if you wish to configure the
  586.                BOOTSTRAP program to use a frame type other than
  587.                the default to access the file server.  Valid
  588.                responses are:
  589.  
  590.                FRAME=802.2    This is the DEFAULT.
  591.  
  592.                FRAME=EII      Configure the BOOTSTRAP program for
  593.                               ETHERNET_II.  This option should
  594.                               only be used on ETHERNET networks.
  595.  
  596.                FRAME=SNAP     Configure the BOOTSTRAP program for
  597.                               SNAP.
  598.  
  599.                If FRAME=EII or FRAME=SNAP is selected, RPL.com 
  600.                will force the BOOTSTRAP program to do a Get
  601.                Nearest Server (GNS).
  602.  
  603.                The FRAME parameter is fully supported on BOOT ROMs
  604.                that use the RBOOT.rpl BOOTSTRAP program.  This
  605.                parameter is IGNORED on BOOT ROMs that use
  606.                PCN2L.rpl and TOKEN.rpl.  However, FRAME=EII or
  607.                FRAME=SNAP will configure ETHER.rpl to use
  608.                ETHERNET_II instead of 802.3.  Specifying FRAME=EII
  609.                on a Token-Ring BOOT ROM will be ignored.
  610.  
  611.  
  612.      GNS       This parameter specifies that you wish the
  613.                workstation to do a Get Nearest Server request when
  614.                the appropriate BOOTSTRAP program gets downloaded. 
  615.                Normally, RPL.com will fill in the bootstrap
  616.                program with the RPL Server's information,
  617.                so that the bootstrap program does NOT need to do a
  618.                Get Nearest Server request.  Using this parameter 
  619.                MAY cause the workstation to find a server OTHER 
  620.                than the one where RPL.com is located.
  621.  
  622.      NOACK     This parameter will override the ACK parameter
  623.                specified on the BIND command.
  624.  
  625.      NOGNS     This parameter will override the GNS parameter
  626.                specified on the BIND command.
  627.  
  628.      NOPROTECT This parameter will override the PROTECT parameter
  629.                specified on the BIND command.
  630.  
  631.      NOTRO     This parameter will OVERRIDE the TRO parameter if
  632.                it is specified on the BIND command in NET.cfg.
  633.  
  634.      PROTECT   This parameter tells RPL.com to configure the
  635.                BOOTSTRAP program so that it will protect itself in
  636.                the workstation memory.  It does this by adjusting
  637.                the Memory Size variable in the BIOS data area
  638.                (40:13) to reflect the amount of memory that it
  639.                uses.  Using this parameter will REDUCE the amount
  640.                of memory that the workstation has available for
  641.                DOS by about 12k.  It is recommended that this
  642.                parameter NOT be USED unless absolutely necessary.
  643.  
  644.      PS=server This parameter tells the BOOTSTRAP program to
  645.                attach to a NetWare Server other than the RPL Server
  646.                where RPL.com is loaded.  server is the name of a
  647.                NetWare file server that contains the Image file
  648.                for the workstation.
  649.  
  650.      REP       string1|string2 allows you to REPlace ALL
  651.                occurrences of string1 with string2 in the Disk
  652.                Image File.  The '|' (ASCII 7Ch) delimiter is
  653.                REQUIRED to delimit the string values.
  654.  
  655.                Use this parameter to DYNAMICALLY re-configure a
  656.                Disk Image File during the RPL process.  It is
  657.                useful for tailoring files such as AUTOEXEC.BAT or
  658.                CONFIG.SYS to a specific workstation.
  659.  
  660.                The rules for using REP are given below:
  661.                     
  662.                1)   The search IS case sensitive.  The Bootstrap
  663.                     program will search for string1 EXACTLY as it
  664.                     is entered in BOOTCONF.sys.
  665.                2)   ALL occurrences of string1 will be replaced
  666.                     with string2 in the Disk Image File.
  667.                3)   string2 MUST be equal to OR shorter than
  668.                     string1.
  669.                4)   If string2 is shorter than string1, the Disk
  670.                     Image File will be padded with ASCII Blanks
  671.                     when the substitution is made.
  672.                5)   string2 must contain NO embedded ASCII Blanks.
  673.                     The FIRST blank that is encountered is
  674.                     interpreted as the end of the string.
  675.  
  676.      TRO       This parameter specifies that you wish the
  677.                Bootstrap Program to do a This Ring Only count of
  678.                THREE (3) on all Broadcasts frames.  It is useful
  679.                in a SOURCE ROUTING environment and Servers are
  680.                available on the local ring.
  681.  
  682.      WAIT TIME=ssss This parameter specifies the number of SECONDS
  683.                     you wish the workstation to wait before
  684.                     automatically selecting the cursored Disk
  685.                     Image Name when multiple Disk Image Names are
  686.                     specified in BOOTCONF.sys.  (See "BOOTCONF.sys
  687.                     Extensions")
  688.  
  689.                     The DEFAULT for this parameter is 0000, which
  690.                     means forever.  Any value from 0000 to 65535
  691.                     is allowed.
  692.  
  693.  
  694. RPL.com parses the Node Address line of BOOTCONF.sys looking for
  695. these keywords.  If an entry if found, but does not match one of
  696. the keywords, it is assumed to be a Disk Image File name. 
  697. Therefore, you should NOT have a Disk Image File named the same as
  698. any of these keywords.  Note that these parameters are OPTIONAL,
  699. NOT Case Sensitive, separated by blanks, and may be entered in any
  700. order.
  701.  
  702. An example of a BOOTCONF.sys line using these parameters is:
  703.  
  704.      0x*1234 = NET$DOS.sys gns protect rep NODE=^^^^^|NODE=67890
  705.  
  706. In this case, gns and protect will be interpreted as KEYWORDS and
  707. not Disk Image File names. In addition, the string 'NODE=^^^^^'
  708. will be REPLACED with 'NODE=67890' wherever it occurs in the Disk
  709. Image File.
  710.  
  711.  
  712.  
  713. Changing BOOTCONF.sys
  714.  
  715. RPL.com reads BOOTCONF.sys into a memory buffer at LOAD time.  If
  716. the user changes BOOTCONF.sys after  RPL.com is loaded, it must be
  717. unloaded by specifying:
  718.  
  719.      RPL u
  720.  
  721. on the DOS command line.  When RPL.com is loaded again, it will
  722. read the new copy of BOOTCONF.sys.
  723.  
  724.  
  725.  
  726. Memory Considerations
  727.  
  728. RPL.com will read ALL Bootstrap programs with a .RPL extension it
  729. finds in the \LOGIN directory and caches them into memory when it
  730. loads.  It is designed to provide multivendor support with any and
  731. all boards that use the IBM RPL Architecture.  Each Bootstrap
  732. program consumes anywhere from 10 to 15 Kilobytes of memory.  To
  733. reduce the amount of RESIDENT memory RPL.com consumes, it is
  734. suggested you load ONLY the Bootstrap programs that will actually
  735. be used into the RPL Server's \LOGIN directory.
  736.  
  737. BOOTCONF.sys is the only other file that is cached during
  738. initialization time.  This file is OPTIONAL, so if it is NOT needed
  739. there is no reason to define it.  It does, however, offer some
  740. powerful configuration options, so when and if you do define it, it
  741. is suggested that it be made as small as possible.
  742.