SEND: non-z/OS Communications Server options

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

Options

ALTERNATE

sets the terminal to use the ALTERNATE screen size.

ASIS

indicates that output is to be sent in transparent mode (with no recognition of control characters and accepting any of the 256 possible combinations of eight bits as valid transmittable data).

Note: If you are using a katakana terminal, you might see some messages containing mixed English and katakana characters. That is because katakana terminals cannot display mixed-case output. Uppercase characters in the data stream appear as uppercase English characters, but lowercase characters appear as katakana characters. If this happens, ask your system programmer to specify MSGCASE=UPPER in the system initialization parameters so that messages contain uppercase characters only.

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.

CBUFF

specifies that data is to be written to a common buffer in a 2972 control unit. The WAIT option is implied.

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 has been specified, the RU terminates the chain.

CTLCHAR(data-value)

specifies a 1-byte write control character (WCC) that controls a SEND command for a 3270. These are documented in the 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 has been completed.

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, should always specify ERASE. For transactions attached to 3270 screens or printers, unless explicitly overridden by the DEFAULT or ALTERNATE option, this also ensures that the correct screen size is selected, as defined for the transaction by the SCRNSIZE option in the RDO PROFILE resource definition.

FLENGTH(data-value)

A fullword alternative to LENGTH.

FMH

specifies that a function management header has been included in the data in the FROM area. If the ATTACHID option is specified as well, the concatenated FMH flag is set in the attach FMH.

FROM(data-area)

specifies the data to be written to the logical unit or terminal.

INVITE

specifies that the next terminal control command to be executed for this facility is a RECEIVE. This allows optimal flows to occur.

LAST

specifies that this is the last output operation for a transaction and therefore the end of a bracket.

LEAVEKB

specifies that the keyboard is to remain locked at the completion of the data transfer.

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.

LINEADDR(data-value)

specifies that the writing is to begin on a specific line of a 2260/2265 screen. The data value is a halfword binary value in the range 1 through 12 for a 2260, or 1 through 15 for a 2265.

PASSBK

specifies that communication is with a passbook. The WAIT option is implied.

PSEUDOBIN (start-stop only)

specifies that the data being written is to be translated from System/7 hexadecimal to pseudobinary.

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 transaction program. The cvda values returned by CICS® are:

ALLOCATED
FREE
PENDFREE
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 the IBM 3270 Data Stream Programmers Reference.)

CTLCHAR and ERASE 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 has started. 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 has been completed.