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 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

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
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

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

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.
1-7200
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 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.

*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. For *SUSPEND, this parameter applies to the source or production copy. For detach of a geographic mirroring mirror copy, this parameter applies to both the production copy and the mirror copy.
*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

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: 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