CL Command Reference - RCLLNK
CL Command List > RCLLNK Reference
Description:
The Reclaim Object Links (RCLLNK) command allows a single object or a group of objects to be reclaimed.
The RCLLNK command can be used to reclaim a directory tree where the directory, its contents, and the contents of all of its subdirectories are reclaimed. A subtree reclaim will attempt to reclaim as many objects as possible. A diagnostic message will be sent for each object that cannot be reclaimed. Additionally, an informational message will be sent if a specific problem is corrected, or a diagnostic message will be sent if a specific problem is unable to be corrected. If all of the objects have been reclaimed, with all of the problems corrected, then a completion message will be sent. Otherwise, an escape message will be sent.
The RCLLNK command does the following:
. Corrects object user profile problems
. Corrects user-defined file system problems
. Corrects internal object problems
. Removes invalid object links
. Handles damaged objects as specified on the Damaged object option (DMGOBJOPT) parameter
. Creates missing system objects
A full Reclaim Storage (RCLSTG) fixes the above problems, as well as others such as lost objects or problems which require the system to be in a restricted state. Unlike RCLSTG, the system does not have to be in a restricted state to run RCLLNK.
Restrictions:
. You must have all object (*ALLOBJ) special authority to run this command.
. Only objects found in the ¡åroot¡å (/), QOpenSys, or mounted user-defined file systems are eligible to be reclaimed. All other objects are ignored during a subtree reclaim.
. An independent auxilary storage pool (ASP) must have a status of ¡åAvailable¡å in order for objects residing on the independent ASP to be reclaimed.
. Storage freed objects are not reclaimed unless a storage freed object is specified on the Object (OBJ) parameter.
. Objects that are being saved or restored cannot be reclaimed.
. An object¡¯s last access, data change, and attribute change date and time values are not normally updated as a result of being reclaimed. However, if the object has a problem that is corrected, these values may be updated.
. Problems found in the contents of a damaged directory object are not corrected.
. The directory conversion function must not be active while RCLLNK runs. The Convert Directory (CVTDIR) command with OPTION(*CHECK) can be used to verify directory conversion is not active.
Examples:
Example 1: Reclaim Object Links for a Directory
RCLLNK OBJ(¡¯/MYOBJ¡¯) SUBTREE(*DIR)
The object MYOBJ will be reclaimed. If MYOBJ is a directory, all of the objects this directory contains will be reclaimed because *DIR is specified for the SUBTREE parameter.
Example 2: Reclaim Object Links for an Object
RCLLNK OBJ(¡¯/MYOBJ¡¯) SUBTREE(*NONE)
Only the object MYOBJ will be reclaimed because *NONE is specified for the SUBTREE parameter.
Example 3: Reclaim Object Links for a Directory Subtree
RCLLNK OBJ(¡¯/MYOBJ¡¯) SUBTREE(*ALL)
The object MYOBJ will be reclaimed. If MYOBJ is a directory, all of the objects this directory contains, as well as all of the objects contained in the subdirectories, will be reclaimed because *ALL is specified for the SUBTREE parameter.
Example 4: Reclaim Damaged Objects in a Directory Subtree
RCLLNK OBJ(¡¯/MYDIR¡¯) SUBTREE(*ALL) DMGOBJOPT(*KEEP *DELETE)
If the MYDIR directory is not damaged, keep all usable damaged objects and delete all unusable damaged objects found in the directory subtree of MYDIR. All other problems found are corrected, if necessary and possible.
Example 5: Search for All Damaged Objects in a Directory Subtree
RCLLNK OBJ(¡¯/MYOBJ¡¯) SUBTREE(*ALL) DMGOBJOPT(*KEEP *KEEP)
Check MYOBJ for damage. If MYOBJ is a directory, search for all damaged objects found in the directory subtree of MYOBJ. All other problems found are corrected, if necessary and possible.
Example 6: Delete All Damaged Objects in a Directory Subtree
RCLLNK OBJ(¡¯/MYOBJ¡¯) SUBTREE(*ALL) DMGOBJOPT(*DELETE *DELETE)
Delete MYOBJ if it is damaged. If MYOBJ is a directory that is not damaged, delete all damaged objects found in the directory subtree of MYOBJ. All other problems found are corrected, if necessary and possible.