| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Auxiliary Storage Pool Session (CHGASPSSN) command is used to change an existing geographic mirroring, Metro Mirror, Global Mirror or FlashCopy session.
To suspend or resume geographic mirroring, Metro Mirror or Global Mirror, it is necessary to have already configured the mirror copy disks and a cluster resource group (CRG) with a recovery domain that has two sites. Suspend does not occur for Metro Mirror or Global Mirror if i5/OS is not active but the storage area network is.
To change session attributes (use the *CHGATTR option) when using geographic mirroring, the production copy of the ASP must be offline.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SSN | Session | Name | Required, Key, Positional 1 |
| OPTION | Option | *CHGATTR, *SUSPEND, *RESUME, *DETACH, *REATTACH, *INCR, *REVERSE | Required, Key, Positional 2 |
| ASPCPY | ASP copy | Values (up to 223 repetitions): Element list | Optional, Positional 3 |
| Element 1: Preferred source | Name, *SAME | ||
| Element 2: Preferred target | Name, *SAME | ||
| Element 3: Consistency source | Name, *SAME, *NONE | ||
| Element 4: Consistency group range | Name, *SAME, *NONE | ||
| SSPTIMO | Suspend timeout | 60-3600, *SAME | Optional |
| DELIVERY | Transmission delivery | *SAME, *SYNC, *ASYNC | Optional |
| MODE | Mirroring mode | *SAME, *SYNC, *ASYNC | Optional |
| PRIORITY | Synchronization priority | *SAME, *LOW, *MEDIUM, *HIGH | Optional |
| TRACKSPACE | Tracking space | 0-100, *SAME | Optional |
| FLASHTYPE | FlashCopy type | *SAME, *COPY | Optional |
| PERSISTENT | Persistent relationship | *SAME, *YES, *NO | Optional |
| ASPDEV | ASP device | Single values: *ALL Other values (up to 223 repetitions): Name |
Optional |
| TRACK | Track | *YES, *NO | Optional |
| Top |
Specifies the name of the ASP session to be changed.
This is a required parameter.
| Top |
Specifies the function of the change request.
This is a required parameter.
| Top |
Specifies the ASP copy description names that are changed.
You can specify 223 values for this parameter.
Element 1: Preferred source
Element 2: Preferred target
Element 3: Consistency source
Element 4: Consistency group range
| Top |
Specifies the number of seconds to wait for a response when doing cross-site mirroring, Metro Mirror or Global Mirror before suspending due to lack of a response.
| Top |
Specifies the delivery method for an ASP session. This parameter only applies to Geographic Mirroring sessions.
| Top |
Specifies the mirroring write mode for an ASP session. This parameter only applies to Geographic Mirroring sessions.
| Top |
Specifies the geographic mirroring synchronization priority.
| Top |
Specifies the percent of the maximum assignable tracking space to use. The maximum assignable tracking space is 1 percent of the total space within an independent ASP. For example, a 100 gigabyte independent ASP has a maximum tracking space of 1 gigabyte. A tracking space parameter value of 5 would specify that 5 percent of 1 gigabyte (50 megabytes) should be reserved for tracking changes.
| Top |
Specifies the FlashCopy session type.
Use of this keyword is only valid for a FlashCopy session. A FlashCopy *NOCOPY session can be changed to FlashCopy *COPY but a FlashCopy *COPY session cannot be changed to FlashCopy *NOCOPY.
| Top |
Specifies whether the relationship is to last beyond the brief interval that it takes to establish a FlashCopy copy. A persistent relationship is necessary in order to do an incremental FlashCopy or a reverse FlashCopy.
| Top |
Specifies the ASP entries within the session that are affected. *DETACH, *REATTACH and *REVERSE work on an entire ASP group and only allow a primary or UDFS ASP to be specified.
Single values
Other values (up to 223 repetitions)
| Top |
Specifies whether changes are to be tracked.
This parameter is only valid for the *SUSPEND and *DETACH options of a geographic mirroring session.
| Top |
Example 1: Suspending an ASP Session
CHGASPSSN SSN(ORDERSSN) OPTION(*SUSPEND)
ASPDEV(ORDER) TRACK(*YES)
This command suspends sending of changes from the session source ASP device named ORDER. Changes to the production copy will be tracked so that a subsequent RESUME request does not require that the entire contents of the ASP be sent.
Example 2: Changing an attribute of an ASP Session
CHGASPSSN SSN(ORDERSSN) OPTION(*CHGATTR)
SSPTIMO(90) TRACKSPACE(80)
This command changes the suspend timeout to 90 seconds. It also changes the percent of the total tracking space that can be used to 80 percent.
| Top |
*ESCAPE Messages
| Top |