                                MAPINIT
                                =======


             MAPINIT is the multi-account private pack set equivalent of
       INITVOL and, like INITVOL, is used to initialize the primary volume
       of a private pack set.  Secondary volumes are initialized by CP-V
       when first opened as new volumes of the set.  A primary volume
       differs from a secondary only in that the first entry in its VTOC
       serial number (SN) table is its own SN. A secondary volume contains
       only the SN of the primary volume in its SN table.

             MAPINIT requires C0 privilege to run since it executes the
       M:SYS CAL.  It can be run as an on-line, batch, or ghost job with
       very slight differences in use.


                           VTOC specification
                           ------------------

             MAPINIT expects at least three valid responses to fully
       initialize a primary volume.  In the order requested they are:

             ENTER DEVICE ADDRESS -

       1) the device address of the available (private) disk drive on
       which the pack to be initialized is mounted in 'ndd' format,

             ENTER NUMBER OF GRANULES PER CYLINDER IF DEFAULT NOT DESIRED -

       2) the logical number of granules per cylinder if the HGP given
       default for the device is not desired, and

             ENTER SERIAL NUMBER -

       3) the SN of the volume--no more than four alphanumeric
       characters.

             MAPINIT does not try to determine if it is "initializing"
       an already initialized volume.  Be careful!

       in cylinder increments.  A judicious selection of the number of
       granules per cylinder will minimize waste while promoting reasonable
       intra-file allocation speed. Another important consideration is the
       size of the resultant VTOC's bit map: each cylinder will require one
       bit.  Thus a small number of granules per cylinder will result in a
       large VTOC bit map--possibly one that is too large to be represented
       by the HGP of the private spindle. MAPINIT will allow the entire VTOC
       granule to be used with the exception of the last two words which
       are reserved for a one entry SN table.  The user is notified of the
       minimum allowable value for the number of granules per cylinder.



                           Account directory
                           -----------------

             ENTER ACCOUNTS--96 MAXIMUM--NULL INPUT ENDS LIST
               96 -

             Account number input is optional.  If no account numbers
       are input, a one entry private volume account directory (PVAD)
       is created with one empty file directory (FD).  This entry is zeroed
       to indicate no owner and will be updated to reflect the account number
       of the first user to open the volume. A maximum of 96 account numbers,
       each prompted by the number of PVAD entries remaining, may be input;
       a PVAD entry and FD are created for each.  Account numbers may not
       contain any of the characters in parentheses (|,;<>./=?) or any
       character less than a blank ( ).

             PVADs can not be extended after initialization.  To be
       extended a private pack set would have to be FSAVEd,
       FRES to restore files to a pack set in an account that is not
       in the PVAD will cause FRES to abort.


                           Minor features
                           --------------

             Minor features of MAPINIT allow the display of the
       current account number list in ascending EBCDIC order by use
       of the 'D .' command and the deletion of any account number
       from the current list by use of the 'D <account>' command.
       Both of these commands are accepted while account numbers are
       being input and can be used in any mode of operation.


       Example of 'D .' and 'D <account>' commands:

                     .
                     .
                     .
                  88 - D .
                :E00BO    :SYS      :SYSGEN   FORTBO    US012001
                  88 - D FORTBO
                  87 - D .
                :E00BO    :SYS      :SYSGEN   US012001
                     .
                     .
                     .


                           On-line use
                           -----------

             Responses to prompts for specific data may be entered one
       per line or, if desired, responses to anticipated prompts may be
       entered on a single line separated by commas.

       As an example, the pack mounted on private spindle BF1 may be
       initialized with serial number PRIV to contain the accounts
       :SYS and :SYSGEN with the following response to the device
       address prompt:

             ***  MAPINIT A00 AT 14:46 ON THURSDAY, JUN 16,'77  ***


       which would be interpreted as the single line responses:

                      BF1<cr>           - selects device address
                      <cr>              - use default # gran/cyl
                      PRIV<cr>          - volume SN
                      :SYS<cr>          - first account
                      :SYSGEN<cr>       - second account
                      <cr>              - end of account list
                      Y<cr>             - account list verified

       Of course the order of information requests must be known in
       advance and will always be in the order described above.

             Any errors (e.g. illegal character, illegal device)
       detected while processing such an input string will result in
       an echoing of that portion of the input string processed in
       addition to the error message.  The remainder of the input
       string would be ignored.  Prompts and their associated
       responses (taken from the input string) are printed as if
       the user had input the response after the prompt except for
       account number input.


                            Batch use
                            ---------

             Input format is identical to on-line input except that
       the account number list need not be verified.  Batch input may
       begin on the processor call card but can begin on the following
       card. Batch input ends when 1) there is no more to read (end of
       file) on M:C and accounts were being entered or 2) a blank card or
       null response (like ,,) is read and accounts were being entered.

       BF3 to have 20 logical granules per cylinder, the serial
       number PSN0, and the account numbers ACNT1 through ACNT9 is:

                      !JOB
                      !LIMIT (TIME,1)    - no SP limit is needed
                      !MAPINIT BF3,20,PSN0
                      ACNT1,ACNT2,ACNT3,
                      ACNT4,ACNT5
             with last card
                      ACNT6,ACNT7,ACNT8,ACNT9
             if no other JCL followed or
                      ACNT6,ACNT7,ACNT8,ACNT9,,
             where ,, indicates the end of account number input.

             All errors except account directory full cause an abort
       return CAL (M:XXX) to be issued following error message output.
       The account directory full condition results in an error message
       being output and a volume initialized with a PVAD containing
       only those account numbers accepted.

             All batch input is echoed.  Portions of input strings used
       to satisfy particular requests are also listed following their
       prompts.


                           Ghost use
                           ---------

             Ghost interaction is identical to on-line interaction
       except that time and paper consuming output is eliminated.








