Using the VM/CMS RECEIVE Command

Use the following information when receiving a file from VM/CMS:

VM/CMS RECEIVE Command Syntax 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:
  1. ␢blank space character means to insert a space. There must not be a space between h: and fn.
Figure 1. VM/CMS RECEIVE Command Syntax

REQTEXT
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).