Verbs and Built-in Functions › &APPC FLUSH

&APPC FLUSH

&APPC FLUSH flushes any locally buffered information and forces its transmission to the remote conversation partner.

FLUSH indicates a conversation flush request.

This verb has the following format:

&APPC FLUSH [ 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.

Example: &APPC FLUSH

&APPC SEND_DATA VARS=DATA
&APPC FLUSH

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 FLUSH request can only be issued from send state and no state changes occur.

Note:

Plan carefully before you use this request. Usually, the system manages the requirement to flush send buffers based on session parameters, conversation parameters, and the current state of processing. As data accumulates for a conversation or if some form of reply is required from the remote end, all queued output is scheduled automatically for transmission in optimum message units. Issuing the FLUSH request unnecessarily can reduce such efficiencies.

Relationship to LU6.2 Verb Set:

&APPC FLUSH is equivalent to the LU6.2 verb MC_FLUSH.

More information:

&APPC Return Code Information

&RETCODE and &ZFDBK