Utilities in the bin Directory

Utilities in the /bin Directory

The following table briefly describes some of the tools in the utilities/bin directory. You can also use the man command for information on these utilities. You will need ROOT permissions to execute these commands.

Table A2.1: Tools for the System Administrator
Tool Name	Function
cleanwork	deletes any leftover Work directories whose associated SAS process has terminated .
patchname	resets the name of the sasroot directory in the specified executable file.

Cleanwork Command

Deletes any leftover Work and Utility directories whose associated SAS process has ended

Syntax

cleanwork directory

directory

names the directory containing the Work and Utility directories. The name must match the value specified in the WORK system option (which is typically /usr/tmp and installed in the !SASROOT/sasv9.cfg file) or the value specified in the UTILLOC system option.

Note	Unless cleanwork is run by root, user permissions might prevent you from deleting a directory.

Details

The cleanwork command deletes any directories that were assigned to the Work data library or directories assigned by the UTILLOC system option. cleanwork deletes only the SAS jobs that are on the UNIX box that your SAS session is running on. Each SAS process is in the format

 SAS_  workcode_nodename

 SAS_  utilcode  _  nodename

code

is a 12-character code. The first four characters are randomly generated numbers . The next eight characters are based on the hexadecimal process ID of the SAS session. Processes that are active are not deleted.

nodename

specifies the name of the UNIX box where the SAS process is running.

If you are working on nodename jupiter , then the cleanwork command deletes all directories with inactive processes on jupiter . cleanwork does not delete a directory that is associated with an orphaned process if that process is still showing up as active. In this case, you need to manually kill the process and then rerun cleanwork .

Note	The cleanwork utility for Version 8 will work on Version 8 of SAS as well as prior versions of SAS.

Patchname Command

Resets the name of the !SASROOT directory in the specified executable file

Syntax

patchname filepath sasroot-directory-pathname

filepath

specifies the absolute pathname of the file in which to set the !SASROOT directory.

sasroot-directory-pathname

specifies the absolute pathname of the new !SASROOT directory.

Details

The patchname command resets the name of the !SASROOT directory in the specified executable file to the specified directory. When you install SAS, the installation program uses patchname to write the name of the !SASROOT directory to the file that needs this information: the executable file containing the sas command. If you change the !SASROOT directory, you must use patchname to alter this file.