Verbs and Built-in Functions › &APPC SEND_AND_DEALLOCATE

&APPC SEND_AND_DEALLOCATE

&APPC SEND_AND_DEALLOCATE sends a single data record to the remote conversation partner and requests conversation termination and deallocation of its resources.

This verb has the following format:

&APPC SEND_AND_DEALLOCATE
    [ ID=id ]
    [ MDO=mdoname [ MAP=mapname ] |
      VARS=var | VARS=(var1, var2, ..., varn ) |
      VARS=prefix* [ RANGE=(start,end) ] ]
    [ TYPE={ SYNC | FLUSH | CONFIRM } ]

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 should be 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 requester's responsibility to connect to Mapping Services Mapping Support, if required, using the MAP operand.

The VARS= operand is used to provide the list of NCL variables that will 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 will be 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.

TYPE={ SYNC | FLUSH | CONFIRM }

Specifies the deallocate option. TYPE=SYNC is the default. If the conversation sync level is CONFIRM, it is equivalent to the DEALLOCATE TYPE=CONFIRM option; otherwise a DEALLOCATE TYPE=FLUSH is assumed.

TYPE=FLUSH results in all data being flushed, forcing its transmission to the conversation partner before unconditional deallocation occurs.

TYPE=CONFIRM results in all data being flushed and a confirmation being requested before deallocation occurs.

Examples: &APPC SEND_AND_DEALLOCATE

&APPC SEND_AND_DEALLOCATE MDO=ALERT

&APPC SEND_AND_DEALLOCATE TYPE=FLUSH

Return Codes:

The return codes are as follows:

0

Data sent and conversation deallocated

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 DEALLOCATE.

Note:

The SEND_AND_DEALLOCATE is a convenient way of combining two basic APPC operations, that of sending data and of deallocating the conversation resources. It is equivalent to issuing an &APPC SEND_DATA followed by an &APPC DEALLOCATE 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)).
• The FMH_DATA parameter of the LU6.2 verb SEND_DATA is not supported by &APPC.
• &APPC DEALLOCATE is equivalent to the LU6.2 verb MC_DEALLOCATE.

More information:

&APPC Return Code Information

&RETCODE and &ZFDBK