It is sometimes necessary or desirable to set the UTILLOC system option for all servers (SAS® Metadata Server, SAS® Stored Process Server, SAS Workspace Server, and, so on) and processes (SAS Object Spawner) started under a particular SAS® Business Intelligence configuration directory (for example, Lev1). The UTILLOC system option determines where SAS® utility files will be written, and the default is for utility files to be written to the WORK library or to /tmp (depending on the server or process being used).
If the UTILLOC system option is specified in the sasv9_usermods.cfg file in the BI-configuration-directory/Lev1/SASApp/ directory, which should apply globally to all servers in the /Lev1/SASApp configuration, the option is ignored.
However, the UTILLOC system option can be specified in the individual application server sasv9_usermods.cfg files. Here are examples:
BI-configuration-directory/Lev1/SASMeta/MetadataServer/sasv9_usermods.cfg
BI-configuration-directory/Lev1/SASApp/StoredProcessServer/sasv9_usermods.cfg
BI-configuration-directory/Lev1/SASApp/PooledWorkspaceServer/sasv9_usermods.cfg
BI-configuration-directory/Lev1/SASApp/WorkspaceServer/sasv9_usermods.cfg
BI-configuration-directory/Lev1/SASApp/BatchServer/sasv9_usermods.cfg
BI-configuration-directory/Lev1/SASApp/ConnectServer/sasv9_usermods.cfg
Another way to globally set the UTILLOC for all SAS Business Intelligence application servers and processes under a particular configuration level is to edit the level_env_usermods.sh script in the BI-configuration-directory/Lev1/ directory and add statements similar to the following to set the TKOPT_ENV_UTILLOC environment variable.
TKOPT_ENV_UTILLOC=your/alternate/utilloc/path/goes/here export TKOPT_ENV_UTILLOC
Environment variables defined in the level_env_usermods.sh script apply to the SAS Metadata Server, SAS Object Spawner, SAS Workspace Server, SAS Pooled Workspace server, SAS Stored Process Server, and any other application server defined under the Lev1 configuration.
Note: You must restart the application server or process to enable the change.
To only change the TKOPT_ENV_UTILLOC environment variable for the SAS Object Spawner process, see SAS Note 40786, "Redirecting the SAS® Object Spawner utility file in UNIX environments."
For more information about the UTILLOC system option, see the SAS® 9.4 System Options: Reference, Fifth Edition.
Additional information about controlling the use of /tmp space can be found in SAS Note 35525, "Controlling the use of the /tmp directory space in SAS® 9.2 or later."
Operating System and Release Information
SAS System | Base SAS | z/OS | 9.2 TS2M0 | 9.2 TS2M3 |
64-bit Enabled AIX | 9.2 TS2M0 | 9.2 TS2M3 |
64-bit Enabled HP-UX | 9.2 TS2M0 | 9.2 TS2M3 |
64-bit Enabled Solaris | 9.2 TS2M0 | 9.2 TS2M3 |
HP-UX IPF | 9.2 TS2M0 | 9.2 TS2M3 |
Linux | 9.2 TS2M0 | 9.2 TS2M3 |
Linux for x64 | 9.2 TS2M0 | 9.2 TS2M3 |
OpenVMS on HP Integrity | 9.2 TS2M0 | 9.2 TS2M3 |
Solaris for x64 | 9.2 TS2M0 | 9.2 TS2M3 |
*
For software releases that are not yet generally available, the Fixed
Release is the software release in which the problem is planned to be
fixed.