SEND: z/OS Communications Server options

Common options used on the SEND command (z/OS® Communications Server).

Options

ALTERNATE

Sets the terminal to use the ALTERNATE screen size.

ATTACHID(name)

Specifies that an attach header (created by a BUILD ATTACH command) is to precede, and be concatenated with, the user data supplied in the FROM option. “name” (1–8 characters) identifies the attach header control block to be used in the local task.

CNOTCOMPL

Indicates that the request/response unit (RU) sent as a result of this SEND command does not complete the chain. If this option is omitted and chain assembly is specified, the RU terminates the chain.

CONFIRM

Indicates that an application using a synchronization level 1 or 2 conversation requires a response from the remote application. A remote CICS® application can respond positively by running an ISSUE CONFIRMATION command, or negatively, by running an ISSUE ERROR command, in which case the sending application has EIBERR and EIBERRCD set. CICS does not return control to the sending application until the response is received.

CONVID(name)

Identifies the conversation to which the command relates. The 4-character name identifies either the token returned by a previous ALLOCATE command in EIBRSRCE in the EIB, or the token representing the principal session (returned by a previous ASSIGN command).

For compatibility with earlier releases, SESSION is accepted as a synonym for CONVID. New programs must use CONVID.

If this option is omitted, the principal facility is assumed.

CTLCHAR(data-value)

Specifies a 1-byte write control character (WCC) that controls a SEND command for a 3270. These characters are described in IBM 3270 Data Stream Programmers Reference. A COBOL user must specify a data area containing this character. If the option is omitted, all modified data tags are reset to zero and the keyboard is restored.

DEFAULT

Sets the terminal to use the DEFAULT screen size.

DEFRESP

Indicates that a definite response is required when the output operation completes.

ERASE

Specifies that the screen printer buffer or partition is to be erased and the cursor returned to the upper left corner of the screen. This option applies only to the 3270, or 8775, and to the 3604 Keyboard Display.

The first output operation in any transaction, or in a series of pseudoconversational transactions, must always specify the ERASE option. For transactions attached to 3270 screens or printers, unless explicitly overridden by the DEFAULT or ALTERNATE option, this options also ensures that the correct screen size is selected, as defined for the transaction by the SCRNSIZE option in the PROFILE resource definition.

FLENGTH(data-value)

An alternative to the LENGTH option. For architectural reasons, this option is limited to a maximum of 32 KB for all terminal-related SEND commands.

FMH

Specifies that a function management header is included in the data to be written. If the ATTACHID option is specified as well, the concatenated FMH flag is set in the attach FMH.

The use of FMH is optional and is not supported for all terminal types. If not supplied, CICS takes no action, except for 3600/4700 terminals, where an FMH is mandatory. In this case, if FMH is not specified, CICS supplies one and places it in the first 3 bytes of the message, which you must reserve for this purpose.

FROM(data-area)

Specifies the data to be written to the logical unit, or a partner transaction.

INVITE

For the SEND (APPC) command, an application can use the INVITE option to add a change-direction indicator to data already sent to a process in a connected APPC system. Control data is not transmitted by CICS until the subsequent WAIT or a SYNCPOINT command, unless CONFIRM or WAIT is also coded on the GDS SEND INVITE command.

For the other SEND commands, INVITE specifies that the next terminal control command to be run for this facility is a RECEIVE. This allows optimal flows to occur.

LAST

Specifies that this is the last SEND command for a transaction.

LDC(name)

Specifies the 2-character mnemonic used to determine the appropriate logical device code (LDC) numeric value. The mnemonic represents an LDC entry in the terminal control table TYPE=LDC.

LENGTH(data-value)

Specifies the length, as a halfword binary value, of the data to be written. For a description of a safe upper limit, see LENGTH options in CICS commands.

SESSION(name)

Specifies the symbolic identifier (1–4 characters) of a session TCTTE. This option specifies the alternate facility to be used. If this option is omitted, the principal facility for the task is used.

STATE(cvda)

Gets the state of the current conversation. The CVDA values returned by CICS are:

ALLOCATED
CONFFREE
CONFRECEIVE
CONFSEND
FREE
PENDFREE
PENDRECEIVE
RECEIVE
ROLLBACK
SEND
SYNCFREE
SYNCRECEIVE
SYNCSEND

STRFIELD

Specifies that the data area specified in the FROM option contains structured fields. If this option is specified, the contents of all structured fields must be handled by the application program. The CONVERSE command, rather than a SEND command, must be used if the data area contains a read partition structured field. Structured fields are described in IBM 3270 Data Stream Device Guide.)

The CTLCHAR and ERASE options are mutually exclusive with STRFIELD, and their use with STRFIELD generates an error message.

WAIT

Specifies that processing of the command must be completed before any subsequent processing is attempted.

If the WAIT option is not specified, control is returned to the application program when processing of the command starts. A subsequent input or output request (terminal control, BMS, or batch data interchange) to the terminal associated with the task causes the application program to wait until the previous request completes.

Conditions

Some of the following conditions might occur in combination. If more than one occurs, only the first is passed to the application program. EIBRCODE, however, is set to indicate all the conditions that occurred.

62 CBIDERR

Occurs if the requested attach header control block named in ATTACHID cannot be found.