Obtain the state of the APPC conversation.
EXTRACT ATTRIBUTES (APPC) >>-EXTRACT ATTRIBUTES--+--------------+--STATE(cvda)----------->< '-CONVID(name)-'
Conditions: INVREQ, NOTALLOC
Description
EXTRACT ATTRIBUTES extracts conversation state information for APPC mapped conversations.
Options
- CONVID(name)
- identifies the conversation to which the command relates. The 4-character
name identifies either the token returned by a previously executed ALLOCATE
command in EIBRSRCE in the EIB, or the token representing the principal session
(returned by a previously executed ASSIGN command).
For compatibility with earlier releases, SESSION is accepted as a synonym for CONVID. New programs should use CONVID.
By default, the principal facility is assumed.
- STATE(cvda)
- gets the state of the transaction program. The cvda values returned
by CICS® are:
- ALLOCATED
- CONFFREE
- CONFRECEIVE
- CONFSEND
- FREE
- PENDFREE
- PENDRECEIVE
- RECEIVE
- ROLLBACK
- SEND
- SYNCFREE
- SYNCRECEIVE
- SYNCSEND
Conditions
- 16 INVREQ
- RESP2 values:
- 200
- A distributed program link server application explicitly, or implicitly by default, specified the function-shipping session (its principal facility) on the CONVID option.
also occurs (RESP2 not set) in any of the following situations:- The command is issued against a CPI-Communications conversation.
- The command is issued against an APPC basic conversation. (A GDS EXTRACT ATTRIBUTES should have been used instead.)
Default action: terminate the task abnormally.
- 61 NOTALLOC
- occurs if the specified CONVID value does not relate to a conversation
owned by the application.
Default action: terminate the task abnormally.
