Change ASP Session (CHGASPSSN)
| 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 the IBM i 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:
- You must have job control (*JOBCTL) special authority to use this command and you must have use (*USE) authority to the ASP device descriptions of the session that is being changed.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SSN | Session | Name | Required, Key, Positional 1 |
| OPTION | Option | *CHGATTR, *SUSPEND, *RESUME, *DETACH, *REATTACH, *INCR, *REVERSE | Required, Key, Positional 2 |
| DEVDMN | Device domain | Name, * | Optional, Key, Positional 3 |
| ASPCPY | ASP copy | Values (up to 223 repetitions): Element list | Optional |
| Element 1: Preferred source | Name, *SAME | ||
| Element 2: Preferred target | Name, *SAME | ||
| 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 |
| SNDINQMSG | Confirm | *YES, *NO | Optional |
| SWTRVSREPL | Switchover reverse replication | *SAME, *YES, *NO | Optional |
| FLVRVSREPL | Failover reverse replication | *SAME, *YES, *NO | Optional |
| Top |
Session (SSN)
Specifies the name of the ASP session to be changed.
This is a required parameter.
- name
- Specify the name of an ASP session. This is the name that was specified when the ASP session was started.
| Top |
Option (OPTION)
Specifies the function of the change request.
This is a required parameter.
- *CHGATTR
- Specifies that one or more of the parameters for the following keywords is to be changed: SSPTIMO, MODE, PRIORITY, TRACKSPACE, FLASHTYPE, PERSISTENT and ASPDEV.
- *SUSPEND
- Specifies that the ASP session is to be suspended.
- *RESUME
- Specifies that the ASP session is to be resumed.
- *DETACH
- Specifies that the session's geographic mirroring mirror copy or its Metro Mirror, Global Mirror or FlashCopy target is to be detached.
- *REATTACH
- Specifies that the session's geographic mirroring mirror copy or its Metro Mirror, Global Mirror or FlashCopy target is to be reattached.
- *INCR
- Specifies that a new incremental FlashCopy operation is to be done. This option is only valid for a FlashCopy session.
- *REVERSE
- Specifies that the session's FlashCopy is to be reversed. This option is only valid for a FlashCopy session.
| Top |
Device domain (DEVDMN)
Specifies the name of the device domain.
- *
- The device domain that the current node is in.
- name
- Specify the name of the device domain.
| Top |
ASP copy (ASPCPY)
Specifies the ASP copy description names that are changed.
You can specify 223 values for this parameter.
Element 1: Preferred source
- *SAME
- The name of the copy description does not change.
- name
- Specify the name of a preferred source ASP copy description.
Element 2: Preferred target
- *SAME
- The name of the copy description does not change.
- name
- Specify the name of the preferred target ASP copy description that corresponds to the preferred source.
Element 3: Consistency source
- *SAME
- The name of the copy description does not change.
- *NONE
- There is no consistency copy description that corresponds to the preferred source.
- name
- Specify the name of the consistency copy description that corresponds to the preferred source.
Element 4: Consistency group range
- *SAME
- The name of the copy description does not change.
- *NONE
- There is no consistency copy description that corresponds to the preferred target.
- name
- Specify the name of the consistency copy description that corresponds to the preferred target.
| Top |
Suspend timeout (SSPTIMO)
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.
- *SAME
- The suspend timeout is not changed.
- 60-3600
- Specify the number of seconds to wait before suspending.
| Top |
Transmission delivery (DELIVERY)
Specifies the delivery method for an ASP session. This parameter only applies to Geographic Mirroring sessions.
- *SAME
- The transmission delivery method is not changed.
- *SYNC
- The mirroring uses synchronous communication between the production and mirror copy systems. This delivery method is best for low latency environments.
- *ASYNC
- The mirroring uses asynchronous communication between the production and mirror copy systems. This delivery method is best for high latency environments. This delivery method will consume more system resources on the production copy node than *SYNC delivery.
| Top |
Mirroring mode (MODE)
Specifies the mirroring write mode for an ASP session. This parameter only applies to Geographic Mirroring sessions.
- *SAME
- The mirroring mode is not changed.
- *SYNC
- The mirroring uses synchronous writes to save the data to disk on the mirror copy. Synchronous mode is the only mode that allows the mirror copy to be upgraded to a production copy and used after a crash of the mirror copy node. This mode is best for most environments.
- *ASYNC
- The mirroring uses asynchronous writes to save the data to disk on the mirror copy. This mode is best for environments where the mirror copy node is significantly slower than the production copy node.
| Top |
Synchronization priority (PRIORITY)
Specifies the geographic mirroring synchronization priority.
- *SAME
- The priority is not changed.
- *LOW
- Use low priority. This uses the fewest resources, but synchronization will take longer to complete.
- *MEDIUM
- Use medium priority. This provides a balance between resource usage and synchronization completion.
- *HIGH
- Use high priority. This completes synchronization as quickly as possible, but consumes the most resources.
| Top |
Tracking space (TRACKSPACE)
Specifies the percent of the maximum assignable tracking space to use. The maximum assignable tracking space is one 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.
- *SAME
- The value is not changed.
- 0-100
- Specify the percent of the maximum assignable tracking space to reserve for tracking changes.
| Top |
FlashCopy type (FLASHTYPE)
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.
- *SAME
- The FlashCopy type does not change.
- *COPY
- The FlashCopy type changes to *COPY.
| Top |
Persistent relationship (PERSISTENT)
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.
- *SAME
- The persistent relationship is not changed.
- *YES
- Specifies that the relationship is persistent. Change recording is done.
- *NO
- Specifies that the relationship is not persistent. Change recording is not done.
| Top |
ASP device (ASPDEV)
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
- *ALL
- All ASP devices are to change.
Other values (up to 223 repetitions)
- name
- Specify the names of the ASP devices that are to change.
| Top |
Track (TRACK)
Specifies whether changes are to be tracked.
This parameter is only valid for the *SUSPEND and *DETACH options of a geographic mirroring session.
- *YES
- Specifies that changes are to be tracked.
- *NO
- Specifies that changes are not to be tracked.
| Top |
Send inquiry message (SNDINQMSG)
When a reattach or reverse is requested, depending on the job type you will see either:
- A confirmation panel when it's an interactive job
- An inquiry message when it is a batch job.
This parameter is only used for OPTION(*REATTACH) or OPTION(*REVERSE).
- *YES
- Send an inquiry message.
- *NO
- Do not send an inquiry message.
| Top |
Switchover reverse replication (SWTRVSREPL)
Specifies whether reverse replication of the Metro Mirror or Global Mirror is to be started after a switchover.
Use of this keyword is not valid for Geographic Mirroring or FlashCopy sessions.
- *SAME
- Reverse replication action is not changed.
- *YES
- Replication is reversed after a switchover.
- *NO
- Replication is not reversed after a switchover.
| Top |
Failover reverse replication (FLVRVSREPL)
Specifies whether reverse replication of the Metro Mirror or Global Mirror is to be started after a failover.
Use of this keyword is not valid for Geographic Mirroring or FlashCopy sessions.
- *SAME
- Reverse replication action is not changed.
- *YES
- Replication is reversed after a failover.
- *NO
- Replication is not reversed after a failover.
| Top |
Examples
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: Suspending an ASP Session in the Current Device Domain
CHGASPSSN SSN(ORDERSSN) OPTION(*SUSPEND)
ASPDEV(ORDER) TRACK(*YES) DEVDMN(*)
This has the same result as Example 1. The session is suspended in the current device domain.
Example 3: Suspending an ASP Session in a Named Device Domain
CHGASPSSN SSN(ORDERSSN) OPTION(*SUSPEND)
ASPDEV(ORDER) TRACK(*YES)
DEVDMN(MYDOMAIN)
This is similar to Example 1, but the session is suspended in the device domain named MYDOMAIN.
Example 4: 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 |
Error messages
*ESCAPE Messages
- CPF9801
- Object &2 in library &3 not found.
- CPF9802
- Not authorized to object &2 in &3.
- CPF9899
- Error occurred during processing of command.
- HAE002B
- &1 command failed.
| Top |