SEND (2260)

Write data to a 2260 or 2265 display station.

Read syntax diagramSkip visual syntax diagram
SEND (2260)

>>-SEND--FROM(data-area)--+-LENGTH(data-value)--+--------------->
                          '-FLENGTH(data-value)-'   

>--+---------------------+--+------------+---------------------->
   '-CTLCHAR(data-value)-'  '-DEST(name)-'   

>--+----------------------+--+------+--+---------+-------------><
   '-LINEADDR(data-value)-'  '-WAIT-'  '-LEAVEKB-'   

Conditions: INVREQ, LENGERR

 

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 Programmer's 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.
DEST(name)
specifies the 4-byte symbolic name of the TCAM destination to which the message is to be sent. This option is meaningful only for terminals defined using DFHTCT TYPE=SDSCI with DEVICE=TCAM.
Note: Start of changeIn CICS® TS 3.1, local TCAM terminals are not supported. The only TCAM terminals supported are remote terminals connected to a pre-CICS TS 3.1 terminal-owning region by the DCB (not ACB) interface of TCAM. End of change

If you use the DEST option, you must be aware of any restrictions placed on device-dependent data streams by the message control facility in use.

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

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.

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

Default action: terminate the task abnormally.