Options for the Metadata Server Invocation Command

Recommended Parameters

The following parameters are recommended for the optimal operation of the SAS Metadata Server in all host environments. Not all of the parameters are required to start the server; however, they are included here because they are considered helpful to the operation of the server.

the pathname of the configuration file for Foundation SAS on the host machine.
the name of the file that contains user modifications to the invocation options.
the environment control parameters NOAUTOEXEC, NOTERMINAL, SASUSER, and RSASUSER:

NOAUTOEXEC

specifies not to process the SAS autoexec file, even if one exists. Processing of the file can result in unpredictable server behavior.

NOTERMINAL

specifies to run the server in batch mode.

SASUSER="library-specification"

specifies the SAS library that is to contain the server's Profile catalog. This library must be dedicated to the metadata server and is typically a directory named sasusrms or sasuser under the MetadataServer directory.

RSASUSER

limits access to the SASUSER library to read-only mode.
the journaling-related parameters EMAILSYS, EMAILHOST, EMAILPORT, and EMAILID:
EMAILSYS SMTP

specifies that an alert e-mail message is to be sent by the metadata server using the SMTP (Simple Mail Transfer Protocol) e-mail interface.

EMAILHOST server-network-address

specifies the network address of the enterprise's SMTP server (for example, mailhost.company.com).

EMAILPORT port-number

specifies the port number that is used by the SMPT server that you specified for the EMAILHOST option.

EMAILID "server-email-address"
specifies the e-mail address that is to appear in the From field for alert e-mail messages. The e-mail address can be entered in either of the following forms:
- "server-name<user-account@domain>"
- "<user-account@domain>"
Note: These e-mail parameters need to be specified only if metadata server journaling is enabled. In SAS 9.2, journaling is enabled by default. For more information, see Configuring Metadata Server Journaling.
the logging-related parameters LOGCONFIGLOC, PAGESIZE, and LINESIZE:

LOGCONFIGLOC=file-specification

specifies the name of the XML configuration file that is used to initialize the SAS logging facility for the server. file-specification must be a valid filename or a path and filename for your operating environment. If the path contains spaces, enclose file-specification in quotation marks.

PAGESIZE=value

specifies the number of lines that make up a page of SAS output. A setting of MAX is recommended to reduce the occurrence of SAS log page headings and carriage controls.

LINESIZE=value

specifies the line size of SAS output. A setting of MAX is recommended to reduce log entry wrap-around.
the security-related parameters NETENCRYPTALGORITHM and SSPI:

NETENCRYPTALGORITHM="algorithm1" | ("algorithm1", "algorithm2", ...)

set in conjunction with the CLIENTENCRYPTIONLEVEL OBJECTSERVERPARMS option, specifies the algorithm(s) to be used for encrypted client/server data transfers. If you specify more than one algorithm, enclose all the algorithm names in parentheses and use commas to separate them. If there are embedded blanks in an algorithm name, enclose each algorithm within quotation marks. Valid values are SASPROPRIETARY, RC2, RC4, DES, and TRIPLEDES. NETENCRALG is an alias for NETENCRYPTALGORITHM.

SSPI

specifies support for the Security Support Provider Interface for single sign on (SSO) connections to IOM servers.
OBJECTSERVER, to invoke an Integrated Object Model (IOM) server.

OBJECTSERVERPARMS, to pass IOM parameters to the server:

CLIENTENCRYPTIONLEVEL=NONE | CREDENTIALS | EVERYTHING

set in conjunction with the NETENCRYPTALGORITHM option, this option specifies the degree of encryption that the server uses when making outbound calls.

NONE	specifies that nothing is encrypted. Clients transmit user IDs and passwords as plain text.
CREDENTIALS	specifies that clients encrypt user IDs and passwords.
EVERYTHING	specifies that clients encrypt all client/server communications.

CEL is an alias for CLIENTENCRYPTIONLEVEL.

PROTOCOL=value

identifies the network protocol that is used to communicate with the server. The only valid value is bridge.

PORT=port-number

specifies the TCP port on which the metadata server will listen for requests and that clients will use to connect to the server. The port-number value must be a unique number between 0 and 64K.

CLASSFACTORY=factory-number

specifies the type of IOM server to instantiate. The value 0217E202-B560-11DB-AD91-001083FF6836 identifies a SAS Metadata Server.

TRUSTSASPEER=pathname

enables SAS peer sessions from IOM servers to connect as trusted peer sessions. If you specify a blank or empty file, any SAS peer session can connect as a trusted peer. If you specify a file that contains a list of trusted domains, SAS peer sessions are trusted only if they belong to a domain that is listed in your trusted peer file.

Note:

For details about the OBJECTSERVER option, the SSPI option, and the OBJECTSERVERPARMS option and its parameters, see System Options for Application Servers in the SAS Intelligence Platform: Application Server Administration Guide.
For details about the other options, see the SAS Language Reference: Dictionary.

Additional Windows Parameters

A Windows server also requires the following parameters:

The system administration parameter MEMSIZE=value: specifies the amount of memory to allocate to the metadata server process. We recommend a value that allows the operating system to set the memory limits on the server. This can be accomplished by setting a value of 0 (zero), MIN, or MAX.
The display parameter NOSPLASH: suppresses the display of SAS logo and copyright information when invoking the SAS session.
SASINITIALFOLDER: specifies the path to the server's working folder.

For more information, see the SAS Companion for Windows.

Additional UNIX Parameters

A UNIX server requires the following parameter in addition to those described in Recommended Parameters for All Host Environments:

The system administration parameter MEMSIZE=value: specifies the amount of memory to allocate to the metadata server process. We recommend a value that allows the operating system to set the memory limits on the server. This can be accomplished by setting a value of 0 (zero), MIN, or MAX.

For more information, see the SAS Companion for UNIX Environments.

Additional z/OS Parameters

A z/OS server requires the following parameters in addition to those described in Recommended Parameters for All Host Environments:

The file control parameter FILESYSTEM=HFS: specifies to run the server in a hierarchical file system.
The OBJECTSERVERPARMS parameter THREADSSTACKSIZE=1048576: specifies the stack size to give each thread.

For more information, see the SAS Companion for z/OS.

Top of Page