Change SVC Session (CHGSVCSSN)
| Where allowed to run: All environments (*ALL) Threadsafe: Yes |
Parameters Examples Error messages |
The Change Storage Area Network (SAN) Volume Controller Auxiliary Storage Pool Session (CHGSVCSSN) command is used to change an existing Metro Mirror, Global Mirror or FlashCopy session.
To suspend or resume Metro Mirror or Global Mirror, it is necessary to have already configured the target copy disks and a cluster resource group (CRG) with a recovery domain that has two sites.
Restrictions:
- You must have system configuration (*IOSYSCFG) 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.
- You must have read authority to the secure shell key file specified in the preferred source and preferred target copy descriptions.
| 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 |
| CPYRATE | Copy rate | 0-100, *SAME | Optional |
| CLNRATE | Cleaning rate | 0-100, *SAME | Optional |
| SWTRVSREPL | Switchover reverse replication | *SAME, *YES, *NO | Optional |
| FLVRVSREPL | Failover reverse replication | *SAME, *YES, *NO | Optional |
| SNDINQMSG | Send inquiry message | *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: CPYRATE, CLNRATE, SWTRVSREPL, FLVRVSREPL.
- *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 target copy is to be detached. This option is only valid for Metro Mirror or Global Mirror sessions.
- *REATTACH
- Specifies that the session's target copy is to be reattached. This option is only valid for Metro Mirror or Global Mirror sessions.
- *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 |
Copy rate (CPYRATE)
Specifies the rate at which data is copied from the source virtual disks (VDisks) of a FlashCopy to the target VDisks. More information on the copy rate can be found in the SAN Volume Controller Information Center.
Use of this keyword is only valid for a FlashCopy session.
- *SAME
- The copy rate is not changed.
- 0-100
- The copy rate for the FlashCopy.
| Top |
Cleaning rate (CLNRATE)
Specifies the rate at which the cleaning process is done on the FlashCopy mapping. The cleaning process copies data from the target virtual disk (VDisk) of a mapping to the target VDisks of other mappings that are dependent on this data. More information on the cleaning rate can be found in the SAN Volume Controller Information Center.
Use of this keyword is only valid for a FlashCopy session.
- *SAME
- The clearning rate is not changed.
- 0-100
- The clearning rate for the FlashCopy.
| Top |
Switchover reverse replication (SWTRVSREPL)
Specifies if reverse replication of the Metro Mirror or Global Mirror is to be started after a switchover.
Use of this keyword not valid for 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 if reverse replication of the Metro Mirror or Global Mirror is to be started after a failover.
Use of this keyword not valid for 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 |
Send inquiry message (SNDINQMSG)
Specifies whether or not to send an inquiry message when a reattach is requested. The inquiry message will be sent to the QSYSOPR message queue.
Until you respond to the inquiry message, the reattach operation will be held.
This parameter is only use for OPTION(*REATTACH).
- *YES
- Send an inquiry message.
- *NO
- Do not send an inquiry message.
| Top |
Examples
Example 1: Suspending an ASP Session
CHGSVCSSN SSN(ORDERSSN) OPTION(*SUSPEND)
This command suspends sending of changes from the session source of session ORDERSSN.
Example 2: Changing an ASP Session in the Current Device Domain
CHGSVCSSN SSN(ORDERSSN) OPTION(*SUSPEND) DEVDMN(*)
This has the same result as Example 1. The ASP session is changed in the current device domain.
Example 3: Changing an ASP Session in a Named Device Domain
CHGSVCSSN SSN(ORDERSSN) OPTION(*SUSPEND) DEVDMN(MYDOMAIN)
This is similar to Example 1, but the ASP session is changed in the device domain named MYDOMAIN.
Example 4: Changing an attribute of an ASP Session
CHGSVCSSN SSN(ORDERSSN) OPTION(*CHGATTR) CPYRATE(50)
This command changes the copy rate of seesion ORDERSSN to 50 which would make the affective rate at which data is copied 2 MB per second.
| Top |
Error messages
*ESCAPE Messages
- CPF9801
- Object &2 in library &3 not found.
- CPF9802
- Not authorized to object &2 in &3.
- HAE002B
- &1 command failed.
| Top |