SAS 9.1.3 Integration Technologies » Server Administrator's Guide


Setting up a COM/DCOM Connection
Server and Client Requirements
Summary of Setup Steps
Planning Your Server Configuration Metadata
Standard Server Metadata
Creating Metadata Using SAS Management Console
Defining Servers
Modifying Servers
Custom Workspace Servers
OLAP Servers
Enabling DCOM on the Server and the Client
Configuring SAS for DCOM
Setting SAS Permissions on the Server
Default on Windows NT/2000
Per Application on Windows NT/2000
Default on Windows XP  Server 2003
Per Application on Windows XP / Server 2003
Configuring DCOM on Windows XP SP2 / Server 2003 SP1
Configuring COM/DCOM for Active Server Page Access
Accessing a Local COM IOM Server from an Active Server Page
Accessing a Remote DCOM IOM Server from an Active Server Page
Administering the Server:
Creating a Metadata Configuration File in SAS
Using ITConfig
Troubleshooting
Reference Materials
AppIDs for Configuring DCOM
Object Server Parameters
Fields for the Server Definition
COM/DCOM

Fields for the Server Definition

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:

  • the name that identifies the field in SAS Management Console. Under each field name, the table shows the corresponding properties tab and field name in the SAS Management Console application.

  • "Required" or "Optional" to indicate whether the field is required.

  • the type of server configuration (COM/DCOM or IOM Bridge) for which the field is used.

  • a definition of the field.

For step-by-step instructions about defining the metadata for a server connection, refer to Using SAS Management Console to Define Servers.

Fields for the Server Definition
Field Name Required
Optional
Server Type Definition
Availability Timeout

In SAS Management Console:
Options  arrow  Advanced Options  arrow  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  arrow  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  arrow  Description
Optional COM/DCOM, IOM Bridge Text to summarize why this definition exists.
Authentication Domain

In SAS Management Console:
<Connection>  arrow  Options arrow  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>  arrow  Options arrow  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  arrow  Advanced Options  arrow  Load Balancing Properties arrow  Inactivity Timeout

and

Options  arrow  Advanced Options  arrow  Pooling Properties arrow  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  arrow  Advanced Options  arrow  Credentials arrow  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  arrow  Major Version Number 
Required COM/DCOM, IOM Bridge Specifies the major version number of the component.
Minor Version Number

In SAS Management Console:
Options  arrow  Minor Version Number 
Required COM/DCOM, IOM Bridge Specifies the minor version number of the component.
Maximum Clients

In SAS Management Console:
Options  arrow  Advanced Options  arrow  Load Balancing Properties arrow  Maximum Clients

and

Options  arrow  Advanced Options  arrow  Pooling Properties arrow  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  arrow  Advanced Options  arrow  Load Balancing Properties  arrow  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  arrow  Name
Required COM/DCOM, IOM Bridge The unique name for this server.
Object Server Parameters

In SAS Management Console:
Options  arrow  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>  arrow  Options arrow  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>  arrow  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  arrow  Advanced Options  arrow  Load Balancing Properties  arrow  Recycle Activation Limit

and

Options  arrow  Advanced Options  arrow  Pooling Properties arrow  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>  arrow  Options  arrow  Advanced Options arrow  Encryption  arrow  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>  arrow  Options arrow  Advanced Options  arrow  Encryption  arrow  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> arrow  Options arrow  Advanced Options arrow  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  arrow  Software Version 
Required COM/DCOM, IOM Bridge Specifies the version of the server software.
Start Size

In SAS Management Console:
Options  arrow  Advanced Options  arrow  Load Balancing Properties  arrow  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  arrow  Advanced Options  arrow  Load Balancing Properties  arrow  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  arrow  Vendor 
Required COM/DCOM, IOM Bridge Specifies the vendor of the server software.