| |
Special Dispatcher Fields
Fields are parameters in the HTML Form or URL passed along through the Dispatcher to your application. Most fields are ones that you define, such as the name of a variable to graph or a year to use in a WHERE clause. Some fields have special meaning to the Dispatcher and are described here.
You can use quotation marks to surround the values provided in your HTML page, and you should use quotation marks if the values contain blanks. Use double, not single, quotation marks. If you are entering text that contains a single quotation mark, you must enclose the entire string in double quotation marks.
| Value |
Description |
| _ADMAIL |
E-mail address of the administrator. Automatically
generated by the Broker according to the AdministratorMail
directive. |
| _ADMIN |
Name of the administrator. Automatically generated by
the Broker according to the Administrator
directive. |
| _DEBUG |
Debugging flags. Default value is set by the Debug directive. See also Debug Values. |
| _FLDWDTH |
Maximum length for all other fields except those
whose name begins with an underscore (_). Default value
is set by the FieldWidth
directive.The maximum value is 200. Typically, you use
this only if you have TEXT or TEXTAREA
tags in your form. Any field that reaches the limit set
by this value and does not begin with an underscore is
word-wrapped into multiple fields. See also
Understanding
Name/Value Pairs. |
| _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 SAS source entry (a catalog with a .SOURCE
extension)
- Specify the four-level name: library.catalog.entry.source.
- A compiled SAS macro (a catalog entry with a
.MACRO extension)
- Specify the four-level name: library.catalog.entry.macro.
- A compiled 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 Dispatcher-reserved
Server Administration programs, such as ENDSAS and BREAK. For
information about server administration programs, see
Administering the Application Server.
In each of the above, library represents a LIBNAME allocated in the server autoexec file (srvauto.sas). Although .SAS files do not typically appear in a SAS library, the Application Server extracts the file path to the library and includes the file program.
|
| _SERVICE |
ID of a logical Application Server or a pool of
servers, which must match the ID of a service defined in your configuration file with the
LaunchService or SocketService
directives. |
| _TMPDIR |
Temporary directory (LaunchService only). |
| _URL |
Self-reference to the Broker CGI program. Useful
for generating pages that have links or inline images
that reinvoke the Dispatcher. See also the SelfURL directive. |
| _VERSION |
Broker version number. Automatically generated by the
Broker. |
|
