Reference: Configuration Files for SAS Servers :: SAS(R) 9.3 Intelligence Platform: System Administration Guide, Second Edition

Introduction to the Configuration File Reference

This section provides tables that show the name, location, and purpose of the various server configuration files that are used in the SAS Intelligence Platform. Each table in this appendix contains the following columns:

Order of Precedence

The numbers in this column indicate the order in which the options in the files are applied. Option settings in files with higher orders of precedence override the settings in files with lower orders of precedence.

“Not applicable” means that the option settings in the file do not affect, and are not affected by, option settings that are specified in other files.

Path and Filename

All paths that begin with Lev1 are located in the SAS configuration directory. See About the Configuration Directory. Within the pathnames, the following variables are used:

server-context, which indicates the name of an application server grouping (for example, SASApp, SASMeta, or SASMain)
server-name, which indicates the name of the logical server or server that the configuration file applies to

Purpose

This column describes the purpose of the configuration file, indicates that certain configuration files are not to be modified by users, and provides references to detailed documentation.

Configuration Files for the Metadata Server

The following table shows the configuration files that affect the metadata server. For an explanation of each columns' contents, see Introduction to the Configuration File Reference.

Configuration Files for the SAS Metadata Server

Order of Precedence	Path and Filename	Purpose
1	Windows: `\Lev1\SASMeta\MetadataServer\sasv9.cfg` UNIX and z/OS: `/Lev1/SASMeta/MetadataServer/sasv9.cfg`	Specifies server start-up options for the metadata server and contains calls to the other files that are listed in the table. Do not modify this file. If you need to make changes, modify the sasv9_usermods.cfg file that is in the same directory.
2	Windows: `SAS-install-directory\SASFoundation\9.3\sasv9.cfg` UNIX: `SAS-install-directory/SAS-install-directory/SASFoundation/9.3/sasv9.cfg` z/OS: Not applicable	Specifies system options that apply to all SAS sessions on the host machine. On UNIX systems, do not modify this file. If you need to make changes, modify the sasv9_local.cfg file that is in the same directory.
3	UNIX only: `SAS-install-directory/SASFoundation/9.3/sasv9_local.cfg`	On UNIX systems, contains site-specific modifications to the sasv9.cfg file that is in the same directory.
4	Windows: `SAS-install-directory\SASFoundation\9.3\locale\sasv9.cfg` UNIX: `SAS-install-directory/SASFoundation/9.3/locale/sasv9.cfg` z/OS: `<HLQ>.V93D8ddd.CNTLDSN(BATlocaleW0)`	Specifies system options that apply to all SAS sessions on the host machine in the specified locale.
5	Windows: `\Lev1\SASMeta\MetadataServer\sasv9_usermods.cfg` UNIX and z/OS: `/Lev1/SASMeta/MetadataServer/sasv9_usermods.cfg`	Contains site-specific modifications to the metadata server start-up options. Use this file to change the options that are specified in the sasv9.cfg file in the same directory. See Options for the Metadata Server Invocation Command.
Not applicable	Windows: `\Lev1\SASMeta\MetadataServer\omaconfig.xml` UNIX and z/OS: `/Lev1/SASMeta/MetadataServer/omaconfig.xml`	Specifies options for the metadata server and metadata repositories. See Reference Information for omaconfig.xml.
Not applicable	Windows: `\Lev1\SASMeta\MetadataServer\logconfig.xml` UNIX and z/OS: `/Lev1/SASMeta/MetadataServer/logconfig.xml`	Specifies the logging configuration for the server. See Administering Logging for SAS Servers.
Not applicable	Windows: `\Lev1\SASMeta\MetadataServer\adminUsers.txt` UNIX and z/OS: `/Lev1/SASMeta/MetadataServer/adminUsers.txt`	Defines your system's initial unrestricted user. See Metadata Server: Unrestricted Role.
Not applicable	Windows: `\Lev1\SASMeta\MetadataServer\trustedUsers.txt` UNIX and z/OS: `/Lev1/SASMeta/MetadataServer/trustedUsers.txt`	Conveys privileged status to a service account to enable that account to act on behalf of other users. See About the Initial User Accounts.
Not applicable	Windows: `\Lev1\SASMeta\MetadataServer\trustedPeers.xml` UNIX and z/OS: `/Lev1/SASMeta/MetadataServer/trustedPeers.xml`	Can be used to limit the scope of trust for connections from SAS sessions to the metadata server. Initially, the scope is not limited. See the SAS Intelligence Platform: Security Administration Guide.
Not applicable	Windows: Not applicable UNIX and z/OS: `/Lev1/SASMeta/MetadataServer/MetadataServer.srv`	On UNIX and z/OS, contains information that is used by generate_boot_scripts.sh to regenerate the sas.servers script.

In z/OS environments, the following additional configuration files affect the metadata server:

Additional Configuration Files for the SAS Metadata Server on z/OS Systems

Order of Precedence	Path and Filename	Purpose
1	z/OS: `<HLQ>.TKMVSENV(TKMVSENV)`	Contains name/value pairs (environment variables) that apply to all SAS sessions on the machine.
2	z/OS: `/Lev1/SASMeta/MetadataServer/tkmvsenv.cfg`	Contains name/value pairs (environment variables) that apply to the metadata server. Do not modify this file. If you need to make changes, modify the tkmvsenv_usermods.cfg file that is in the same directory.
3	z/OS: `/Lev1/SASMeta/MetadataServer/tkmvsenv_usermods.cfg`	Contains site-specific modifications to the name/value pairs (environment variables) for the metadata server. Use this file to change the options that are specified in the tkmvsenv.cfg file in the same directory. See the Configuration Guide: SAS 9.3 Foundation for z/OS.

Configuration Files for Components of SAS Application Servers

The following table shows the configuration files that affect servers that are components of a SAS Application Server. These servers include OLAP servers, workspace servers, pooled workspace servers, stored process servers, and SAS/CONNECT servers. For an explanation of each columns' contents, see Introduction to the Configuration File Reference.

Configuration Files for Components of SAS Application Servers (OLAP Servers, Workspace Servers, Stored Process Servers, and SAS/CONNECT Servers)

Order of Precedence	Path and Filename	Purpose
1	Windows: `\Lev1\server-context\server-name\sasv9.cfg` UNIX and z/OS: `/Lev1/server-context/server-name/sasv9.cfg`	Specifies start-up options for the server and contains calls to the other files that are listed in this table. Do not modify this file. If you need to make changes, modify the sasv9_usermods.cfg file that is in the same directory.
2	Windows: `\Lev1\server-context\sasv9.cfg` UNIX and z/OS: `/Lev1/server-context/sasv9.cfg`	Specifies start-up options that apply to all components of the application server. Do not modify this file. If you need to make changes, modify the sasv9_usermods.cfg file that is in the same directory. See Overview of System Options for SAS Application Server Components in SAS Intelligence Platform: Application Server Administration Guide.
3	Windows: `SAS-install-directory\SASFoundation\9.3\sasv9.cfg` UNIX: `SAS-install-directory/SASFoundation/9.3/sasv9.cfg` z/OS: Not applicable	Specifies system options that apply to all SAS sessions on the host machine. On UNIX systems, do not modify this file. If you need to make changes, modify the sasv9_local.cfg file that is in the same directory.
4	UNIX only: `SAS-install-directory/SASFoundation/9.3/sasv9_local.cfg`	On UNIX systems, contains site-specific modifications to the sasv9.cfg file that is in the same directory.
5	Windows: `SAS-install-directory\SASFoundation\9.3\locale\sasv9.cfg` UNIX: `SAS-install-directory/SASFoundation/9.3/locale/sasv9.cfg` z/OS: `<HLQ>.V93D8ddd.CNTLDSN(BATlocaleW0)`	Specifies system options that apply to all SAS sessions on the host machine in the specified locale.
6	Windows: `\Lev1\server-context\sasv9_usermods.cfg` UNIX and z/OS: `/Lev1/server-context/sasv9_usermods.cfg`	Contains site-specific modifications to the server start-up options that apply to all application server components. Use this file to change the options that are specified in the sasv9.cfg file in the same directory. See Overview of System Options for SAS Application Server Components in SAS Intelligence Platform: Application Server Administration Guide.
7	Windows: `\Lev1\server-context\appserver_autoexec.sas` UNIX and z/OS: `/Lev1/server-context/appserver_autoexec.sas`	Contains SAS statements that are executed immediately after SAS initializes on all components of the application server. Do not modify this file. If you need to make changes, modify the appserver_autoexec_usermods.sas file that is in the same directory.
8	Windows: `\Lev1\server-context\appserver_autoexec_usermods.sas` UNIX and z/OS: `/Lev1/server-context/appserver_autoexec_usermods.sas`	Contains site-specific modifications to the appserver_autoexec.sas file that is located in the same directory.
9	Windows: `\Lev1\server-context\server-name\sasv9_usermods.cfg` UNIX and z/OS: `/Lev1/server-context/server-name/sasv9_usermods.cfg`	Contains site-specific modifications to the server's start-up options. Use this file to change the options that are specified in the sasv9.cfg file in the same directory. See Overview of System Options for SAS Application Server Components in SAS Intelligence Platform: Application Server Administration Guide.
10	Windows: `\Lev1\server-context\server-name\autoexec.sas` UNIX and z/OS: `/Lev1/server-context/server-name/autoexec.sas`	Contains SAS statements that are executed immediately after SAS initializes on the server. Do not modify this file. If you need to make changes, modify the autoexec_usermods.sas file that is in the same directory.
11	Windows: `\Lev1\server-context\server-name\autoexec_usermods.sas` UNIX and z/OS: `/Lev1/server-context/server-name/autoexec_usermods.sas`	Contains site-specific modifications to the autoexec.sas file that is located in the same directory.
Not applicable	Windows: UNIX and z/OS: `/Lev1/server-context/server-name/logconfig.xml`	Specifies the logging configuration for the server. See Administering Logging for SAS Servers.
Not applicable	Windows: `\Lev1\sasv9_meta.cfg` UNIX and z/OS: `/Lev1/sasv9_meta.cfg`	Specifies metadata server connection information for the SAS OLAP Server and SAS/SHARE server.
Not applicable	Windows: Not applicable UNIX and z/OS: `/Lev1/server-context/server-name/server-name.srv`	On UNIX and z/OS, contains information that is used by generate_boot_scripts.sh to regenerate the sas.servers script.

In z/OS environments, the following additional configuration files affect components of a SAS Application Server:

Additional Configuration Files for Components of SAS Application Servers (OLAP Servers, Workspace Servers, Stored Process Servers, and SAS/CONNECT Servers) on z/OS Systems

Order of Precedence	Path and Filename	Purpose
1	z/OS: `<HLQ>.TKMVSENV(TKMVSENV)`	Contains name/value pairs (environment variables) that apply to all SAS sessions on the machine.
2	z/OS: `/Lev1/server-context/server-name/tkmvsenv.cfg`	Contains name/value pairs (environment variables) that apply to this server. Do not modify this file. If you need to make changes, modify the tkmvsenv_usermods.cfg file that is in the same directory.
3	z/OS: `/Lev1/server-context/tkmvsenv.cfg`	Contains name/value pairs (environment variables) that apply to all components of the application server. Do not modify this file. If you need to make changes, modify the tkmvsenv_usermods.cfg file that is in the same directory.
4	z/OS: `/Lev1/server-context/tkmvsenv_usermods.cfg`	Contains site-specific name/value pairs (environment variables) that apply to all application server components. Use this file to change the options that are specified in the tkmvsenv.cfg file in the same directory. See the Configuration Guide: SAS 9.3 Foundation for z/OS.
5	z/OS: `/Lev1/server-context/server-name/tkmvsenv_usermods.cfg`	Contains site-specific modifications to the server's name/value pairs (environment variables). Use this file to change the options that are specified in the tkmvsenv.cfg file in the same directory. See the Configuration Guide: SAS 9.3 Foundation for z/OS.

Configuration Files for SAS/SHARE Servers

The following table shows the configuration files that affect SAS/SHARE servers. For an explanation of each columns' contents, see Introduction to the Configuration File Reference.

Configuration Files for SAS/SHARE Servers

Order of Precedence	Path and Filename	Purpose
1	Windows: `\Lev1\ShareServer\sasv9.cfg` UNIX and z/OS: `/Lev1/ShareServer/sasv9.cfg`	Specifies start-up options for the server and contains calls to the other files that are listed in this table. Do not modify this file. If you need to make changes, modify the sasv9_usermods.cfg file that is in the same directory.
2	Windows: `SAS-install-directory\SASFoundation\9.3\sasv9.cfg` UNIX: `SAS-install-directory/SASFoundation/9.3/sasv9.cfg` z/OS: Not applicable	Specifies system options that apply to all SAS sessions on the host machine. On UNIX systems, do not modify this file. If you need to make changes, modify the sasv9_local.cfg file that is in the same directory.
3	UNIX only: `SAS-install-directory/SASFoundation/9.3/sasv9_local.cfg`	On UNIX systems, contains site-specific modifications to the sasv9.cfg file that is in the same directory.
4	Windows: `SAS-install-directory\SASFoundation\9.3\locale\sasv9.cfg` UNIX: /SAS-install-directory/SASFoundation/9.3/locale/sasv9.cfg z/OS: `<HLQ>.V93D8ddd.CNTLDSN(BATlocaleW0)`	Specifies system options that apply to all SAS sessions on the host machine in the specified locale.
5	Windows: `\Lev1\ShareServer\sasv9_usermods.cfg` UNIX and z/OS: `/Lev1/ShareServer/sasv9_usermods.cfg`	Contains site-specific modifications to the server's start-up options. Use this file to change the options that are specified in the sasv9.cfg file in the same directory. See the SAS/SHARE User's Guide.
6	Windows: `\Lev1\ShareServer\autoexec.sas` UNIX and z/OS: `/Lev1/ShareServer/autoexec.sas`	Contains SAS statements that are executed immediately after SAS initializes on the server. Do not modify this file. If you need to make changes, modify the autoexec_usermods.sas file that is in the same directory.
7	Windows: `\Lev1\ShareServer\autoexec_usermods.sas` UNIX and z/OS: `/Lev1/ShareServer/autoexec_usermods.sas`	Contains site-specific modifications to the autoexec.sas file that is located in the same directory.
Not applicable	Windows: \Lev1\sasv9_meta.cfg UNIX and z/OS: `/Lev1/sasv9_meta.cfg`	Specifies metadata server connection information for the SAS OLAP Server and SAS/SHARE server.
Not applicable	Windows: `\Lev1\ShareServer\logconfig.xml` UNIX and z/OS: `/Lev1//logconfig.xml`	Specifies the logging configuration for the server. See Administering Logging for SAS Servers.
Not applicable	Windows: Not applicable UNIX and z/OS: `/Lev1/ShareServer.srv`	On UNIX and z/OS, contains information that is used by generate_boot_scripts.sh to regenerate the sas.servers script.

In z/OS environments, the following additional configuration files affect SAS/SHARE servers:

Additional Configuration Files for SAS/SHARE Servers

Order of Precedence	Path and Filename	Purpose
1	z/OS: `<HLQ>.TKMVSENV(TKMVSENV)`	Contains name/value pairs (environment variables) that apply to all SAS sessions on the machine.
2	z/OS: `/Lev1/ShareServer/tkmvsenv.cfg`	Contains name/value pairs (environment variables) for the server. Do not modify this file. If you need to make changes, modify the tkmvsenv_usermods.cfg file that is in the same directory.
3	z/OS: `/Lev1/ShareServer/tkmvsenv_usermods.cfg`	Contains site-specific modifications to the server's name/value pairs (environment variables). Use this file to change the options that are specified in the tkmvsenv.cfg file in the same directory. See the Configuration Guide: SAS 9.3 Foundation for z/OS.

Configuration Files for SAS Object Spawners and SAS/CONNECT Spawners

The following table shows the configuration files that affect SAS object spawners and SAS/CONNECT spawners. For an explanation of each columns' contents, see Introduction to the Configuration File Reference.

Configuration Files for the SAS Object Spawner

Order of Precedence	Path and Filename	Purpose
Not applicable	Windows: `\Lev1\spawner-name\metaConfig.xml` UNIX and z/OS: `/Lev1/spawner-name/metaConfig.xml`	Specifies metadata server connection information. The spawner must be stopped and restarted to pick up changes to this file.
Not applicable	Windows: `\Lev1\ConnectSpawner\ConnectSpawner.bat` UNIX: `/Lev1/ConnectSpawner/ConnectSpawner.sh` z/OS: Not applicable	Contains start-up options for the SAS/CONNECT spawner. See Communications Access Methods for SAS/CONNECT and SAS/SHARE.
1	Windows: `\Lev1\ObjectSpawner\`ObjectSpawner.bat UNIX: `/Lev1/ObjectSpawner/ObjectSpawner.sh` z/OS: Not applicable	Contains start-up options for the object spawner. See Spawner Invocation Options in SAS Intelligence Platform: Application Server Administration Guide.
2	Windows: `\Lev1\ObjectSpawner\`ObjectSpawner_usermods.bat UNIX: `/Lev1/ObjectSpawner/ObjectSpawner_usermods.sh` z/OS: Not applicable	Can be used to specify site-specific modifications to the spawner's start-up options. Sites that need to set JREOPTIONS on the spawner can uncomment parameters that are included in this file.
Not applicable	Windows: `\Lev1\spawner-name\logconfig.xml` UNIX and z/OS: `/Lev1/spawner-name/logconfig.xml`	Specifies the logging configuration for the spawner. See Administering Logging for SAS Servers.
Not applicable	Windows: Not applicable UNIX and z/OS: `/Lev1/server-or-spawner-name.srv`	On UNIX and z/OS, contains information that is used by generate_boot_scripts.sh to regenerate the sas.servers script.