HP 3000 Manuals

STORE [ KSAM/3000 Reference Manual ] MPE/iX 5.0 Documentation


KSAM/3000 Reference Manual

STORE 

Stores KSAM file on magnetic tape or serial disc.

     :STORE filereference1,filereference2 [,...] ; storefile 

         [;SHOW] [;FILES=maxfiles]

This command is used to store one or more disc files onto magnetic tape
or serial disc.  When used to store KSAM files, both the data file and 
the key file must be specified. 

PARAMETERS 

filereference1   Actual file designator of data file; specified in the
                 following format:

                       filename [/lockword] [.groupname [.accountname] ]

                 where each subparameter is a name consisting of from 1
                 to 8 alphanumeric characters beginning with a letter.

                 (Required parameter for KSAM files.)

filereference2   Actual file designator of key file; specified in exactly
                 the same format as filereference1.

                 (Required parameter for KSAM files.)

storefile        Name of destination device file onto which the stored
                 files are written.  This can be any magnetic tape or
                 serial disc file from the output set.  This file must be
                 referenced in the back-reference (*) format; this format
                 references a previous :FILE command that identifies the
                 file as a magnetic tape or serial disc file.

                 (Required parameter.)

SHOW             Request to list names of file stored.  If SHOW is
                 omitted, total number of files stored, names of files
                 not stored, and number of files not stored are listed.

                 (Optional parameter.)

FILES= maxfiles  Maximum number of files that may be stored.  If omitted,
                 4000 is specified by default.

                 (Optional parameter.)

USING THE :STORE COMMAND 

Before issuing a :STORE command, you must identify the storefile as a
magnetic tape or as a serial disc with the :FILE command using the
following format:

     :FILE formaldesignator [=filereference] ;DEV=device 

The device parameter must indicate the device class name or logical unit
number of a magnetic tape or serial disc unit, All other parameters for
storefile are supplied by the :STORE command executor; if you attempt to
supply any of these yourself, MPE rejects the :STORE command.

If you press the BREAK key during the store operation, the operation
stops after storing the current file and further output is suppressed.

For example, to copy KSAM file KSAMDATA to a magnetic tape file named
SAVE FILE

     :FILE T=SAVEFILE;DEV=TAPE
     :STORE KSAMDATA,KSAMKEY;*T 
             ^         ^
             |         |
             |         |
         data file    key file 

Note that both the data and key file must be specified in order to store
the entire KSAM file.

If you want to copy this same file to a serial disc, use the following
command sequence:

     :FILE SD=SAVEFILE;DEV=SDISC
     :STORE KSAMDATA, KSAMKEY;*SD



MPE/iX 5.0 Documentation