Write data to a 3270 information display system (TCAM).

SEND (3270 display)
>>-SEND--FROM(data-area)--+-LENGTH(data-value)--+--------------->
'-FLENGTH(data-value)-'
>--+------------+--+------+------------------------------------->
'-DEST(name)-' '-WAIT-'
>--+-+----------------------+--+---------------------+-+-------><
| '-ERASE--+-----------+-' '-CTLCHAR(data-value)-' |
| +-DEFAULT---+ |
| '-ALTERNATE-' |
'-+----------+--------------------------------------'
'-STRFIELD-'
Conditions: INVREQ, LENGERR
Description
SEND writes data to a terminal.
Options
- ALTERNATE
- sets
the terminal to use the ALTERNATE screen size.
- 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.
- DEFAULT
- sets
the terminal to use the DEFAULT screen size.
- 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.
- 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.
- 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.
- 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 CICS 3270 Data Stream
Device Guide.)
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.
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.