Using the VM/CMS RECEIVE Command
Use the following information when receiving a file from VM/CMS:
Figure 1 shows the command and information you must provide.
Enter it as shown (including parentheses), except that you can use
either uppercase or lowercase letters.
Note:
- ␢
means to insert a space. There must not be a space between h: and fn.
Figure 1. VM/CMS RECEIVE Command Syntax
- A
- The workstation drive and path of the file to be received.
- B
- The name of the workstation file to be received.
- C
- Host session specifications for the file to be received from
the host.
- h:
- The short name of the session (which can be omitted if it is a)
- fn
- File name
- ft
- File type
- fm
- File mode
- D
- Optional changes made to the file during transfer. More than
one option can be selected. Valid options are:
- APPEND
- ASCII
- BLANK
- CLEAR
- CRLF
- NOCLEAR
- PROGRESS
- QUIET
- TIME(n)
The parts of the VM/CMS RECEIVE command are:
- RECEIVE
- The command.
- d:
- The name of the diskette or hard disk drive on which the file is to be received.
- path
- The path indicating the directory to which the file is to be stored.
- filename.ext
- The name of the workstation file, including the extension. Use a new name or one that already exists. If you use a new name, the file that you receive is added to your diskette or hard disk. If you use the name of an existing file, the file that you receive either replaces or supplements the existing file. (Refer to the APPEND option.)
- h:
- The short name of the host session from which you want to get the file. The default is a:.
- fn ft fm
- The name of the file you want to receive from your VM/CMS disk. The file name fn is required.
- (options
- These options can be specified:
- APPEND
- Specifies that the file being received is to be added to the end of an existing file. Omit this part of the VM/CMS file that is received to replace an existing file.
- ASCII
- Performs the following:
- Converts EBCDIC codes to 1-byte workstation codes.
- BLANK
- This option is valid with the CRLF option. Use it to retain BLANK (x'40') at the end of each line.
- CRLF
- Specifies the carriage return and line feed codes. You need ASCII and CRLF for text or source files that you want to view or edit, such as SCRIPT files. You do not need them for binary files, such as programs.
- CLEAR
- Clears the workstation window at the beginning of the file transfer.
- NOCLEAR
- Suppresses the sending of a Clear command at the beginning of the file transfer.
- PROGRESS
- Shows a message indicating that the file transfer is in progress or has ended. Such messages do not show the current transferred bytes.
- QUIET
- Does not show any messages.
- TIME(n)
- Specifies the length of time, in units of 30 seconds, that the program waits for a response from the host before it sends an error message. The value n is an integer value in the range from 0 through 2184. If you specify 0, timeout is not set. The default is 1. To avoid a premature error message, specify an adequate value. In cases of large packet sizes, of large block sizes, or for slow communication lines (such as and COM port), 5 (150 seconds) is recommended. There should be no blank spaces between TIME and (n).