Verbs and Built-in Functions › &APPC SEND_AND_CONFIRM

&APPC SEND_AND_CONFIRM

&APPC SEND_AND_CONFIRM sends a single data record and a request for confirmation to the conversation partner and waits for the reply.

This verb has the following format:

&APPC SEND_AND_CONFIRM
    [ ID=id ]
    [ MDO=mdoname [ MAP=mapname ] |
      VARS=var | VARS=(var1, var2, ..., varn ) |
      VARS=prefix* [ RANGE=(start,end) ] ]

Operands:

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.

MDO=mdoname [ MAP=mapname ] | VARS=var |
VARS=( var1,var2,...,varn ) | VARS=prefix* [ RANGE=(start,end) ]

Indicates how the outgoing data is formatted. If the MDO operand is used, the data is formatted into an MDO with the name mdoname. If the outgoing data is mapped (that is, a map name is sent with the data) and MAP= is not specified, then the received map name is used to connect to Mapping Services Mapping Support. If the outgoing data is not mapped, then it is the responsibility of the requester to connect to Mapping Services Mapping Support, if necessary, using the MAP operand.

The VARS= operand provides the list of NCL variables that contain the data received on the conversation (the usual NCL VARS definitions apply). If the outgoing data is not mapped, or the map name is other than $NCL, then the data stream received is segmented into the variables nominated. If the data is mapped and the map name is $NCL, then each variable is reconstructed as it was on the send request in the conversation partner. Unused variables are set to null.

Examples: &APPC_SEND_AND_CONFIRM

&APPC_SEND_AND_CONFIRM MDO=CLIENTRQST

&APPC_SEND_AND_CONFIRM VARS=ALERT

Return Codes:

The return codes are as follows:

0

Data sent and CONFIRMED has been received

4

Request unsuccessful

8

Other program issued SEND_ERROR

12

State check

16

Request or conversation error

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

State Transition:

See &APPC SEND and &APPC CONFIRM.

Note:

The SEND_AND_CONFIRM is a convenient way of combining two basic APPC operations, that of sending data and of confirming receipt of that data. The verb is equivalent to issuing an &APPC SEND_DATA followed by an &APPC CONFIRM request.

Relationship to LU6.2 Verb Set:

• &APPC SEND_DATA is equivalent to the LU6.2 verb MC_SEND_DATA.
• The &APPC SEND_DATA operands of VARS and MDO are used in place of the LU6.2 verb SEND_DATA options DATA and LENGTH.
• The &APPC SEND_DATA operand MAP=mapname is equivalent to the LU6.2 verb SEND_DATA option MAP(YES(mapname)).
• &APPC does not support the FMH_DATA parameter of the LU6.2 verb SEND_DATA.
• &APPC CONFIRMED is equivalent to the LU6.2 verb MC_CONFIRMED.

More information:

&APPC Return Code Information

&RETCODE and &ZFDBK