SEND (2260)

Description

SEND writes data to a terminal.

Options

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.

FLENGTH(data-value)

A fullword alternative to LENGTH.

FROM(data-area)

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

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.

LEAVEKB

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

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.

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.

Conditions

16 INVREQ

RESP2 values:

200

occurs if a distributed program link server application attempted to send on its function-shipping session (its principal facility)

Default action: terminate the task abnormally.

22 LENGERR

occurs if an out-of-range value is supplied in the LENGTH or FLENGTH option.

Default action: terminate the task abnormally.