Document Title Overview of RCLSTG Document Description This document provides a basic overview of RCLSTG.

RCLSTG should not be run unless there is a warranted reason for running the command. There is no way to estimate how long a RCLSTG will take. Considerations: o If possible, RCLSTG should be run based only upon necessity. It can be an extremely long running function and there is no way to estimate how long it will take to complete. o To run RCLSTG for SYSB S !that is the System and Basic S"s# the System must be in restricted state !ENDSBS * LL or ENDS!S#. To run RCLSTG for an S" group, there must be no one using the S". See the restricions before for information on how to check this. %eclaim Storage is invoked through the command RCLSTG. uthority is re&uired to the command which is shipped with public '()*+,-( authority. RCLSTG re&uires some disk storage for processing. $n systems with a lot of less fre&uently used database ob.ects, RCLSTG may re&uire a considerable amount of disk storage. This is because it opens each member which creates temporary runtime segments for each file and member. If possible, an I"+ is suggested .ust prior to running the command. *ommitment control must be inactive for the S" groups it is running in. RCLSTG touches every ob.ect in the S" group it is running in. RCLSTG can be ended !using system re&uest#. /owever, if a full RCLSTG is ended, the -ata Base *ross0%eference files for that S" group will re&uire corrective action such as a RCLSTG *DB"RE#. ,ltimately, it must run to completion. The RCLSTG command cannot be checkpointed. ll ob.ects useable before RCLSTG are useable after RCLSTG. RCLSTG does not run if critical libraries such as 1%(*$2(%Y, 1SYS, 1,S%SYS, 1-$*, and 1S"+ are missing, nor if profiles such as 1-BS/%, 1-BS/%-$, 1SYS, 1S(*$3%, 1-3T$45, 1S5 -S, 1-$*, 1S"+, 1-S5), and 16S3 are missing. -amaged profiles are deleted if they are not critical. If RCLSTG detects damaged user libraries, it will stop processing the command. To recover, the library must be deleted then restored from a previous good save. RCLSTG could then be run again. To correct database cross0reference files for an S" group in error, type the following7 RCLSTG *DB"RE# for that S" group. "ress the (nter key.

$ $

$ $ $ $

$ $ $

$ $ o

Note: $nce started, this step must run to completion. dedicated environment is also re&uired. o If database file ob.ects are damaged, the keyed access paths may need to be rebuilt. This operation can take a substantial amount of time. o Do not run t$e RCLSTG command for t$e followin%: 00 3or physical or logical damage !soft 8 partial damage#. 00 System power outages. 00 4hen unfamiliar messages are received. 00 ,ser profile deleted but ob.ects owned by profile not deleted. The RT&DS'(N# command corrects this situation by providing an owner for each of the ob.ects. 00 System ended abnormally several times since the last RCLSTG command was run. RCLSTG should not be necessary prior to an update unless there is a warranted reason for running it. 00 5ormal system maintenance. RCLSTG Command Options Select !S(+(*T# 0 Specifies the reclaim functions that are performed. %*+ST9 S(+(*T!' ++# 0 ll reclaim functions are performed. %*+ST9 S(+(*T!'-B)%(3# 0 The database cross0reference table reclaim function is performed. $mit !$6IT# 0 Specifies the reclaim functions to be omitted from the reclaim operation. %*+ST9 $6IT!'5$5(# 0 5o reclaim functions are omitted. %*+ST9 $6IT!'-B)%(3# 0 -atabase cross0reference table reclaim function is omitted. uxiliary storage pool device ! S"-(2# 0 Specifies the S" to be reclaimed. %*+ST9 S"-(2!'SYSB S# 0 The system S" and all basic S"s are reclaimed. The system S" has an S" number of :. Basic S"s have S" numbers of ; 0 <;. To do SYSB S, you have to be in restriced state. auxiliary0storage0pool0device0name 0 The specified S" device is reclaimed. Basic S" devices have S" numbers less than or e&ual to <;. Independant S"s have numbers greater than <;. %eclaim storage for an S" device can be run without being in restricted state. You can submit multiple .obs, each performing RCLSTG on a different S" device, to reclaim multiple S"

devices in parallel. If you do a %*+ST9 for one I S" that is part of an S" group, all I S"s in the S" group will be done at the same time. To do a %*+ST9 for an S" group, all I S"s in that group must have no one using them. See the restrictions for how to check this. o RCLSTG does t$e followin%: RCLSTG addresses each ob.ect and then validates the headers and pointers for that ob.ect. 3inds orphaned ob.ects. 3unction checks when hard damage is encountered. *orrects, where possible, ob.ects that were incompletely updated !such as database files, libraries, device descriptions, directories and stream files# and user profiles containing incorrectly recorded ob.ect ownership information. -eletes any unusable ob.ects or fragments. 3or incompletely updated ob.ects in SYSB S7 +ibrary based ob.ects go into 1%*+ library, I3S ob.ects go into 81%eclaim or 81$penSys81%eclaim directories. 3or incompletely updated ob.ects in "rimary or Secondary S"s7 +ibrary based ob.ects go into 1%*+ library in the "rimary I S", I3S ob.ects go into 81%eclaim or 81$penSys81%eclaim directories in the "rimary I S". RCLSTG reclaims all ob.ects secured by an authori=ation list that are damaged or destroyed and assigns the ob.ects to the authori=ation list 1%*+ ,T+. Restrictions: :. This command is shipped with public '()*+,-( authority and the 1"96%, 1SYS$"%, 1S%2, and 1S%2B S user profiles have private authorities to use the command. ;. If option 'SYSB S is specified on the S"-(2 parameter, all subsystems must be inactive before the RCLSTG command can be specified. The (nd System !ENDS!S# or (nd Subsystem !ENDSBS# command with ' ++ specified on the SBS parameter can be used to make the subsystems inactive. You must have .ob control !'>$B*T+# authority to use the ENDS!S or the ENDSBS command. <. $nly permanent ob.ects in auxiliary storage are reclaimed? temporary ob.ects are reclaimed by running a system initial program load !I"+#. @. Before running the RCLSTG command after an I"+, wait several minutes for the I"+ to complete. ,se the 4ork with ctive >obs ! )R' CT*OB# command to verify that no .obs are running.

A. If option 'SYSB S is specified on the S"-(2 parameter, this .ob must be in the controlling subsystem and must be the only .ob active in the system. B. %eclaiming an auxiliary storage pool ! S"# device re&uires that there are no active users of the S" device that is the sub.ect of the reclaim. You can check this for I S"s in $perations8iSeries 5avigator by going to 6y *onnections 0C *onfiguration and Service 0C /ardware 0C -isk ,nits 0C -isk "ools. Then right click on the -isk "ool that you are interested in and take the obtion for .obs. If the new window shows no .obs, then you can run a %*+ST9 on that I S". D. ll S"s in an S" group must be done at the same time. If you start a %*+ST9 for one, they will all be done. This means that there must be no locks on any of them. Considerations after Runnin% t$e RCLSTG Command o o o *heck for any messages in the history log, 1SYS$"% message &ueue, and the .ob log. *heck for any dumps. /andle any ob.ects inserted into library 1%*+7 This library is created and if no ob.ects are inserted into it, it is deleted. $b.ect description entries are not valid for ob.ect in 1%*+. Save 1%*+ if not able or sure how to handle the ob.ects. The data for files in 1%*+ should be copied to a new file. *ontact Support +ine if IB60supplied ob.ects are inserted in 1%*+ or if unsure how to handle any ob.ects in 1%*+. /andle any ob.ects whose ownership is transferred to 1-3T$457 0 6essage is generated for any external ob.ect transferred. 0 ,se the )R'OB*O)N command to show all ob.ects owned by 1-3T$45. 0 ,ser is responsible to determine the correct owner. 0 uthorities may need to be granted again ! GRTOB* +T#. 0 /andle ob.ects on damaged8destroyed authori=ation list. 0 -isplay ob.ects secured by 1%*+ ,T+ !DS, +TLOB*#. 0 6ove ob.ects to another authori=ation list !GRTOB* +T#. -eleted ob.ects include internal system ob.ects that show up in the count but do not have an external message. #actors T$at ffect ,erformance: 0 5umber of ob.ects. 0 Types of ob.ects. 0 mount of relational damage on system. 0 mount of auxiliary storage configured to the system. 0 "ercentage of auxiliary storage in use. 0 Si=e of some ob.ects.

o o

0 mount of main store on system !can have a very significant effect on RCLSTG command performance# O-.ect #unctions of RCLSTG: (nsures ob.ects owned by profile. (nsures ob.ects are in a library. (nsures ob.ects not secured by damaged8destroyed authori=ation list. (nsures complex ob.ects. -eletes ob.ects not completely created. "rocesses ob.ect storage counts in all user profiles. -eletes duplicate profiles. Incomplete or header damaged subsystem descriptions are deleted. Incomplete or header damaged save files are deleted. ,ser S" recovery. -eletes duplicate I8$ descriptions. Internal ob.ects will be deleted if they are not needed. Invalid ob.ects deleted if possible. Li-rar/ #unctions of RCLSTG: (nsures all pieces of library connected. %emoves ob.ect description entries if there is no corresponding entry in library. ll partially created libraries are destroyed. (ach library is checked for damage. -uplicate libraries are deleted. -uplicate ob.ects are renamed? the original name is in the text description. 6essage is generated for any external ob.ect transferred. ,se the )R'OB*O)N command to show all ob.ects owned by 1-3T$45. ,ser is responsible to determine the correct owner. uthorities may need to be granted again ! GRTOB* +T#. /andle ob.ects on damaged8destroyed authori=ation list. -isplay ob.ects secured by 1%*+ ,T+ !DS, +TLOB*#. 6ove ob.ects to another authori=ation list !GRTOB* +T#. -eleted ob.ects include internal system ob.ects which show up in the count but do not have an external message. Office #unctions of t$e RCLSTG Command: "erforms different functions than the RCLDLO command. (nsures -+$ ob.ects are in 1-$*. (nsures -+$ ob.ects are owned. -estroys -+$ ob.ects that are not valid. 2erifies the mail logs on the system. (nsures all mail is on someoneEs mail log. (nsures all mail documents are attached to a mail item. Data-ase #unctions of t$e RCLSTG Command: -atabase recovery is performed. "erforms any pending commit recovery. -etermines which secondary pieces are danglers. If the danglers are not needed they are deleted.

-atabase cross reference files are built during RCLSTG !both ' ++ and '-B)%(3# processing. Identifies the database formats and directories that are danglers. -amage on database ob.ects? not all damage will be detected. -oes not scan the data space or data space indexes for damage. o O-.ect 0andlin%: -uplicate ob.ects are renamed? the original name is in the text description. /andle any ob.ects whose ownership is transferred to 1-3T$457 6essage is generated for any external ob.ect transferred. ,se the )R'OB*O)N command to show all ob.ects owned by 1-3T$45. ,ser is responsible to determine the correct owner. uthorities may need to be granted again ! GRTOB* +T#. /andle ob.ects on damaged8destroyed authori=ation list. -isplay ob.ects secured by 1%*+ ,T+ !DS, +TLOB*#. 6ove ob.ects to another authori=ation list !GRTOB* +T#. -eleted ob.ects include internal system ob.ects which show up in the count but do not have an external message. o 1RCLSTG data area: 0 3or SYSB S, located in 1,S%SYS in S":. 0 3or S" 9roups, located in 1,S%SYS in the "rimary S" for an S" group 0 -ata from last the RCLSTG command 0 System name. 0 Serial number. 0 Starting and ending date and time !*YY66-- and //66SS#. 0 Indicates if last the RCLSTG command did not complete. Reclaim Stora%e 2essa%es ESC ,E 2essa%es *"3:FGB 3unction H: not allowed. *"3:FG* 3unction H: not allowed. *"3;::I +ibrary H: locked. *"3;:;G *annot delete library H:. *"3;:;B ttempt to recover library H: failed. *"3;:;D ,ser profile H; damaged. *"3AD;I 5ot able to allocate ob.ect H:. *"3F;G: ,ser profile H: does not exist or is damaged. *"3F;G@ *ommitment control cannot be active during reclaim storage. *"3F;GA +ibrary H: does not exist or is damaged. *"3F;GI System not in proper state to reclaim storage. *"3F;:G %eclaim storage failed for auxiliary storage pool device H;. *"3F;:: +ibrary H: damaged. %*+ST9 command ended. *"3F;:; S(+(*T!'-B)%(3# or $6IT!'-B)%(3# invalid when reclaiming an ,ser -efined 3ile System !,-3S# S". *"3F;;@ -uplicate ob.ect found while moving or renaming member *"3F;A: %*+ST9 command ended. +ibrary H: damaged.

*"3F;A; (rror occurred during rebuild of damaged library H:. *"3IF:@ -evice H: not found. *"3BF(- -evice description H: not correct for operation. ST T+S 2essa%es *"IF;GB H:J of ob.ects processed. *"IF;:G "rocessing data base relationships. *"IF;:; -ata base8library8directory recovery in progress. *"IF;:< "rocessing ob.ects on the system. *"IF;:@ ll permanent ob.ects have valid owners. *"IF;:A $b.ect description verification in progress. *"IF;:B 3inal clean up in progress. *"IF;:D 6ail Server 3ramework cleanup in progress. *"IF;:F -irectory recovery in progress. *"IF;:I -irectory cleanup in progress. *"IF;;G 6essage &ueue 1SYS$"% in '/$+- delivery mode. *"I I:B H:J of directories processed.