Sends data on an advanced program-to-program communications (APPC) mapped conversation.
An APPC conversation allows a program to send data to, and receive data from, a program that is running in a remote system.
Programming that uses APPC conversations is called Distributed Transaction Programming (DTP).
For guidance information about DTP, refer to the TXSeries for Multiplatforms Intercommunication Guide.

Sintaxe:

Descrição:

SEND sends data either on an APPC mapped conversation, or to a terminal.
The form of SEND command that is described here is used for sending data to the conversation partner in an APPC mapped conversation.

For details of the SEND command for use with terminals, see SEND (terminal).

Opções:

CONFIRM
• Indicates that an application that is using a synchronization level 1 or 2 conversation requires a response from the remote application.
• A remote CICS application can respond positively by executing an ISSUE CONFIRMATION command, or negatively by executing an ISSUE ERROR command, in which case the sending application has EIBERR and EIBERRCD set.
• CICS does not return control to the application that is sending the CONFIRM, until the response is received.

CONVID(name)
• Identifies the conversation to which the command relates.
• The four-character name identifies either the token that was returned by a previously executed ALLOCATE command in the EIBRSRCE field of the EXEC Interface Block, or the token that represents the principal facility (that was returned by a previously executed ASSIGN command).
• If this option is omitted, the principal facility is assumed.

FLENGTH(data-value)
• A 32-bit alternative to LENGTH(data-value).

FROM(data-area)
• Specifies the data that is to be sent to the partner transaction.
• This option can be omitted if INVITE, LAST, CONFIRM, or WAIT is specified.

INVITE
• Allows an application program to send the change of direction indicator, specifying that the next command that is to be executed for this conversation is a RECEIVE.
• This control data is not transmitted by CICS until the subsequent execution of a WAIT or a SYNCPOINT command, unless CONFIRM or WAIT is also specified on the SEND command.

LAST
• Specifies that this is the last SEND command for a transaction and therefore the end of the conversation.
• No further data flows can occur and the next action must free the session.
• For synch level 2, the FREE command must be preceded by a SYNCPOINT.

LENGTH(data-value)
• Specifies, as a 16-bit binary value, the length of the data that is to be sent.
• See LENGTH for more information about using this option.

STATE(cvda)
• Gets the state of the current conversation. See STATE.

WAIT
• Ensures that the specified data is sent and is not buffered internally.
• If the WAIT option is not specified, the data can be buffered internally (by APPC) until a later command.

Condições:

INVREQ
• Occurs for the following conditions, depending on the options that are specified on the SEND command:
  • The CONFIRM option has been specified, but the APPC conversation is not at synchronization level 1 or 2.
  • Any of the APPC-related SEND options (CONFIRM, INVITE, LAST, or STATE) has been specified, but the CONVID option is omitted and the principal facility for the task is not an APPC conversation (that is, it is a terminal).
  • Any of the APPC options has been specified on a terminal SEND.
  • When an attempt is made to use a distributed transaction processing (DTP) command on a valid non-DTP CONVID.
  • A remotely linked-to program attempted to issue an EXEC CICS SEND command that referred to the principal facility.
• Ação pré-definida: Terminates the task abnormally.

LENGERR
• Occurs if an out-of-range value is supplied in the LENGTH or FLENGTH option (zero is acceptable).
• Ação pré-definida: Terminates the task abnormally.

NOTALLOC
• Occurs if the specified CONVID value does not relate to a conversation that the application owns.
• Ação pré-definida: Terminates the task abnormally.

SIGNAL
• Occurs if an inbound SIGNAL data-flow control command is received from the partner transaction.
• EIBSIG is always set when an inbound signal is received.
• Ação pré-definida: Ignore the condition.

TERMERR
• Occurs if a session-related error occurs. Any subsequent action on that conversation other than a FREE command causes an ATCV abend.
• Ação pré-definida: Terminate the task abnormally (with abend code ATNI).

Informações relacionadas:

• CICS-value data areas (CVDA)
• ALLOCATE
• ASSIGN
• RECEIVE (APPC)
• SEND (terminal)
• Appendix A, EXEC interface block (EIB) fields
• CVDAs sorted by symbolic name
• CVDAs sorted by numeric value
• TXSeries for Multiplatforms Intercommunication Guide