CICS RECEIVE Description and Options

The parts of the CICS RECEIVE command are:

RECEIVE: The command.
d:: The name of the diskette or hard disk drive where the file is to be received.
path: The path to the subdirectory where the file is to be located.
filename.ext: The name of the workstation file, including the extension. You can create a new name or use a name that is already on your workstation diskette or hard disk. 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 CICS session where the data set is located. If you have only one host, this part is optional. The default session is A.
fn: The name of the file you want to receive from your CICS host.
ft: The type of file in CICS. For use only with command line syntax, see Using CICS RECEIVE with the Personal Communications Command Line.

(options or [(options (for DBCS)

These options can be specified:

ASCII

Performs the following:

Converts EBCDIC codes to 1-byte workstation codes.
Converts IBM host DBCS codes to 2-byte codes.
Inserts SO and SI characters in a DBCS field and converts the control characters ← and →, if they are present, to SO and SI characters.

The default is ASCII CRLF. You need ASCII and CRLF 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

The data in the file is binary data. The data can be encrypted data, compiled programs, or other data. It is not translated by the host file transfer program but is copied without changes into the workstation file.

This option is valid for SBCS sessions only.

BLANK

This option is valid only when used with the CRLF option; it retains BLANK (hex 40) at the end of each line.

CLEAR

Clears the workstation window at the beginning of the file transfer.

CRLF

Specifies the use of the carriage return and line feed codes.

JISCII

This option is valid for Japanese DBCS sessions only and performs the following:

Converts EBCDIC codes to 1-byte workstation codes.
Converts IBM kanji codes to 2-byte codes.
Inserts SO and SI characters in a DBCS field and converts the control characters ← and →, if they are present, to SO and SI characters.

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 host computer file does not consist of logical records. The items in the temporary storage queue are sent in order and concatenated in your workstation into a single string of data.

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.

SO

This option is valid only for DBCS when used with the JISCII or ASCII option; it converts SO (hex 0E) and SI (hex 0F) to RS (hex 1E) and US (hex 1F).

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, of large block sizes, or for slow communication lines (such as SDLC and COM port), 5 (150 seconds) is recommended. There should be no blank spaces between TIME and (n).

USER

This option is valid only for DBCS when used with the options JISCII, ASCII, and SO. SO (hex 0E) and SI (hex 0F) are not converted to RS (hex 1E) and US (hex 1F); they are written to a file without being converted.