&APPSTAT

&APPSTAT returns the current status for a specific VTAM application.

&APPSTAT is a built-in function and must be used to the right of an assignment statement.

This built-in function has the following format:

&APPSTAT applname

&APPSTAT lets you interrogate the current status of VTAM applications within the network. The status is determined when the &APPSTAT function is processed.

The status of the specified application (applname) is returned in the variable specified as the assignment target.

The status returned is one of the following defaulted values:

ACTIVE: The application is available and accepting logons.
INACTIVE: The application is not available.
NOLOGONS: The application is available but not accepting logons.
NOTAPPL: The resource specified is not an application.
UNAVAIL: Unable to determine status.
UNKNOWN: Resource is not known to VTAM.

If the SYSPARMS APPTXTn command has been used to change these default values, the substituted values are used.

Operand:

applname: Specifies the name for the VTAM application whose status is to be determined.

Examples: &APPSTAT

&1 = &APPSTAT IMS

&STATUS = &APPSTAT TSO2

Notes:

Application status is determined when the &APPSTAT statement is processed. If the application specified resides in another processor elsewhere in the network, it could take sometime to determine the application status. (If the other processor in which that application resides has stopped, this period is indeterminable.)

Important! Do not use &APPSTAT in EASINET procedures, as unacceptable delays can occur. To avoid this, the Application Status Monitoring facilities identify application names for which the system is to maintain current status. This status is updated at an installation-defined frequency. These facilities generate a global variable showing the status of the application for each application nominated. Global variables can then be referenced from a full-screen panel without incurring any of the delays that can occur with &APPSTAT.