Write data to a 2260 or 2265 display station.

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: 
In
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.

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.