Verbs and Built-in Functions › &APPC CONFIRM

&APPC CONFIRM

&APPC CONFIRM sends a request for confirmation to the conversation partner and waits for the reply.

CONFIRM indicates this is a conversation confirmation request.

&APPC CONFIRM has the following format:

&APPC CONFIRM [ ID=id ]

Operand:

ID=id

Specifies the conversation identifier (as first returned by the system variable &ZAPPCID after successful allocation) that references a particular conversation. If this parameter is omitted the current (last referenced, or only) conversation is assumed.

Examples: &APPC CONFIRM

&APPC CONFIRM 
&APPC CONFIRM ID=999

Return Codes:

The return codes are as follows:

0

Request successful

4

Request unsuccessful

8

Remote program error

12

State check

16

Request or conversation error

&ZFDBK is also set, plus all APPC system variables.

State Transition:

The CONFIRM request can only be issued from send state. When the remote program responds with the CONFIRMED request, the return code is set to 0 and no local state change occurs. If the remote program issues SEND_ERROR the return code is set to 8 and the local state is changed to receive state.

Notes:

• This request is useful in synchronizing processing in both ends of the conversation, and provides a means to request verification of the receipt of conversation data.
• If following a successful confirmation, the next conversation action is to receive data, consider using the PREPARE_TO_RECEIVE TYPE= CONFIRM or TYPE=FLUSH request, for improved communication efficiency.
• If following a successful confirmation, the next conversation action is to deallocate the conversation, consider using the DEALLOCATE TYPE=CONFIRM request for improved communication efficiency.

Relationship to LU6.2 Verb Set:

&APPC CONFIRM is equivalent to the LU6.2 verb MC_CONFIRM.

More information:

&APPC Return Code Information

&RETCODE and &ZFDBK