Access state information on an APPC basic conversation (assembler-language
and C programs only).
GDS EXTRACT ATTRIBUTES (APPC basic)
>>-GDS EXTRACT ATTRIBUTES--CONVID(name)--+-------------+-------->
'-STATE(cvda)-'
>--CONVDATA(data-area)--RETCODE(data-area)---------------------><
Description
GDS EXTRACT ATTRIBUTES accesses state
information about an APPC basic conversation.
The return code is given
in RETCODE (see Table 1). For a list of return
code values, see the Return codes for APPC basic conversations .
EXEC CICS® conditions
are never raised on GDS commands.
Options
In general, the arguments can be replaced
by absolute or relocatable assembler-language expressions.
- CONVID(name)
- identifies
the conversation to which the command relates. The 4-character name identifies
either the token returned by a previously executed GDS ALLOCATE command, or
the token representing the principal session (returned by a previously executed
GDS ASSIGN command).
- CONVDATA(data-area)
- specifies
the 24-byte application data area into which conversation-related information
is to be moved. A description of the format of the data area is given in the
discussion of CONVDATA fields in the Testing indicators .
- RETCODE(data-area)
- specifies
the 6-byte application data area into which return code information (shown
in Table 1) is to be moved.
- STATE(cvda)
- gets
the state of the current conversation. The cvda values returned by CICS are:
- ALLOCATED
- CONFFREE
- CONFRECEIVE
- CONFSEND
- FREE
- PENDFREE
- PENDRECEIVE
- RECEIVE
- ROLLBACK
- SEND
- SYNCFREE
- SYNCRECEIVE
- SYNCSEND
Table 1. GDS EXTRACT ATTRIBUTES
return codesRETCODE (hexadecimal) |
Description |
03 00 |
CONVID is for a session that is not APPC. |
03 00 |
CONVID is for a session that is in use by CPI Communications. |
03 01 |
INVREQ for a DPL server program. |
03 04 |
CONVID is for a conversation that is not basic. |
04 |
CONVID is for a session that is not allocated to the task,
or that is a relay link. |