Write data to a standard CICS® supported
terminal.
SEND (z/OS Communications Server default)
>>-SEND--FROM(data-area)--+-LENGTH(data-value)--+--+------+----><
'-FLENGTH(data-value)-' '-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
- FLENGTH(data-value)
- An alternative to the LENGTH option.
For architectural reasons, this option is limited to a maximum of
32 KB for all terminal-related SEND commands.
- FROM(data-area)
- Specifies the data to be written to
the logical unit, or a partner transaction.
- 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 starts. 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 completes.
Conditions
Some
of the following conditions might occur in combination. If more than
one occurs, only the first is passed to the application program. EIBRCODE,
however, is set to indicate all the conditions that occurred.
- 16 INVREQ
- RESP2 values:
- 200
- A distributed program link server application attempted to send
on its function-shipping session (its principal facility).
For
SEND (APPC), a distributed program link server
application specified the function-shipping session (its principal
facility) on the CONVID
option.
Also occurs (RESP2 not set) in any of the following
situations:
- The CONFIRM option has been specified, but the
APPC conversation is not sync level 1 or 2.
- The SEND command has been used on an APPC conversation
that is not a mapped conversation or that is not using the EXEC CICS interface.
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.
- 61 NOTALLOC
- Occurs if the CONVID value
in the command does not relate to a conversation that is owned by
the application, or if the facility specified in the command is not
owned by the application.
Default action: terminate the task abnormally.