Reclaim Objects by Owner (RCLOBJOWN)

The Reclaim Objects by Owner (RCLOBJOWN) command checks the objects owned by a user profile to make sure those objects which must be in a library are actually in one. If any of the owned objects are not in a library, they are inserted in one. If the object can only be in a specific system library, the object is inserted in that library. If the object can exist in any user library and is reclaimed from the system auxiliary storage pool (ASP 1) or a basic user ASP (ASPs 2-32), the object is inserted in library QRCL. If the object is reclaimed from a primary or secondary ASP, the object is inserted in library QRCLnnnnn where nnnnn is the number assigned by the operating system to the primary ASP.

When a user profile is deleted and the profile owns objects which are not in a library, message CPC2216 is sent after the user profile is deleted stating that the ownership for the objects was changed and that a reclaim operation, either RCLOBJOWN or RCLSTG, is necessary to place the objects in a library. Since RCLSTG can be a long-running command, you can try running RCLOBJOWN which is much faster because it only checks the objects owned by the specified user profile. If RCLOBJOWN is unable to reclaim the objects, you will need to run the RCLSTG command to reclaim the objects.

When a user profile is deleted because it is damaged, the objects owned by the user profile are left with no owner. In this case, you need to run the RCLSTG command to assign those objects to the QDFTOWN user profile. After running RCLSTG, you can use the Change Object Owner (CHGOBJOWN) command to change the ownership of objects assigned to QDFTOWN by the RCLSTG command.

If RCLOBJOWN is run against a user profile which has objects residing in an Independent Auxiliary Storage Pool (IASP), this IASP must be in AVAILABLE status, in order that the objects are reclaimed.

Note: The RCLOBJOWN command performs only a subset of the functions performed by the Reclaim Storage (RCLSTG) command. Refer to the RCLSTG command information for other reclaim commands that can be used to perform specific parts of the RCLSTG function.

Restrictions:

• This command is shipped with public *EXCLUDE authority.
• All subsystems must be inactive before the RCLOBJOWN command can be specified. The End System (ENDSYS) or End Subsystem (ENDSBS) command with *ALL specified on the SBS parameter can be used to make the subsystems inactive. You must have job control (*JOBCTL) authority to use the ENDSYS or the ENDSBS command.
• This command will not reclaim document (*DOC) objects or the folder (*FLR) objects where documents reside. It also will not reclaim directory (*DIR) objects, or the following types of objects which reside in directories:
  • stream file (*STMF)
  • symbolic link (*SYMLNK)
  • FIFO queue (*FIFO)
  • block special file (*BLKSF)
  • socket (*SOCKET)

Parameters

User profile (USRPRF)

Specifies the user profile for which the reclaim will be performed.

simple-name

Specify the name of the user profile to be processed.

Examples

Example 1: Reclaim Objects for a User Profile

RCLOBJOWN   USRPRF(MYPROFILE)

This command will check all objects owned by MYPROFILE. If there are objects that are not in a library, they will be placed in a system library. A message is sent for each object inserted into a system library by the reclaim operation.

Error messages

*ESCAPE Messages

CPF8204

Commitment control cannot be active during RCLSTG or RCLOBJOWN.

CPF8208

System not in proper state to reclaim objects by owner.

CPF8213

Object &1 cannot be inserted in &2 library.

CPF8215

User profile &1 damaged.

CPF8220

Library &1 damaged. Reclaim Objects by Owner (RCLOBJOWN) command ended.

CPF8232

Commitment definitions prevent RCLSTG or RCLOBJOWN.

CPF8282

User profile &1 not found.