The PURGE statement can be used to remove dead space from public volumes and to delete catalog entries from the system catalog. It can also be used to remove unused space in individual files.
Format
PURGE |
SPACE , { PUBLIC [,{ CATID = cat-id / VSID = vsid / vsn } ] PRIVATE[,vsn[,type]] } [,USER = userid] ALLOCATION,vsn CATALOG [,CATID = catid] ,ENTRY = filename / (filename,JV) |
Operands
SPACE
Releases unused space in the individual user files.
The assigned buffer sizes are taken into account, i.e. only as much space is released as will enable the file in question to be processed without errors. This function is available to all users. However, in this case only files of the user's own ID are taken into consideration.Password-protected files are not affected. In the event of an unused area of a file being the reserved area of this file, 1 allocation unit remains for the file.
PUBLIC
Releases unused space on public volumes. This function is only performed on imported pubsets.
CATID = catid
Specifies the catalog ID of an SF pubset or an SM pubset from which entries are to be deleted.
If neither VSN nor CATID is specified, the default catalog ID of the user ID specified via USER= is assumed.
VSID = vsid
Represents the ID of a volume set.
This operand is reserved for system administration.
vsn
Specifies the VSN of a particular public volume on which unused space is to be released.
PRIVATE
Releases unused space on private volumes. Non-privileged users can only process files under their own user ID and which also have an entry in the system catalog.
vsn[,type]
Specifies the disk on which space is to be released. Non-privileged users must specify both the VSN and the disk type “type”. When working under TSOS, however, it is sufficient to enter the VSN provided the disk is online.
USER = userid
Specifies the user ID whose files are to be processed. If no entry is made and SPCCNTRL is running under the TSOS user ID, the files of all users except TSOS are processed.
PURGE SPACE,PUBLIC checks all files of the default pubset of the caller ID for space that can be released if no parameter is specified under an ID that is not from TSOS.PURGE SPACE,PRIVATE processes the files of all users (including TSOS) if USER is not specified and SPCCNTRL is running under TSOS.
ALLOCATION
This operand is reserved for system administration.
It reorganizes the allocation of space on a public volume, i.e. dead space is to be removed. This does not happen in the same SPCCNTRL run, however; instead, the run has to be terminated and /IMPORT-PUBSET has to be entered first.
Dead space may have been created by system errors or explicitly created by means of the statement: PURGE CATALOG,ENTRY.
vsn
Specifies the volume serial number of a public volume to be cleaned up.
CATALOG
This operand is reserved for system administration.
It removes an entry from the system catalog. This is useful in the case of errored entries which can no longer be accessed.
CATID = catid
Specifies the catalog from which an entry is to be deleted. If this operand is omitted, the home catalog is assumed.
ENTRY = filename
Specifies the name of the file whose catalog entry is to be deleted.
ENTRY = (filename,JV)
Specifies the name of the job variable whose catalog entry is to be deleted.
Example
Output fom PURGE SPACE,PUBLIC
PURGE S,PUBLIC % SPC0025 PURGE PROCESSING COMPLETED NUMBER OF FILES SELECTED FOR PURGE: 1062 --------------------------- 1. NUMBER OF ERRORS DURING DEALLOCATION: 121 --------------------------- 2. AMOUNTED OF PAM PAGES DEALLOCATED: 20787 --------------------------- 3.
Number of files found to contain purgeable memory.
Number of files which could not be purged.
Total number of PAM pages released by the purge.