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