Obtains the state of an advanced program-to-program communications (APPC) 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 on DTP, refer to the TXSeries for Multiplatforms Intercommunication Guide.)

Sintaxe:

Descrição:

EXTRACT ATTRIBUTES extracts conversation state information for APPC mapped conversations.

Opções:

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

STATE(cvda)
• See STATE.

Condições:

INVREQ
• Occurs for the following conditions, depending on the options that are specified on the EXTRACT ATTRIBUTES command:
  • If the CONVID option is omitted and the principal facility is not an APPC conversation.
  • An attempt was made to use a distributed transaction processing (DTP) command on a valid non-DTP convid.
  • A remotely linked-to program attempted to execute an EXTRACT ATTRIBUTES command that refers to the principal facility.
• Ação pré-definida: Terminates the task abnormally.

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

Informações relacionadas:

• CICS-value data areas (CVDA)
• ALLOCATE
• ASSIGN
• Appendix A, EXEC interface block (EIB) fields
• Appendix F, CVDAs recognized by the translator