Recommended Parameters

Recommended Parameters for All Host Environments

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 following parameters which are used for generating e-mail alerts for the metadata server:
    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 | server-user-id"
    specifies the e-mail address that is to appear in the From field for alert e-mail messages. By default, the SAS Deployment Wizard places the following value in this parameter: SASMeta - Metadata Server (Config - Lev1) <noreply@mailhost.fyi.sas.com>.
    If you want to specify a different e-mail address, use one of the following formats:
    • "server-name<user-account@domain>"
    • "<user-account@domain>"
    Note:
    • Some electronic mail systems do not allow semicolons or colons in the From field.
    • If your e-mail server requires user authentication, then this option specifies the user ID that is to be used for authentication when an e-mail alert is generated. See Optional Parameters.
    Tip
    If you modify any of the e-mail options, be sure to test metadata server e-mail alerts. See Testing E-mail Alerts for the SAS Metadata Server.
    Note:
  • 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 SAS Application Server Components in SAS Intelligence Platform: Application Server Administration Guide.
  • If you need to make any changes to the OBJECTSERVERPARMS option, make sure that the sasv9_usermods.cfg file contains the entire list of parameters that you want to specify for this option. (The list of object server parameters that you specify in sasv9_usermods.cfg overrides the list that is specified in sasv9.cfg.
  • For details about the other options, see the SAS System Options: Reference.

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.