
/*  This is the README.MOD file that is shipped on a Multiple Option Diskette.

/*  A Multiple Option Diskette is a conglomeration of option files that have
/*  been released on individual option diskettes.  Some individual option
/*  diskettes carry more than one adapter ID.  An example of this is the
/*  Image Adapter option.  That option's diskette shipped with four adapter
/*  ID ADF files:  8DF0, 8DF1, 8DF4, and 8DF5.  The option name file on the MOD
/*  that will carry the Image Adapter files will require four unique entries;
/*  one for each adapter ID.

/*  Every Multiple Option Diskette must contain an option name file which
/*  identifies every option that is on the diskette.  There must be one entry
/*  for each adapter ID that is to be supported on the MOD.  Each entry can
/*  have multiple records as defined below.

/*  The option name file is used to identify the Diagnostic (DGS) and POST
/*  Error Processor (PEP) file names for each adapter ID.  It is also used to
/*  flag diagnostic modules that are used by more than one adapter ID;
/*  therefore, to flag files that will not be able to be deleted from
/*  Reference Diskettes/Packages.  The option name file will also carry the
/*  version number of each of the options.

/*  The name of the option name file on the Multiple Option Diskette MUST
/*  be 'OPTNAMES.MOD' and should be marked as a read-only file.

/*  The following should be helpful to anyone who will develop a Multiple
/*  Option Diskette.  This information pertains to how to structure entries
/*  within an option name file.

/*  KEYWORDS AND RECORD TYPES

/*  Each entry in the file will be made up of multiple, variable length
/*  records.  Three types of records are available for an entry.  The records
/*  are identified by a keyword.  The supported keywords and the type of
/*  record they define are:
/*
/*  ID -  adapter ID record - REQUIRED for every adapter ID to be supported.
/*        This record must be the first record for an entry and there is only
/*        one of these records per adapter ID.  This record signifies an
/*        entry and that the following records (prior to the next ID record)
/*        correspond to the adapter ID listed in this record.
/*
/*  VER - version number record - REQUIRED for every adapter ID to be supported.
/*        This record must be placed immediately after the ID record line.  This
/*        field has the version number of this option that is on this diskette.
/*
/*  DGS - DGS module record(s) - must be present to support DGS modules.
/*        If an adapter ID does not have any DGS modules associated with it,
/*        a DGS record is not necessary.  There may be more than one of these
/*        records for a given adapter ID.  If so, they should be entered
/*        consecutively in the file.  These records should be placed
/*        immediately after the VER record.
/*
/*  PEP - PEP module record(s) - must be present to support PEP modules.
/*        If an adapter ID does not have any PEP modules associated with it,
/*        a PEP record is not necessary.  There may be more than one of these
/*        records for a given adapter ID.  If so, they should be entered
/*        consecutively in the file.  These records should be placed
/*        immediately after the DGS record(s).



/*  ID RECORD DEFINITION

/*  This record contains the following fields:
/*
/*  ID keyword - The record must start with the characters 'ID' to identify
/*               that this is the ID record for an adapter ID.
/*
/*  4 blank spaces
/*
/*  MOD # - 2 digit MOD number, which must match the number on the diskette
/*          label.  (0-9 are valid digits for the MOD number)
/*
/*  2 blank spaces
/*
/*  Adapter ID - 4 digit hexidecimal adapter ID (0-9 and A-F are valid
/*               digits for the adapter ID)
/*
/*  3 blank spaces
/*
/*  Adapter Name - 44 character (maximum) adapter name.
/*                 Any ASCII characters are valid.  If more than 44 characters
/*                 are in the name, the name will be truncated.


/*  VER RECORD DEFINITION

/*  This record contains the following fields:
/*
/*  VER keyword - The record must start with the characters 'VER' to identify
/*                that this is a VER record for an adapter ID.
/*
/*  3 blank spaces
/*
/*  List the version number of the option as follows:  vX.XX.  Valid entries
/*  for the version numbers are the digits 0 - 9.

/*  DGS RECORD DEFINITION

/*  This record contains the following fields:
/*
/*  DGS keyword - The record must start with the characters 'DGS' to identify
/*                that this is a DGS record for an adapter ID.
/*
/*  List of DGS module names with a share indicator for each module.  Each
/*  DGS name is an 8 character file name (must be a valid DOS file name)
/*  with the extension assumed to be 'DGS'.  The share indicator will be a
/*  one character field which contains 's' or 'S' to indicate this module
/*  is shared by more than one ID and should not be deleted from any
/*  Reference Package.  The share indicator will precede the file name.
/*  The format for this list is repetitions of the following:
/*
/*     1 blank
/*
/*     1 character share indicator ('s' or 'S' for shared) - if this field
/*       contains anything but 's' or 'S', it will be assumed to be a
/*       non-share indicator.
/*
/*     1 blank
/*
/*     8 character DGS file name - extension assumed to be 'DGS' - If the
/*       name is less than 8 characters, pad with blanks.
/*

/*  PEP RECORD DEFINITION

/*  This record contains the following fields:
/*
/*  PEP keyword - The record must start with the characters 'PEP' to identify
/*                that this is the PEP record for an adapter ID.
/*
/*  List of PEP module names - Each PEP name is an 8 character file name
/*  (must be a valid DOS file name) with the extension assumed to be 'PEP'.
/*  A share indicator is not used for PEP files.  However, to enhance
/*  readability of the option name file, blanks are used in order to line up
/*  DGS and PEP file names within the entries.  The format for this list is
/*  repetitions of the following:
/*
/*     3 blanks
/*
/*     8 character PEP file name - extension assumed to be PEP - this field
/*     must use all 8 character positions.  If the name is not 8 characters
/*     long, pad with blanks.


/*  According to the above, the file entries should look
/*  similar to the following with actual text put in.
/*
/*  ID    xx  xxxx   nnnnnnnnn<--44 character adapter name-->nnnn
/*  VER   vX.XX
/*  DGS x xxxxxxxx x xxxxxxxx x xxxxxxxx x xxxxxxxx x xxxxxxxx x xxxxxxxx
/*  PEP   xxxxxxxx   xxxxxxxx   xxxxxxxx   xxxxxxxx   xxxxxxxx   xxxxxxxx


/*  COMMENT LINES AND BLANK LINES

/*  It is anticipated that this file will be created using a text editor.
/*  In addition to what is described above as records, the option name file
/*  can contain comment lines and blank lines.
/*
/*  Comment lines are lines that begin with the characters '/*' and end with
/*  the carriage return/line feed characters.
/*
/*  Blank lines can also be inserted to make the file more readable.
/*
/*  Comment lines and blank lines should be used sparingly so as not to
/*  increase the file size dramatically.


