The Delete Old Spool Files (DLTOLDSPLF) command deletes spool files in one or more output queues based upon a user-specified number of retain days. Only spool files with a status of RDY, CLO, HLD or SAV are considered. The user can specify that spool files be moved to another output queue rather than deleted. This provides the user the opportunity to review the spool files and then manually delete them.

Different retain days can be specified for QPJOBLOG and QPSRVDMP spool files.

A report is produced to spool file SPLFILES that describes each output queue processed by this command, the number of spooled files found in the output queue, and the number of spooled files that were deleted or moved. By-passed output queues are also indicated on the report.

Required Parameters

OUTQ

Specify the output queue from which spool files will be deleted or moved. The possible library values are:

*LIBL: The library list is used to locate the output queue.

library-name: Specify the name of the library where the output queue is located.

The possible output queue values are:

*ALL: All output queues on the system are to be checked. In order to use the *ALL value for the output queue, the user must have *ALLOBJ and *JOBCTL special authority.

output-queue-name: Specify the name of the output queue to be checked. The user must be authorized to the output queue. If he isn't the owner, he must have *JOBCTL special authority.

Optional Parameters

RETAINDAYS

Specify the number of days that a spool file is to be retained. If the spool file has been on the system longer than the number of days specified, it is considered eligible for deletion or to be moved.

14: Spool files are to be retained for 14 days.

retention-days: Specify the number of days, from 0 to 999, that spool files are to be retained. Specifying 0 means that spool files created on the current date are eligible for deletion.

QPJOBLOG

Specify the number of days that QPJOBLOG spool files are to be retained.

*RETAINDAYS: The value specified for the RETAINDAYS parameter is used.

retention-days: Specify the number of days, from 0 to 999, that spool files are to be retained. Specifying 0 means that QPJOBLOG spool files created on the current date are eligible for deletion.

QPSRVDMP

Specify the number of days that QPSRVDMP spool files are to be retained.

*RETAINDAYS: The value specified for the RETAINDAYS parameter is used.

retention-days: Specify the number of days, from 0 to 999, that spool files are to be retained. Specifying 0 means that QPSRVDMP spool files created on the current date are eligible for deletion.

MOVTOOUTQ

Optionally, the selected spool files can be moved to an output queue. Use this parameter to specify whether or not the spool files should be deleted and to specify the qualified name of an output queue that spool files are to be moved to, if the files are not to be deleted. The output queue must exist before the command is executed. The possible library values are:

*LIBL: The library list is used to locate the output queue.

library-name: Specify the name of the library where the output queue is located.

The possible output queue values are:

*NONE: Spool files are to be deleted, not moved.

output-queue-name: Specify the name of the output queue where spool files are to be moved. If an output queue name is specified, existing spool files in that output queue are ignored by this command.

LIST

Specify the name and library of one or more output queues to be bypassed. You can specify up to 90 output queues. This parameter is used only when OUTQ(*ALL) is specified.

output-queue-name: Specify the name of the output queue to bypass.

library-name: Specify the name of the library where the output queue is located.

Example

DLTOLDSPLF OUTQ(*ALL) +

RETAINDAYS(7) +

LIST((MYOUTQ MYLIB))

This command deletes spool files from all output queues, except output queue MYOUTQ located in library MYLIB, if the spool files are more than seven days old.

Source Members

INFO: DLTOLDSPLF (QATTINFO)

CDO: TAASPLL (QATTCMD)

CPP: TAASPLLC (QATTCL)

Prerequisites

The following QUSRTOOL tools must reside on your system prior to creating DLTOLDSPLF.

ADDDAT

CVTALLOUTQ

CVTOUTQ

EDTVAR

EXTLST

The foregoing article was adapted from Midrange Computing's QUSRTOOL Command Reference. The manual contains explanations and syntax diagrams for more than 250 obscure yet useful tools.

The Delete Old Spool Files (DLTOLDSPLF) Command

UNABLE TO REPRODUCE GRAPHIC