When you need information on Session or Application Status in an ACL, you can use two predefined variables.
This document describes their usage in an ACL program.
Release: 5.2
TPX-Session Management-Access Management package
To get information about the status of a session the function &SESS_INF(SessionID) can be used.
This function returns one of the following values:
ACTIVE APPL=appl Indicates that the session is currently active. The name of the VTAM-application is also returned.
ACL=program This indicates that the specified ACL/E program is running in the active session. CURRENT Indicates that the session is the user's current session. INACT Indicates that the session is not currently active, although it has been active
during the user's current session with CA-TPX. NEVACT Indicates that the session has never been active during the user's current session with CA-TPX. UNDEFINED The specified session is not a valid session name.
To get information about the status of an application the function &APPL_INF(ApplicationID) can be used.
This function returns one of the following values:
ACTIVE Indicates that the application is defined and is accepting logons. If the application is an internal
application like TPXADMIN or TPXOPER, then the string TYPE=TPX is appended.
INACT Indicates that the application is defined but is inactive.
QUIESCED Indicates that an operator quiesced the application in TPX. New sessions will not be started.
UNDEFINED Indicates that the application is not defined to CA-TPX.
Usage of these variables is normally in a SCAN-Statement where the value is compared against a string. Depending on the result, which is
stored in a Condition Code, processing continues.
Examples: