Issue synchronization request on APPC basic conversation (assembler-language
and C programs only).

GDS ISSUE CONFIRMATION (APPC basic)
>>-GDS ISSUE CONFIRMATION--CONVID(name)--CONVDATA(data-area)---->
>--RETCODE(data-area)--+-------------+-------------------------><
'-STATE(cvda)-'
Description
GDS ISSUE CONFIRMATION issues a synchronization request in response to
a GDS SEND CONFIRM issued by a partner transaction.
The return code is given in RETCODE (see Table 1). For a
list of return code values, see the CICS® Distributed Transaction Programming Guide.
EXEC CICS conditions are never raised on GDS commands.
Options
In general, the arguments can be replaced by absolute or relocatable assembler-language
expressions.
- 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 CICS Distributed Transaction Programming Guide.
- 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).
- 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 ISSUE CONFIRMATION 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 04 |
CONVID is for a conversation that is not basic. |
03 08 |
A state check has occurred. |
03 14 |
The command was issued for a sync level 0 conversation. |
04 |
CONVID is for a session that is not allocated to the task,
or that is a relay link. |