Introduction

This file contains a description of the IBM Token-Ring Network
Remote Program Load Sample Programs diskette along with instructions
on the use of this diskette.  You should be familiar with the
IBM Token-Ring Network Remote Program Load User's Guide before using
the contents of this sample diskette.

The IBM Token-Ring Network Remote Program Load Sample Programs
diskette has been provided as an aid along with the IBM Token-Ring
Network Remote Program Load User's Guide to help programmers develop
their own loaders and bootstrap programs.  You should refer to the IBM
Token-Ring Network Remote Program Load User's Guide for descriptions
of and requirements for these two programs.

The Sample Programs diskette contains the following files:

        - README       : this file.

        - RHBOOT.LST   : the source code listing for a sample bootstrap
                         program.

        - RHBOOT.COM   : the executable code for RHBOOT.LST.

        - GENIMAG.COM  : executable code which uses RHBOOT.COM and
                         a DOS system diskette image to produce a bootable
                         file.

        - SAMPLDR.LST  : the source code listing for a sample loader.

        - SAMPLDR.EXE  : the executable code for SAMPLDR.LST.

        - TIMERINT.SYS : device driver for use with SAMPLDR.

        - RPLBOOT.COM  : the executable code to deactivate the DOS
                         partition on a fixed disk.



RHBOOT

RHBOOT is a sample bootstrap program.  When a DOS diskette image is appended
to it, a bootable file is created.  RHBOOT, when loaded in a requesting
device, does the following:

        - moves the appended DOS system diskette image to high memory
          in the requesting device.  Uses the disk emulator provided
          with the Remote Program Load Module to perform a normal
          DOS boot off the diskette image.

Note that RHBOOT.COM will not execute correctly without an appended
DOS system diskette image.  Refer to the section on GENIMAG.COM for
more details.

RHBOOT is not intended to be a working program.  It is intended to
be used as an educational tool to demonstrate one way of writing
a bootstrap program.




GENIMAG.COM

GENIMAG.COM appends a diskette image to RHBOOT.COM and outputs this
new file with the name BOOTIMAG.COM.

To use GENIMAG.COM you must:

        1. Have a fixed disk or diskette with enough capacity to hold
           BOOTIMAG.COM.

        2. Drive A must handle DOS-formatted diskettes.


To create BOOTIMAG.COM:

        1. The current directory must be the directory to which
           you wish BOOTIMAG.COM to be written.

        2. RHBOOT.COM must be in the current directory.

        3. Insert the DOS system diskette image you wish to have
           appended to RHBOOT.COM in drive A. The maximum size image
           which can be created is 360KB.

        4. Enter  GENIMAG  at the DOS prompt.

GENIMAG.COM will create in the current directory BOOTIMAG.COM, which
consists of RHBOOT.COM with the image of the diskette in drive A appended
to it.  Refer to the section on the sample loader for more details on the
use of BOOTIMAG.COM.




SAMPLE LOADER PROGRAM

SAMPLDR is a sample loader program.  A listing of the source code is
provided in SAMPLDR.LST.  SAMPLDR responds to Remote Program Load frames
sent to it by requesting devices.  When a request for a file is received
(with no file name specified), SAMPLDR responds by sending BOOTIMAG.COM.

To use SAMPLDR.EXE:

        1. If you are using the IBM Personal Computer to run SAMPLDR.EXE
           TIMERINT.SYS must be installed as a device driver.  The command
           DEVICE=TIMERINT.SYS must be in the CONFIG.SYS file when the
           computer is powered on, and TIMERINT.SYS must be in the root
           directory of the drive from which DOS is started.

        2. A copy of BOOTIMAG.COM must be in the current directory.  Note that
           SAMPLDR will send any file named BOOTIMAG.COM.  It does not have
           to be a file created by GENIMAG.  You must ensure however that
           the file is bootable.

        3. The computer on which SAMPLDR is to run must have an IBM Token-Ring
           Network Adapter with its associated Adapter Support Interface
           installed.

        4. To invoke SAMPLDR, simply enter  SAMPLDR  at the DOS prompt.

        5. To exit SAMPLDR and return to DOS,  press  ALT Q.

SAMPLDR takes 30 - 35 seconds to install itself.  Once installed, SAMPLDR
responds to frames from requesting devices.  No user interface has been
provided in this sample program.  It is not intended to be a working
program.  It is intended to be used as an educational tool to demonstrate
how to use the Remote Program Load frames and protocols to write a loader.




FIXED DISK PATCH PROGRAM

RPLBOOT is the fixed disk patch program which patches the fixed disk so
that it does not contain an active DOS partition.  This allows the Remote
Program Load function to get control when the computer is started or reset.
To invoke the program, type RPLBOOT at the DOS prompt.  The next time the
computer is started or reset, the Remote Program Load program will get
control.  The fixed disk can still be accessed by programs.

To make the DOS partition on the fixed disk active again, run the FDISK
program using choice 2.  This will allow DOS to be loaded from the fixed
disk when the computer is restarted.