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

STORE

Technical documentation

» Table of Contents

PARAMETERS

USING THE :STORE COMMAND