Previous Topic: Create Control ACL/E ProgramsNext Topic: Error Messages


Variables Used in

To specify information to your control ACL program, use the following variables:

ZPCODE

Indicates the status of the virtual terminal (ACB) call. This variable has a value of ASSIGN when the session is initiated and a value of FREE when the session is terminated.

ZPUID

Indicates the user ID of the user who is activating the session.

ZPSID

Indicates the session ID of the requested session.

ZPACB

Indicates the name of the allocated virtual terminal.

ZPTERM

Indicates the ID of the requester's physical terminal.

ZPAPPL

Indicates the application ID for the session.

You should write the ACL program to detect any unusual situations and set the variables ZPRTCDE and ZPFDBK with your own error code and message.

ZPRTCDE

A 1-to-8 character return code (non-blank=failure).

ZPFDBK

A 1-to-64 character message describing the error.

If values are assigned to these variables during the execution of the control ACL program, panel TEN0056 is displayed, informing the user starting the application session of the error. This panel is not displayed if ZPRTCDE is set to NODISP.

When a value has been assigned to ZPRTCDE (indicating an error), the virtual terminal selected for the session is not freed unless you set the variable ZPFDBK to one of the following:

NOKEEP

Frees the virtual terminal requested for the session.

UNAVAIL

Marks the virtual terminal as unavailable.