RCLTMPSTG (Reclaim Temporary Storage)

RCLTMPSTG Command syntax diagram

 

Purpose

The Reclaim Temporary Storage (RCLTMPSTG) command removes the temporarily decompressed copies of panel groups, menus, display files, and printer files, thereby freeing up system storage space.

• Compressed Objects are objects that consume less storage space than decompressed objects. When a compressed object is used or a compressed program is called, a decompressed version of the object automatically becomes available to the user.
• Decompressed Objects are objects that use the system storage space allocated to them and are in a final, ready-to-use state.
• Temporarily Decompressed Objects are temporarily decompressed copies of compressed objects. The system allocates storage space for the decompressed objects, which is consumed by the temporary copies until the system or the user determines that the temporary storage space needs to be reclaimed.

  Temporary storage is automatically reclaimed when:

  • The RCLTMPSTG command is run
  • The next initial program load (IPL) is run
  • The object is used often enough to cause the system to permanently decompress it

  When an object is permanently decompressed, the compressed version of the object is destroyed as well as any temporary forms of the object; however, compressed versions remain intact as long as the objects are temporarily decompressed.

 

Restrictions

1. This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.
2. The user must have object management authority to the object specified and execute authority to the library.

 

Optional Parameters

LIB

Specifies the name of the library in which allocated storage space for temporarily decompressed objects is reclaimed.

*ALL: All libraries in the system, including QSYS, are searched.

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

*USRLIBL: Only the libraries in the user portion of the job's library list are searched.

*ALLUSR Libraries

library-name: Specify the name of the library to be searched.

DAYS

Specifies the number of days an object has not been used or changed. If a temporarily decompressed object has not been used or changed for more than the specified number of days, it is reclaimed. If it has been used or changed, it is left temporarily decompressed.

7: Objects that have not been used or changed for more than seven days are reclaimed.

*NONE: The storage space allocated for a temporarily decompressed object is reclaimed regardless of the number of days it has not been used or changed, unless the object is in use when this command is run.

number-of-days: Specify the number of days a temporarily decompressed object can be unused before the temporary space allocated for it is reclaimed. Valid values range from 1 through 366.

Example for RCLTMPSTG

RCLTMPSTG   LIB(QGPL)

This command reclaims the space consumed by all of the temporarily decompressed copies of objects in library QGPL that have not been used or changed in the last 7 days.

Error messages for RCLTMPSTG

*ESCAPE Messages

CPF2110

Library &1 not found.

CPF2113

Cannot allocate library &1.

CPF2176

Library &1 damaged.

CPF3B07

&1KB storage reclaimed, &5 objects not processed.

CPF9838

User profile storage limit exceeded.