Send data on an MRO conversation.

SEND (MRO)
>>-SEND--+---------------+--+------+--+--------+---------------->
'-SESSION(name)-' '-WAIT-' +-INVITE-+
'-LAST---'
>--+----------------+--+-----------------+---------------------->
'-ATTACHID(name)-' '-FROM(data-area)-'
>--+---------------------+--+-----+--+---------+---------------->
+-LENGTH(data-value)--+ '-FMH-' '-DEFRESP-'
'-FLENGTH(data-value)-'
>--+-------------+---------------------------------------------><
'-STATE(cvda)-'
Conditions: CBIDERR, INVREQ, LENGERR, NOTALLOC, TERMERR
Description
SEND sends data to a conversation
partner on an MRO conversation.
Options
- ATTACHID(name)
- specifies
that an attach header (created by a BUILD ATTACH command) is to precede, and
be concatenated with, the user data supplied in the FROM option. “name” (1–8
characters) identifies the attach header control block to be used in the local
task.
- DEFRESP
- indicates
that a definite response is required when the output operation has been completed.
- FLENGTH(data-value)
- A
fullword alternative to LENGTH.
- FMH
- specifies
that a function management header has been included in the data to be written.
If the ATTACHID option is specified as well, the concatenated FMH flag is
set in the attach FMH.
- FROM(data-area)
- specifies
the data to be written to the logical unit or terminal.
- INVITE
- specifies
that the next terminal control command to be executed for this facility is
a RECEIVE. This allows optimal flows to occur.
- LAST
- specifies
that this is the last output operation for a transaction and therefore the
end of a bracket.
- 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.
- SESSION(name)
- specifies
the symbolic identifier (1–4 characters) of a session TCTTE. This option specifies
the alternate facility to be used. If this option is omitted, the principal
facility for the task is used.
- STATE(cvda)
- gets the state of the transaction
program. The cvda values returned by CICS are:
- ALLOCATED
- FREE
- PENDFREE
- RECEIVE
- ROLLBACK
- SEND
- SYNCFREE
- SYNCRECEIVE
- SYNCSEND
- 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
- CBIDERR
- occurs
if the requested attach header control block named in ATTACHID cannot be found.
Default action: terminate the task abnormally.
- 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.
- TERMERR
- occurs
for a terminal-related error, such as a session failure. This condition applies
to VTAM®-connected
terminals only.
A CANCEL TASK request by a user node error program
(NEP) may cause this condition if the task has an outstanding terminal control
request active when the node abnormal condition program (DFHZNAC) handles
the session error.
Default action: terminate the task abnormally with
abend code ATNI.