CICS SEND Command Description and Options
The parts of the CICS SEND command are:
- SEND
- The command.
- d:
- The name of the diskette or hard disk drive where 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 where you want to send the file. If you have only one host, this part is optional. The default is session A.
- fn
- The name the file is to have on your CICS disk. You must specify the file name. You can create a new name or use a name that is already on the disk.
- ft
- The type of file in CICS. For use only with command line syntax, see Using CICS SEND with the Z and I Emulator for Windows Command Line.
- (options
- These options can be specified:
- ASCII
- Performs the following:
- Converts 1-byte workstation codes to EBCDIC codes.
The default is ASCII CRLF. You need these control terms for text or source files that you want to view or edit, such as SCRIPT files. You do not need them for binary files.Note:- CRLF and NOCRLF are mutually exclusive options.
- BINARY and ASCII are mutually exclusive options.
- The assumed defaults, if the optional parameters are omitted, are CRLF ASCII.
- BINARY
- Specifies that the data in the file is binary data. The data
can be encrypted, compiled programs, or other data. It is not translated
by the host file transfer program but copied unaltered into a temporary
storage queue.
This option is valid for SBCS sessions only.
- CLEAR
- Clears the workstation window at the beginning of the file transfer.
- CRLF
- Specifies carriage return and line feed codes in the text file.
- NOCLEAR
- Suppresses the sending of a Clear command at the beginning of file transfer. This option is required for ISPF command mode.
- NOCRLF
- Specifies that the PC file does not consist of logical records
delimited by carriage return and line feed characters. No concatenation
or splitting of records is performed by the CICS file transfer program.
The file is written into a temporary storage using one item on the queue to represent each inbound data buffer. The items on the CICS temporary storage queue can be of different lengths, but none can be more than 32767 characters.
This option is valid for SBCS sessions only.
- 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, 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 is not set. The default is 1. To avoid a premature error message, specify an adequate value. In cases of large packet sizes, 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).