Using the VM/CMS SEND Command

Use the following information when sending a file to VM/CMS:

VM/CMS SEND Command Syntax shows the command and information that you must provide. Enter it as shown (including parentheses). 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 SEND Command Syntax
REQTEXT
A
The workstation drive and path of the file to send.
B
The name of the workstation file to send.
C
Host session specifications for the file to be sent to 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
  • CLEAR
  • CRLF
  • LRECL n
  • NOCLEAR
  • PROGRESS
  • QUIET
  • RECFM x
  • TIME(n)
The parts of the VM/CMS SEND command are:
SEND
The command.
d:
The name of the diskette or hard disk drive on which the file is located.
path
The path to the subdirectory that the file is in.
filename.ext
The name of the file to be sent, including the extension.
h:
The short name of the host session to which you want to send the file. The default is a:.
fn ft fm
The name the file is to have on your VM/CMS disk. You must specify the file name (fn) and file type (ft). You can omit file mode (fm) if you want the file placed on your A-disk. You can create a new name or use a name that is already on your disk. If you use a new name, the file that you send is added to your disk. If you use the name of an existing file, the file that you send either replaces or is added to the old file. (Refer to the description of the APPEND option.)
(options
       These options can be specified:
APPEND
Specifies that the file being sent is to be added to the end of an existing VM/CMS file. Omit this option if you want the file to replace an existing file. You cannot specify the LRECL n or RECFM x option if you use the APPEND option.
ASCII
Performs the following:
  • Converts 1-byte workstation codes to EBCDIC codes.
CLEAR
Clears the workstation window at the beginning of the file transfer. CLEAR is the default.
CRLF
Specifies preserving of the carriage return and line feed codes. You need the ASCII and CRLF options 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.
LRECL n
Specifies the file’s record length. Include a record length only if you want the file to have a record length on your VM/CMS disk other than 80. Replace n with the record length you want. If you omit this option, the record length is set to 80 for fixed-length records or to a maximum of 80 for variable-length records.
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.
RECFM x
Specifies the file record format. Use this parameter to specify variable-length or fixed-length records in the file. Replace x with V for variable or F for fixed. By default, the file has fixed-length records unless you specify the CRLF option; then the file has variable-length records unless you specify otherwise.
TIME(n)
Specifies the length of time n, in units of 30 seconds, that the program waits for a response from the host before it sends an error message. Replace n with an integer value in the range from 0 through 2184. If you specify 0, timeout will not be 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 is between TIME and (n).