CL Command Reference - CHGRCYAP
CL Command List > CHGRCYAP Reference
Description:
The Change Recovery for Access Paths (CHGRCYAP) command is used to change the target access path recovery time for the system or for one or more auxiliary storage pools (ASPs). The system uses no more than the specified target access path recovery time when recovering access paths during an initial program load (IPL) or vary on of an independent ASP after an abnormal system end. Because the access path recovery time is a target, performance may range around the target.
The time taken to rebuild access paths exposed while running the Copy File (CPYF), the Reorganize Physical File Member (RGZPFM), or the Restore Object (RSTOBJ) commands is not considered in the target access path recovery time of access paths protected with this command.
You can use this command to manage the protection of access paths that are not already protected through journaling. Changes made with this command are an immediate change in policy; however, a little time may be needed for the system to adjust its performance to meet the new target.
Restrictions:
. You must have job control (*JOBCTL) special authority to use this command.
. This command is shipped with public *EXCLUDE authority, and the QPGMR and QSYSOPR user profiles have private authorities to use this command.
. If the current access path recovery state is *OFF, the user must be in a restricted state to activate system-managed access-path protection by specifying a target access path recovery time value.
. If no user auxiliary storage pools (ASPs) exist on the system, an access path recovery time for ASP 1 cannot be specified. The access path recovery time must be specified on the SYSRCYTIME parameter.
Examples:
Example 1: Changing the System Recovery Time for Access Paths
CHGRCYAP SYSRCYTIME(180)
This command changes the target access path recovery time for the entire system to 180. This protects enough access paths to limit the time needed at IPL to recover all eligible access paths on the system to 180 minutes.
The target access path recovery time includes access paths which are considered not eligible.
Example 2: Changing the User ASP Recovery Times for Access Paths
CHGRCYAP ASPRCYTIME((2 *MIN) (3 *NONE))
INCACCPTH(*ELIGIBLE)
This command changes the access path recovery times for user ASPs. The user ASP 2 is changed to *MIN, which protects all access paths on the ASP. The user ASP 3 is changed to *NONE, which protects access paths on the ASP only if needed to reach the system access path recovery time.
The target access path recovery time includes only access paths which are considered eligible.
Example 3: Changing the Independent ASP Recovery Times for Access Paths
CHGRCYAP ASPRCYTIME((2 *MIN))
ASPDEVRCY((WAREHUS1 20) (ORDERDB *MIN))
INCACCPTH(*ALL)
This command changes the access path recovery times for one basic user ASP and two independent user ASPs. The user ASP 2 is changed to *MIN, which protects all access paths on the ASP. The independent user ASP with ASP device name WAREHUS1 is changed to 20 minutes, which protects enough access paths on the ASP to acheive a vary on access path rebuild time of 20 minutes. The independent user ASP with ASP device name ORDERDB is changed to *MIN, which protects all access paths on the independent ASP.
All target access path recovery times for the system (not just those specified on this command) will be defined to include all access paths. More eligible access paths will be protected to account for any access paths that are not eligible.