Verbs and Built-in Functions › &APPC TEST

&APPC TEST

&APPC TEST sets the default conversation in NCL, usually as a prelude to interrogating the LU6.2 system variables.

This verb has the following format:

&APPC TEST
    [ ID=id ]

Operands:

TEST

Indicates this is a conversation test request.

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 TEST

&APPC TEST 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.

Note:

The &APPC TEST request is normally only necessary where multiple conversations are being operated concurrently by the NCL procedure. By specifying the conversation identifier being tested on the ID operand this conversation becomes the default operation conversation for all &APPC requests. In addition, this ensures that all system variables associated with &APPC processing relate to that particular conversation.

Relationship to LU6.2 Verb Set:

&APPC TEST is equivalent to the LU6.2 verbs MC_TEST and MC_GET_ATTRIBUTES.

More information:

&APPC Return Code Information

&RETCODE and &ZFDBK