RCLSPLSTG (Reclaim Spool Storage)

RCLSPLSTG Command syntax diagram

 

Purpose

The Reclaim Spool Storage (RCLSPLSTG) command reclaims unused storage for spooled files that have not been used for more than the number of days specified by the user. Spooled files are stored with database file members on the system. When a spooled file is deleted, the member is emptied but not deleted. Therefore, the member can be reused for the next spool file created. Reusing empty members improves the performance time when creating new spooled files. The RCLSPLSTG command deletes unused and empty database members. This command uses synchronous processing. More information about synchronous processing is in the Backup and recovery topic in the Information Center.

Restriction: This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.

 

Required Parameters

DAYS
Specifies that storage for spooled files that have not been used for the number of days specified by the user is reclaimed.

*NONE: All unused storage for spooled files is reclaimed. If there is no unused storage when subsequent spooled files are created, then the system allocates storage for those spooled files. The allocation of storage for these spooled files may slow down the jobs that are creating them. More information is in the File Management topic in the Information Center.

days-to-keep-unused-storage: Specify the number of days to keep unused storage for spooled files. Storage that remains unused for more than the number of specified days is reclaimed.

Example for RCLSPLSTG

RCLSPLSTG  DAYS(30)

This command reclaims all unused storage for spooled files that have remained unused for more than 30 days. When storage has been unused for 1 second over 30 days it is reclaimed because a date and time stamp is placed on the storage area.

Error messages for RCLSPLSTG

None