SAS/IntrNet 9.2: Application Dispatcher

REQUEST Statement

Controls how a request is processed by the Application Server

Syntax

REQUEST <INIT=program-name> <TERM=program-name> <LOGIN=program-name> <TIMEOUT=seconds> <MAXTIMEOUT=seconds> <READ=seconds> <FROMADR=("IP-address-1" <..."IP-address-n">)>;

Arguments

INIT=program-name

specifies the name of a program to run before each requested program. By default, no program is run before each request.

TERM=program-name

specifies the name of a program to run after each requested program. By default, no program is run after each request.

LOGIN=program-name

specifies the name of a program to run when the server is running with AUTH=HOST (a secure Application Server) and when _USERNAME and _PASSWORD are missing or incorrect. If the option is omitted, the user will receive a default response stating that the login information is missing or incorrect.

TIMEOUT=seconds

specifies the number of seconds that a requested program is allowed to run before it is terminated by the server. By default, the TIMEOUT is set to 300 (5 minutes). This value can be changed in a request program by calling the Application Dispatcher APPSRVSET function.

MAXTIMEOUT=seconds

is the maximum number of seconds that a timeout can be set to using the APPSRVSET function. The default value is 900 (15 minutes). For more information about setting the request timeout from a request program, see the SAS/IntrNet Application Dispatcher documentation for the APPSRVSET function.

READ=seconds

sets the number of seconds the server waits for a request to be read. The default value for READ is 30 seconds. The majority of requests are read in less than one second.

FROMADR=("IP-address-1" <..."IP-address-n">)

specifies a space-delimited list of IP addresses from which the server accepts requests. Each address must be enclosed in quotation marks. By default, requests are accepted from any address. This option accepts numeric IP numbers only. Names and wildcards in addresses are not supported. Enclose each IP address in quotation marks. Separate the IP addresses from each other with a white space and enclose the complete list in parentheses.

An IPv6 host usually supports both the IPv6 and IPv4 stacks and, therefore, has two IP addresses: the IPv6 address and the IPv4 address. The FROMADR= argument specifically uses an IP address to identify an acceptable client host. To ensure that an IPv6 host is not erroneously rejected, include both its IPv6 and IPv4 addresses in the FROMADR= argument. In the following example, the first FROMADR= argument is the IPv6 address. The second argument is the IPv4 address:

   request fromadr=("fec0::1:230:6eff:fef4:c827" "10.41.9.53");

Note: Starting with SAS/IntrNet 9.2, an illegal FROMADR IP address terminates the Application Server session. Before SAS/IntrNet 9.2, the illegal IP address appeared as a warning in the log and the Application Server ran.

Top of Page