Reclaim Object Links (RCLLNK)

Where allowed to run: All environments (*ALL)
Threadsafe: Yes
Parameters
Examples
Error messages

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:

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.

For more information about integrated file system commands, see the Integrated file system information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

Restrictions:

Top


 

Parameters

Keyword Description Choices Notes
OBJ Object Path name Required, Positional 1
SUBTREE Directory subtree *DIR, *NONE, *ALL Optional, Positional 2
DMGOBJOPT Damaged object option Element list Optional
Element 1: Usable objects *KEEP, *DELETE
Element 2: Unusable objects *DELETE, *KEEP

Top

 

Object (OBJ)

Specifies the path name of the object to be reclaimed. The object must be in the "root" (/), QOpenSys, or a user-defined file system. The object path name can be either a simple name or a name that is qualified with the name of the directory in which the object is located. A pattern cannot be specified ('*' or '?'). If the path name is qualified, it must be enclosed in apostrophes.

RCLLNK will not follow symbolic links for the last component in the path name.

If the last component in the path name is a block special file (*BLKSF) then only the block special file object will be reclaimed, not the user-defined file system that it represents.

The last component name in the path name cannot be '.' (dot) or '..' (dot-dot).

The effective root directory must be the "root" (/). Refer to the i5/OS PASE chroot command in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for more information.

For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

Top

 

Directory subtree (SUBTREE)

Specifies whether or not to reclaim the objects within the subtree if the object specified by the Object (OBJ) parameter is a directory.

*DIR

The object specified by OBJ is reclaimed. If the object is a directory, its contents are reclaimed, but the contents of all of its subdirectories are not reclaimed.

*NONE

Only the object specified by OBJ is reclaimed.

*ALL

The object specified by OBJ is reclaimed. If the object is a directory, its contents, as well as the contents of all of its subdirectories, are reclaimed.

Top

 

Damaged object option (DMGOBJOPT)

Specifies how damaged objects are handled that are considered usable or unusable. If no operations can be performed on a damaged object it is considered unusable. Otherwise, it is considered usable.

Deleting a usable damaged directory object will cause all its contents and the contents of all its subdirectories to become lost. These lost objects will need to be restored from media or can be recovered via a RCLSTG. The contents of an unusable damaged directory object are already lost.

The following considerations apply:

Element 1: Usable objects

*KEEP

Usable damaged objects are not deleted.

*DELETE

Usable damaged objects are deleted, if possible.

Element 2: Unusable objects

*DELETE

Unusable damaged objects are deleted, if possible.

*KEEP

Unusable damaged objects are not deleted.

Top


 

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.

Top


 

Error messages

*ESCAPE Messages

CPF8206

Directory conversion cannot be active during RCLSTG or RCLLNK.

CPFA085

Home directory not found for user &1.

CPFA089

Pattern not allowed in path name.

CPFA0A2

Information passed to this operation was not valid.

CPFA0A7

Path name too long.

CPFA0A9

Object not found. Object is &1.

CPFA0B1

Requested operation not allowed. Access problem.

CPFA0DF

Error reclaiming objects in directories.

CPFA0F1

&1 of &2 object links reclaimed with &3 of &4 problems corrected.

Top