Retrieves information about 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 PROCESS allows an application program to access conversation-related data, which is specified to CICS when the program is attached.
The attach receiver does not have to execute an EXTRACT PROCESS command unless it requires this information.

Opções:

CONVID(name)
• Identifies the conversation to which the command relates.
  The four-byte name identifies the token that represents the principal facility (returned by a previously-executed ASSIGN command).
• If this option is omitted, the principal facility is assumed.

PIPLENGTH(data-area)
• Specifies a 16-bit binary field that is to receive the total length of the PIP (process initialization parameter) list.
• This option is required only if PIPLIST is specified.

PIPLIST(ptr-ref)
• Specifies a pointer reference that is to be set to the address of a CICS-provided data area that contains a PIP list.
• This list contains variable-length records in the same format as is the list in the CONNECT PROCESS command.
• A returned value of zero means that no PIP data has been received by CICS.

PROCLENGTH(data-area)
• Specifies a 16-bit binary field that is to receive the length of the process name.
• This option is required only if PROCNAME is specified.

PROCNAME(data-area)
• Specifies a data area that is to receive the process name that is specified by the remote system that caused the task to start.
• The data area must be 32 bytes long.
• The process name is padded on the right with blanks.

• Process names (PROCNAMEs) on TXSeries for Multiplatforms must not exceed four bytes.
• However, PROCNAMEs flowed to other CICS systems, or to other APPC applications, can be longer than four bytes, depending on the requirements of that system.
• Although you can code PROCNAMEs that are up to 32 bytes long, they will be truncated by a TXSeries for Multiplatforms region if they are longer than four bytes.

SYNCLEVEL(data-area)
• Specifies a 16-bit binary field that is to receive the SYNCLEVEL value.
• For further information about synchronization levels, see the TXSeries for Multiplatforms Intercommunication Guide.

Condições:

INVREQ
• Occurs for the following conditions, depending on the options that are specified on the EXTRACT PROCESS command:
  • An option is incorrectly specified.
  • 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 issue an EXEC CICS EXTRACT PROCESS command that referred 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
• CONNECT PROCESS
• Appendix A, EXEC interface block (EIB) fields
• TXSeries for Multiplatforms Intercommunication Guide