Verbs and Built-in Functions › &APPC CONFIRMED

&APPC CONFIRMED

&APPC CONFIRMED sends a reply to the conversation partner's request for a reply (&APPC CONFIRM).

CONFIRMED indicates this is a conversation confirmation reply.

&APPC CONFIRMED has the following format:

&APPC CONFIRMED [ 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 CONFIRMED

&APPC CONFIRMED 
&APPC CONFIRMED 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 CONFIRMED request can only be issued from one of the confirm states, namely, confirm, confirm_send, or confirm_deallocate.

Confirm state is entered as a result of the remote program sending the CONFIRM request, and following the CONFIRMED reply the local program re-enters receive state.

Confirm_send state is entered as a result of the remote program sending the PREPARE_TO_RECEIVE TYPE=CONFIRM request, and following the CONFIRMED reply the local program enters send state.

Confirm_deallocate state is entered as a result of the remote program sending the DEALLOCATE TYPE=CONFIRM request, and following the CONFIRMED reply the local program enters deallocate state.

Notes:

• This request is useful when synchronizing processing in both ends of the conversation, and provides a means to verify the receipt of conversation data.
• To send a negative acknowledgement, use the SEND_ERROR request.

Relationship to LU6.2 Verb Set:

&APPC CONFIRMED is equivalent to the LU6.2 verb MC_CONFIRMED.

More information:

&APPC Return Code Information

&RETCODE and &ZFDBK