DISK

Authorization

General User

Purpose

Operands

DUMP fn ft fm

punches the specified file (fn ft fm). The file may have either fixed- or variable-length records. After all data is punched, an end of file card is created with an N in column 5. This card contains directory information and must remain in the deck. The original file is retained.

LOAD = = fm

loads a file or files from the spooled card reader and writes them as CMS files on the specified disk or accessed SFS directory. The file name and file type are obtained from the card stream. If the file mode is specified as an asterisk '*' or equal sign '=', the file mode is obtained from the card stream. These may be changed through the use of the prompting facility. If a file exists with the same file name and file type as one of those in the card stream, it is replaced if the REPLACE option is in effect.

The card-image sequence numbers on all files being loaded are checked. A message notifies the user of any record numbers missing or out of order. The file is loaded even if there is a problem found in the sequence number check.

The DISK LOAD function checks for characters that are not valid in the file ID field of the reader file to be loaded. If a character that is not valid is found, the message DMS496S is printed at the console informing the user a not valid file ID has been found in the input record. The file is left in the reader. A file is not loaded when the last card of the reader file does not match the file name, file type, and file mode of the first card in the reader file.

Options

DISK LOAD Options

Fullprompt

specifies a prompt is issued for each file in the spool file.

Minprompt

specifies a prompt is issued when the name of the first (or only) file differs from the name of the spool file; the prompt for the first file is suppressed when it has the same name as the spool file. A prompt is always issued for the second and subsequent files. The default is MINPROMPT.

NOPrompt

specifies a prompt is not issued to you as a file is received.

Replace

specifies that if a file of the same file name and file type exists on the disk or directory onto which the incoming file is to be loaded, it is to be replaced with this one.

NOReplace

specifies a file is not received that would overlay an existing file on the receiving disk or directory. The default is NOREPLACE.

OLDDate

when specified, OLDDATE retains the date and time of the most recent update of the file before it is sent to your virtual reader. This date becomes the creation date for the file being loaded. Otherwise, the date and time of execution of the DISK LOAD command will be used as the creation date for the output file produced by the DISK LOAD.

TYPe

specifies responses will be displayed to the terminal. For more information, see Response 1.

NOType

specifies responses (excepting prompting messages) will not be displayed to the terminal.

FIFO

STACK

STACK FIFO

specifies responses will be placed in the stack in the order in which they would have been displayed. For more information, see Response 1.

Note: STACK, STACK FIFO and FIFO are synonymous.

LIFO

STACK LIFO

specifies responses will be placed in the stack in the inverse order in which they would have been displayed. For more information, see Response 1.

Note: LIFO and STACK LIFO are synonymous.

MSGSubs

returns only the available substitution information for the current spool file. Substitution data in a message is the variable information contained in the message. For more information on substitution data, see Usage Notes.

The lines are displayed or stacked in accordance with the FIFO, LIFO, NOTYPE, STACK or TYPE options.

MSGAll

returns the normal message and all available substitution information for the current spool file. The lines are displayed or stacked in accordance with the FIFO, LIFO, NOTYPE, STACK or TYPE options.

Usage Notes

1. To read files with the DISK LOAD command, they must have been created by the DISK DUMP command. To identify the proper method to use in loading spooled reader files, use the RDR command. For more information, see RDR and RECEIVE.
2. To load reader files created by DISK DUMP, you must issue the DISK LOAD command for each spool file. For example, if you enter:

   disk dump source1 assemble
   disk dump source2 assemble

   the virtual machine that receives the files must issue the DISK LOAD command twice to read the files onto the disk or directory. If you use the CP SPOOL command to spool continuous, for example:

   cp spool punch cont
   disk dump source1 assemble
   disk dump source2 assemble
   cp spool punch nocont close

   you only need to issue the DISK LOAD command once to read both files.
   You may send multiple files by continuous spooling (using CP SPOOL PUNCH CONT) or by a series of DISK DUMP commands but those methods are discouraged. As a sender you are encouraged to:

   • Always use SENDFILE, which resets any continuous spooling options in effect.
   • Not spool the punch continuous.
3. You can read multiple files into separate files on disk or directory by spooling your reader continuous (CP SPOOL command with the CONT option) and issuing DISK LOAD with the NOPROMPT option.
4. You can use the DEFAULTS command to set up options and override command defaults for DISK. However, the options you specify in the command line when entering the DISK command override those specified in the DEFAULTS command. This allows you to customize the defaults of the DISK command, yet override them when you desire. For more information, see DEFAULTS.
5. DISK LOAD loads a file from the reader into a temporary work file called DISK CMSUT1. The existing file with the same name as the one being loaded from the reader is then erased. The name of the temporary work file just created is changed to the name of the work file just read in. If the file you are loading has the name DISK CMSUT1, it is changed to DISK CMSUT2. DISK CMSUT1 is a reserved work file name for the DISK command.
6. If you specify the FULLPROMPT or MINPROMPT option the valid responses include, one of the:
   • Digits specified in the prompt
   • Parenthetical words that follow a digit or any initial truncation of the word
   The meanings of these responses are:

   Response

   Description

   0 or No

   If this file is one of a set of files that constitutes a single spool file, the file is not received and prompting continues for the next file, if there is one. If this is the last file of a set of files or if this is the only file in the spool file, the command is ended.

   1 or Yes

   Receives the file under the name fn1 ft1 fm1 (or fn3 ft3 fm3).

   2 or Quit

   Ends the command.

   3 or Rename

   Requests prompt message DMS1080R so the incoming file can be received using a different name.

7. If you receive prompt message DMS1081R the valid responses include:
   • One of the digits specified in the prompt
   • One of the parenthetical words that follows a digit or any initial truncation of the word
   The meanings of these responses are:

   Response

   Description

   0 or No

   Does not receive the file under the name fn ft fm and repeats the original prompt message DMS1080R. This allows you to specify a different name for the incoming file.

   1 or Yes

   Receives the file under the name fn ft fm.

   2 or Quit

   Ends the command.

8. If you encounter any errors when you load a reader spool file, the file remains in the reader and is not purged by the DISK command. This occurs regardless of whether you have spooled the reader HOLD or NOHOLD. This protects you from losing reader spool files when an error is encountered. If the file is empty or unwanted, you can purge the file from your reader.
9. If you specify the MSGSUBS or MSGALL option, the DISK LOAD command uses the following response format when returning the substitution data. This response has a fixed format and fixed length. The length is 69 characters.
   Note: Each individual field in the substitution line is initialized to an ‘*’ followed by enough blanks to fill the field.
   The format is (each field is delimited by one blank):

   msgid fileid sentname oldfileid

   Where:

   msgid

   identifies the six character message identifier (four character message number and two character message format).

   fileid

   consists of three fields, each delimited by one blank:

   • file name (fn), length of eight
   • file type (ft), length of eight
   • file mode (fm), length of two

   This is the name of the file that was received.

   sentname

   consists of three fields, each delimited by one blank:

   • file name (fn), length of eight
   • file type (ft), length of eight
   • file mode (fm), length of two

   This is the name of the file as specified by the sender. This field will only be supplied if it differs from fileid.

   oldfileid

   consists of three fields, each delimited by one blank:

   • file name (fn), length of eight
   • file type (ft), length of eight
   • file mode (fm), length of two

   This is the name of the file replaced by fileid. This field will only be supplied if it differs from fileid. The only difference between the values of fileid and oldfileid will be the values of the fm fields.

   Note: The MSGALL and MSGSUBS options only apply to those responses controlled by the FIFO, LIFO, NOTYPE, STACK and TYPE options.
10. If you try to load an empty file into a minidisk, you will get this message:

    File fileid is empty; minidisk
    does not support empty files

    The file is not purged from your reader. You can DISCARD or PURGE the file from your reader, or try to receive it into an SFS directory that supports empty files. (It needs to be in a file pool managed by a server at CMS level 8 or later.) If the directory supports empty files, the record length, record format and file ID will be transferred to the new file. If the file pool does not support empty files, you will get this message:

    File fileid is empty; filepool filepoolid
    does not support empty files

Responses

1. When DISK LOAD has completed loading each incoming file, you receive one of the following responses, depending on the situation.
   • If the incoming file (fn1 ft1 fm1) does not already exist and it is received without being renamed, you receive:

     fn1 ft1 fm1 created

   • If the incoming file (fn1 ft1 fm1) is renamed to a file name (fn2 ft2 fm2) that does not already exist, you receive:

     fn2 ft2 fm2 created from fn1 ft1 fm1

   • If the incoming file (fn1 ft1 fm1) is copied to an existing data set that has the same name as the incoming file, you receive:

     fn1 ft1 fm1 replaced

   • If the incoming file (fn1 ft1 fm1) is copied to an existing file (fn2 ft2 fm2) with a name different from that of the incoming file, you receive:

     fn2 ft2 fm2 replaced by fn1 ft1 fm1

   • If the incoming file (fn1 ft1 fm1) replaces an existing file (fn2 ft2 fm2), but is given a mode (fm1) that differs from the mode of the existing file (fm2), you receive:

     fn1 ft1 fm1 replaced fn2 ft2 fm2

   • If the incoming file (fn1 ft1 fm1) replaces an existing file (fn2 ft2 fm2), but is given a mode (fm3) that differs from the mode of the existing file (fm2), you receive:

     fn3 ft3 fm3 replaced fn2 ft2 fm2 sent as fn1 ft1 fm1

2. If you specify the FULLPROMPT or MINPROMPT option, one of these prompts is displayed:

   DMS1079R  Receive fn1 ft1 fm1?
    
   Reply 0 (NO), 1 (YES), 2 (QUIT), or 3 (RENAME)
    
   Receive fn1 ft1 fm1 and replace the
   existing file of the same name?
   Reply 0 (NO), 1 (YES), 2 (QUIT), or 3 (RENAME)
    
   Receive fn1 ft1 fm1 and replace
   fn2 ft2 fm2?
   Reply 0 (NO), 1 (YES), 2 (QUIT), or 3 (RENAME)
    
   Receive fn1 ft1 fm1 as fn3 ft3 fm3?
   Reply 0 (NO), 1 (YES), 2 (QUIT), or 3 (RENAME)
    
   Receive fn1 ft1 fm1 as fn3 ft3 fm3 and
   replace the existing file of the same name?
   Reply 0 (NO), 1 (YES), 2 (QUIT), or 3 (RENAME)
    
   Receive fn1 ft1 fm1 as fn3 ft3 fm3 and
   replace fn2 ft2 fm2?
   Reply 0 (NO), 1 (YES), 2 (QUIT), or 3 (RENAME)

   • The file ID fn1 ft1 fm1 is the name from the card stream in the spool file.
   • The phrase and replace the existing file of the same name? appears when the operation replaces an existing file and the file mode of that file is the same as fm1.
   • The phrase and replace fn2 ft2 fm2. appears when the operation replaces an existing file and the file mode of that file is not fm1.
   • The file ID fn3 ft3 fm3 is the name from the card stream in the spool file you may specify when the name differs from the name of the incoming file.
   • If you respond with a 3 (or RENAME) to prompt message DMS1079R, the following message appears and you must enter a file ID in the form
     

     DMS1080R  Enter the new name for fn ft fm

   • If you respond to prompt message DMS1080R with a file ID that names an existing file, you receive this prompt:

     DMS1081R  Replace fn ft fm?
     Reply 0 (NO), 1 (YES), or 2 (QUIT)

Messages and Return Codes

• DMS002E File fn [ft [fm]] not found
• DMS014E Invalid function function
• DMS024E File fn [ft fm] already exists; specify REPLACE option] [RC=28]
• DMS037E Filemode mode[(vdev)] is accessed as read/only
• DMS047E No function specified
• DMS054E Incomplete fileid specified
• DMS062E Invalid * in fileid
• DMS069E Filemode mode[(vdev)] not accessed
• DMS069E Output filemode mode[(vdev)] not accessed
• DMS070E Invalid parameter parameter
• DMS077E End card missing from input deck
• DMS078E Invalid card in input deck
• DMS078W Sequence error detected loading fn ft--expected seqno1 found seqno2
• DMS104S Error nn reading file fn ft fm from disk or directory
• DMS105S Error nn writing file fn ft fm on disk or directory
• DMS109S Virtual storage capacity exceeded [RC=104]
• DMS118S Error punching file
• DMS124S Error reading card file
• DMS205W Reader empty, reader not ready or empty reader file
• DMS257T Internal system error at address address (offset offset)
• DMS445W Invalid data in sequence field, bypassing sequence check
• DMS496S Invalid fileid fn ft fm found in input record [RC=100]
• DMS550W Date/Time data not present for file fn ft
• DMS639E Error in routine routine; return code was nnnn
• DMS671E Error loading file fn ft fm; rc=nn from RENAME
• DMS701W File fileid is empty; {minidisk|filepool filepoolid} does not support empty files [RC=74|88]
• DMS1123E Unknown response text ignored
• DMS1124W Spool file spoolid has been left in your reader because one or more files were not received [RC=1]
• DMS1138E Filesharing conflict [involving file fn ft fm] [RC=70]
• DMS1262S Error nnn opening file fn ft fm [RC=31│55│70│99│100]
• DMS1262S Error nnn closing file fn ft fm [RC=31│100]
• DMS1285S Default option text is invalid [RC=24]

Additional system messages may be issued by this command. The reasons for these messages and their location are: