Reserved or Special Variables

Application Dispatcher variables are referred to as name/value pairs, symbols, fields, or variables. You define most variables, such as the name of a data set to graph or a year to use in a WHERE clause. Some fields have special meaning to the Dispatcher and are described here.

Value	Description
_ADMAIL	E-mail address of the administrator. Automatically generated by the Application Broker according to the AdministratorMail directive.
_ADMIN	Name of the administrator. Automatically generated by the Application Broker according to the Administrator directive.
_DEBUG	Debugging flags. Default value is set by the Debug directive. See also Setting the Default Value of _Debug.
_PGM	The next to last level in the value of the _PROGRAM variable. Indicates the name of the external file or catalog entry containing the current program code. This variable is created by the Application Server and is not one of the symbols passed from the Application Broker.
_PGMCAT	The second level in the value of the _PROGRAM variable. It indicates the SAS catalog containing the current program. This variable is blank for programs of type SAS because they have three-level names and are stored in external files. This variable is created by the Application Server and is not one of the symbols passed from the Application Broker.
_PGMLIB	The first level in the value of the _PROGRAM variable. It indicates the program library for the current program. This variable is created by the Application Server and is not one of the symbols passed from the Application Broker.
_PROGRAM	Name of the Dispatcher program that the Application Server should run. The following lists the program types and the syntax for each: A SAS program (an external file containing SAS source code with a .SAS extension) Specify the fully qualified, three-level name: `library.filename``.sas.` A source entry (a catalog entry with a .SOURCE extension) Specify the four-level name: `library.catalog.entry``.source`. A macro entry (a catalog entry with a .MACRO extension) Specify the four-level name: `library.catalog.entry``.macro`. An SCL entry (a catalog entry with a .SCL extension) Specify the four-level name: `library.catalog.entry``.scl`. You must specify a three- or four-level name in the _PROGRAM field, except when using Application Dispatcher-reserved Server Administration Programs, such as STATUS and STOP. For information about Application Server Administration Programs, see Application Server Administration Programs. For more information on _PROGRAM see The Four Types of Programs.
_PGMTYPE	The last level in the value of the _PROGRAM variable. It indicates the type of the current program. This variable is created by the Application Server and is not one of the symbols passed from the Application Broker.
_PORT	The TCP/IP port number of the current Application Server. Together with _Server, it indicates the server selected out of the specified service.
_REPLAY	A complete URL for use with programs that use the Output Delivery System (ODS). It is composed from the values of _URL, _SERVICE, and _TMPCAT. ODS uses this URL to create links that will replay stored output when they are loaded by the user's Web browser. See also Using the Output Delivery System. This variable is created by the Application Server and is not one of the symbols passed from the Application Broker.
_SERVER	The DNS or IP address of the current Application Server. Together with _PORT, it indicates the server selected out of the specified service.
_SERVICE	Name of a Dispatcher Service defined in your configuration file with the LaunchService or SocketService directives.
_STATDATALIBNAME	The LIBNAME, the physical name, and the options of the ALLOCATE FILE statement for the statistics data set library. This variable enables the application to assign a LIBNAME to the library with additional options (for example, ACCESS=READONLY).
_STATDATASET	The library.DATASET setting of the statistics data set for this server.
_STATDATASETAVAIL	The status of the statistics data set. This variable is set to one of the following values: OK, NOADMINPW, or NOSTATS. See also the STATISTICS statement.
_THISSRV	A URL composed from the values of _URL and _SERVICE. This variable is created by the Application Server and is not one of the symbols passed from the Application Broker.
_THISSESSION	A URL composed from the values of _URL, _SERVICE, _SERVER, _PORT, and _SESSIONID. This variable is created by the Application Server and should be used as the base URL for all URL references to the current session.
_TMPCAT	A unique, temporary catalog name. This catalog can be used to store temporary entries to be retrieved later. In socket servers, the _TMPCAT catalog is deleted after a number of minutes specified in the variable _EXPIRE. This variable is created by the Application Server and is not one of the symbols passed from the Application Broker. See Using the Output Delivery System.
_URL	Self-reference to the Application Broker CGI program. Useful for generating pages that have links or inline images that reinvoke the Dispatcher. See also the SelfURL directive.
_VERSION	Application Broker version number. Automatically generated by the Application Broker.