| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
For more information on using this command, see the "Journal management" article in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SYSRCYTIME | System recovery time | 1-1440, *SAME, *SYSDFT, *NONE, *MIN, *OFF | Optional, Positional 1 |
| ASPRCYTIME | ASP recovery time | Values (up to 32 repetitions): Element list | Optional |
| Element 1: ASP number | 1-32 | ||
| Element 2: Recovery time | 1-1440, *SAME, *NONE, *MIN | ||
| ASPDEVRCY | ASP device recovery time | Values (up to 223 repetitions): Element list | Optional |
| Element 1: ASP device | Name | ||
| Element 2: Recovery time | 1-1440, *SAME, *NONE, *MIN | ||
| INCACCPTH | Include access paths | *SAME, *ALL, *ELIGIBLE | Optional |
| Top |
Specifies the target access path recovery time to be used system-wide.
Note: Changing from *OFF to another value must be done when the system is in a restricted state.
Note: The system may not be able to protect enough access paths to meet the target access path recovery time. You can review access path recovery status by using the DSPRCYAP command.
Reasons that the target access path recovery time may not be met:
| Top |
Specifies the target access path recovery time per auxiliary storage pool. This parameter is valid and prompted only if the system has basic user ASPs.
Element 1: Auxiliary storage pool ID
Note: The value of 1 is the system ASP, any other value indicates a user ASP.
To specify the target access path recovery time for an independent ASP, use the ASPDEVRCY parameter.
Element 2: Recovery time
| Top |
Specifies the target access path recovery time per independent auxiliary storage pool. This parameter is valid and prompted only if the system has active or available independent ASPs.
Element 1: Auxiliary storage pool ID
Element 2: Recovery time
| Top |
Specifies whether the access path recovery time specification should include only those access paths which are considered eligible for protection or include all access paths. The access paths which are not eligible for protection are:
Note: Access paths with *REBLD maintenance are not considered for access path protection and are not included in the not eligible time since these access paths are not recovered during an IPL or during the vary on of an independent ASP.
Note: Access paths that have international components for unicode (ICU) sort sequence tables are considered for access path protection. However, some of these access paths may be too complex to be protected and will not be included in the not eligible time. Access paths with other sort sequence tables are considered.
| Top |
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.
| Top |
*ESCAPE Messages
| Top |