SAS 9.1 Companion For Unix Enivronments
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.
| 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
or
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. |
See Also
-
"Work Data Library" on page 120
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.