GDS ISSUE CONFIRMATION

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

GDS ISSUE CONFIRMATION (APPC basic)

Read syntax diagramSkip visual syntax diagramGDS ISSUE CONFIRMATIONCONVID( 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 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.

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 .
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 codes
RETCODE (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.