The server definition contains startup and connection information for an instance of a SAS server. The server is defined using the fields listed in the following table. For each field, the table shows the following information:
| Fields for the Server Definition |
|---|
| Field Name |
Required
Optional |
Server Type |
Definition |
Availability Timeout
In SAS Management Console:
Options  Advanced Options Load Balancing Properties: Availability Timeout |
Optional |
IOM Bridge |
For load-balancing servers, the number of milliseconds to wait for a load-balancing server to become available. This parameter is used in the following situations:
when all servers have allocated the maximum number of clients per server. when load balancing is waiting for a server to start and become available for its first client. |
Command
In SAS Management Console:
Options Launch Commands: Command |
Required |
IOM Bridge |
The command used to launch SAS as an object server. If the SAS executable is not
already in your path, then specify the path to sas.exe. You can also specify additional
options on the command line. For details, see Server Startup
Command. This field is used only for spawned servers. |
Description
In SAS Management Console:
General Description |
Optional |
COM/DCOM, IOM Bridge |
Text to summarize why this definition exists. |
Authentication Domain
In SAS Management Console:
<Connection> Options Authentication Domain |
Required |
IOM Bridge |
The domain that is associated with a set of computing resources that use the same authentication process. In IOM Bridge servers configurations, the spawner definition must have the same authentication domain name as the server definition. The spawner uses the authentication domain name, along with the machine name, to determine which servers it services. |
Host Name
In SAS Management Console:
<Connection> Options Host Name |
Required |
COM/DCOM, IOM Bridge |
The DNS name or IP address for the machine on which this server definition can execute. The machine name must be the official network name (for example, machine.corp.com). The string localhost can be used to signify the host on which the associated spawner is executing.
Note: If you use localhost in the configuration, it could cause clients to connect to their local machine instead of the machine that an administrator designates as localhost. |
Inactivity Timeout
In SAS Management Console:
Options Advanced Options Load Balancing Properties Inactivity Timeout
and
Options Advanced Options Pooling Properties Inactivity Timeout |
Optional |
COM/DCOM, IOM Bridge |
If you are using connection pooling (SAS Workspace Server only) or load balancing (SAS Stored Process Server only), specifies whether an idle server should always remain running, and if not, how long it should run before being shut down. If the check box is not selected, then idle servers remain running. If the check box is selected, then the servers run idle for the number of minutes specified in the field before being shut down. If the check box is selected and 0 is specified as the inactivity timeout, then the server behavior is as follows:
for load balancing (IOM Bridge only), the server will shut down when the last client disconnects from the server. for pooling, a connection returned to a pool by a user is disconnected immediately unless another user is waiting for a connection from the pool. The maximum value is 1440. |
Login
In SAS Management Console:
Options Advanced Options Credentials Login |
Optional |
IOM Bridge |
For SAS Stored Process Servers, the login that provides the spawner with credentials to use when starting a multi-user SAS session.
Note: If the server runs on Windows 2000 and Windows NT, for the user who is the owner of the multi-user login, define the "act as part of the operating system" user right.
|
Major Version Number
In SAS Management Console:
Options Major Version Number |
Required |
COM/DCOM, IOM Bridge |
Specifies the major version number of the component. |
Minor Version Number
In SAS Management Console:
Options Minor Version Number |
Required |
COM/DCOM, IOM Bridge |
Specifies the minor version number of the component. |
Maximum Clients
In SAS Management Console:
Options Advanced Options Load Balancing Properties Maximum Clients
and
Options Advanced Options Pooling Properties Maximum Clients |
Optional |
COM/DCOM, IOM Bridge |
For Pooling (SAS Workspace Server), specifies the maximum number of simultaneous connections from the pool. For Load Balancing (SAS Stored Process Servers and Response Time algorithm only), specifies the maximum number of simultaneous clients connected to this server. |
Maximum Cost
In SAS Management Console:
Options Advanced Options Load Balancing Properties Maximum Cost |
Optional |
IOM Bridge |
For load-balancing servers using the cost algorithm, the maximum cost allowed on each SAS server
before requests to the server are denied. |
Name
In SAS Management Console:
General Name |
Required |
COM/DCOM, IOM Bridge |
The unique name for this server. |
Object Server Parameters
In SAS Management Console:
Options Launch Commands: Object Server Parameters |
Optional |
IOM Bridge |
For spawned servers, these object server parameters are added to others that are
generated by the spawner and used to launch SAS. For servers that are not spawned, the
values that you specify here can be used to supplement any that were supplied on
the server invocation command line. Any command line parameters take precedence. For a
list of object server parameters, see Object Server
Parameters. For a more detailed explanation of object server parameter handling, see
Server Startup Command. |
Port Number
In SAS Management Console:
<Connection> Options Port Number |
Required if server will have Java clients |
IOM Bridge |
The port on which to connect to this server.
If you specify a value for both port and service, then the value for service is used.
If you are using a spawner and neither port nor service is specified, the spawner attempts to use the service name sasobjspawn as the service. If sasobjspawn has already been used, the spawner removes this service definition from its list.
The port number is required if the server will have Java clients.
The default port numbers are as follows:
- SAS Workspace Server:
8591
- SAS Stored Process Server:
8601
- SAS OLAP Server:
5451
- SAS Metadata Server:
8561
|
Protocol
In SAS Management Console:
<Connection> Protocol |
Required |
COM/DCOM, IOM Bridge |
The protocol (Bridge or COM) that clients can use for connection. The protocol bridge must be used for servers that are serviced by the spawner. These include all servers other than Windows, as well as Windows servers that will be accessed by Java clients. |
Recycle Activation Limit
In SAS Management Console:
Options Advanced Options Load Balancing Properties Recycle Activation Limit
and
Options Advanced Options Pooling Properties Recycle Activation Limit
|
Optional |
COM/DCOM, IOM Bridge |
For pooling (SAS Workspace Servers only) and load balancing (SAS Stored Process Servers only), specifies the number of times a connection to the server will be reused in a pool before it is disconnected ("recycled"). If the value is 0, then there will be no limit on the number of times a connection to the server can be reused. This property is optional. The default value is 0.
Note: For SAS Stored Process Servers, setting a Recycle Activation Limit can cause problems with sessions. If you create sessions, use the default value of 0 for Reaction Activation Limit.
|
Required Encryption Level
In SAS Management Console:
<Connection> Options Advanced Options Encryption Required Encryption Level |
Optional |
IOM Bridge |
The level of encryption to be used between the client and the server. None means no encryption is performed; Credentials means that only user credentials (ID and password) are encrypted; and Everything means that all communications between the client and server are encrypted. The default is Credentials. |
Server Encryption Algorithms
In SAS Management Console:
<Connection> Options Advanced Options Encryption Server Encryption Algorithms |
Optional |
IOM Bridge |
The encryption algorithms that are supported by the launched object server. Valid values are: RC2, RC4, DES, TRIPLEDES, and SASPROPRIETARY, depending on the country in which the SAS software is licensed. See SAS/SECURE documentation for more information regarding this field. The default is SASPROPRIETARY. |
Service
In SAS Management Console:
<Connection> Options Advanced Options Service |
Optional |
IOM Bridge |
The service in which to connect to this server.
If you specify a value for both port and service, then the value for service is used.
If you are using a spawner and neither port nor service is specified, the spawner attempts to use the service name sasobjspawn as the service. If sasobjspawn has already been used, the spawner removes this service definition from its list. Note: If the server has Java clients, specify a port instead of a service. |
Software Version
In SAS Management Console:
Options Software Version |
Required |
COM/DCOM, IOM Bridge |
Specifies the version of the server software. |
Start Size
In SAS Management Console:
Options Advanced Options Load Balancing Properties Start Size |
Optional |
IOM Bridge |
For SAS Stored Process Servers, the number of MultiBridge connections to start when the spawner starts. |
Startup Cost
In SAS Management Console:
Options Advanced Options Load Balancing Properties Startup Cost |
Optional |
IOM Bridge |
For load-balancing servers using the cost algorithm, the cost for starting a server. |
Vendor
In SAS Management Console:
Options Vendor |
Required |
COM/DCOM, IOM Bridge |
Specifies the vendor of the server software. |
