EXTRACT ATTRIBUTES (APPC)

Obtain the state of the APPC conversation.

EXTRACT ATTRIBUTES (APPC)

Read syntax diagramSkip visual syntax diagramEXTRACT ATTRIBUTESCONVID( name)STATE( cvda)

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.