SEND (non-VTAM® default)

Write data to standard CICS® terminal support.

Read syntax diagramSkip visual syntax diagram
SEND (non-VTAM default)

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

>--+------------+--+------+------------------------------------><
   '-DEST(name)-'  '-WAIT-'   

Conditions: INVREQ, LENGERR, NOTALLOC

 

Description

SEND writes data to a terminal. This form of the send command can be used by all CICS-supported terminals for which the other SEND descriptions are not appropriate.

Options

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

NOTALLOC
occurs if the facility specified in the command is not owned by the application.

Default action: terminate the task abnormally.