SEND (3650-3680)

Write data to a 3650 (3680) logical unit.

Read syntax diagramSkip visual syntax diagram
SEND (3650-3680)

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

>--+--------+--+-----------+--+-----+--------------------------><
   +-INVITE-+  +-CNOTCOMPL-+  '-FMH-'   
   '-LAST---'  '-DEFRESP---'            

Conditions: INVREQ, LENGERR, TERMERR

 

Description

SEND writes data to a terminal.

Options

CNOTCOMPL
Indicates that the request/response unit (RU) sent as a result of this SEND command does not complete the chain. If this option is omitted and chain assembly is specified, the RU terminates the chain.
DEFRESP
Indicates that a definite response is required when the output operation completes.
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.
FMH
Specifies that a function management header is 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.

The use of FMH is optional and is not supported for all terminal types. If not supplied, CICS® takes no action, except for 3600/4700 terminals, where an FMH is mandatory. In this case, if FMH is not specified, CICS supplies one and places it in the first 3 bytes of the message, which you must reserve for this purpose.

FROM(data-area)
Specifies the data to be written to the logical unit, or a partner transaction.
INVITE
For the SEND (APPC) command, an application can use the INVITE option to add a change-direction indicator to data already sent to a process in a connected APPC system. Control data is not transmitted by CICS until the subsequent WAIT or a SYNCPOINT command, unless CONFIRM or WAIT is also coded on the GDS SEND INVITE command.

For the other SEND commands, INVITE specifies that the next terminal control command to be run for this facility is a RECEIVE. This allows optimal flows to occur.

LAST
Specifies that this is the last SEND command for a 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.

81 TERMERR
Occurs for a session-related error. Any action on that conversation other than a FREE causes an ATCV abend.

A CANCEL TASK request by a user node error program (NEP) might cause this condition if the task has an outstanding terminal control request active when the node abnormal condition program handles the session error.

Default action: terminate the task abnormally with abend code ATNI.



dfhp4_send36503680.html | Timestamp icon Last updated: Thursday, 27 June 2019