APPSRVSET Function

Returns the numeric value of a PROC APPSRV parameter setting

Syntax

RC=APPSRVSET(valuecode,newvalue)

The APPSRVSET function takes one character string parameter and one numeric string parameter and returns a numeric string result.

The following table lists the valid parameters for valuecode and provides a description of each.

Valuecode Parameters

Valuecode	Description
AUTOMATIC HEADERS	specifies whether the APPSRV procedure returns headers. The value must be 0 (disabled) or 1 (enabled). Automatic header generation is enabled by default.
BACKGROUND	specifies that the APPSRV procedure runs in the background. This parameter is valid only for pool services. An optional parameter can also be set to specify a new request time-out value.
DISCONNECT	closes the socket that is opened to the Application Broker. This causes the Application Broker to exit.
PROGRAM ERROR	specifies the return code when there is an error. This can be set to any value.
REQUEST TIMEOUT	specifies the number of seconds that a requested program is allowed to run before it is terminated by the server. The default session time-out is 300 (5 minutes).
SESSION TIMEOUT	specifies the number of seconds that elapse before a session expires. The default session time-out is 900 (15 minutes).

Sample Statements

SAS Statements
rc=appsrvset('request timeout',300);
rc=appsrvset('session timeout',900);
rc=appsrvset('program error',256);
/* disable generation of MIME headers */ rc=appsrvset('automatic headers',0);
/* run the job in the background with / / a new time-out value of 5 minutes */ rc=appsrvset('background',300);
rc=appsrvset('disconnect');