Configuring the cleanwork Utility :: SAS(R) 9.3 Companion for z/OS, Second Edition

Syntax

cleanwork directory-1 <... directory-n>

How cleanwork Selects Directories for Deletion

The temporary directories that are created by SAS for the WORK library and utility files are named according to the following pattern:

SAS_util_<serial><pid>_<lpar>

<serial>

is a four-digit to six-digit hexadecimal serial number that is unique for any given SAS session.

<pid>

is the USS process ID number of the SAS session, represented as an eight-digit hexadecimal number.

<lpar>

is the name of the LPAR (logical partition) on which SAS session is running.

The cleanwork utility deletes any directories with a name that matches the preceding pattern, provided that both of the following conditions are true:

<lpar> matches the name of the LPAR on which the cleanwork utility is running.
No process with an ID of <pid> is currently active on the LPAR on which the cleanwork utility is running.

In other words, cleanwork removes only the directories that are not associated with an active SAS session. Because it can make that determination only on the current system, cleanwork can remove only the directories that were created by SAS sessions that ran on the same system on which cleanwork is currently running. If SAS sessions on multiple z/OS system images (LPARs) place temporary directories under the same directory location, you will need to run cleanwork on each system (LPAR).

Running cleanwork with a crontab

After the cleanwork utility has been installed, the cleanwork command can be executed as needed by a superuser or the owner of the directory. It is often useful to automatically execute the command at regular intervals with a crontab.