Start CSM ASP Session (STRCSMSSN)
| Where allowed to run: All environments (*ALL) Threadsafe: Yes |
Parameters Examples Error messages |
The Start Copy Services Manager (CSM) Auxiliary Storage Pool (ASP) Session (STRCSMSSN) command assigns a name to Metro Mirror, or Global Mirror sessions and starts PowerHA sessions for them. Metro Mirror, or Global Mirror sessions exist in the CSM storage controller from the time they are configured on the CSM storage controller.
PowerHA sessions allow PowerHA to manage and monitor their activity. PowerHA sessions are named so that users and PowerHA can identify to one another which sessions a management or monitoring activity pertains.
A CSM ASP session requires a High Availability (HA) configuration description of type storage controller (*STGCTL) and subtype Copy Services Manager (*CSM), to communicate with the CSM storage manager. If not present, the session cannot start.
A session continues to exist until it is ended with End CSM Session (ENDCSMSSN).
Restrictions:
- You must have system configuration (*IOSYSCFG) special authority to use this command.
- You must have use (*USE) authority to the ASP device descriptions of the session that is being started.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SSN | Session | Name | Required, Positional 1 |
| TYPE | Session type | *GLOBALMIR | Required, Positional 2 |
| DEVDMN | Device domain | Name, * | Optional |
| CRG | Cluster resource group | Name | Optional |
| SWTRVSREPL | Switchover reverse replication | *YES, *NO | Optional |
| FLVRVSREPL | Failover reverse replication | *NO, *YES | Optional |
| Top |
Session (SSN)
Specifies the name of the Copy Services Manager (CSM) Auxiliary Storage Pool (ASP) session.
This is a required parameter.
- name
- Specify the name for the CSM ASP session.
| Top |
Session type (TYPE)
Specifies the type of the session.
This is a required parameter.
- *METROMIR
- The session is a Metro Mirror session. Metro Mirror sessions are synchronous.
A Metro Mirror session can be used to manage and control a Copy Services Manager (CSM) DS8000 session of type Metro Mirror Failover/Failback.
- *GLOBALMIR
- The session is a Global Mirror session. Global Mirror sessions are asynchronous.
A Global Mirror session can be used with the following types of Copy Services Manager (CSM) DS8000 ASP sessions:
- Global Mirror Either Direction: A session used for Global Mirror without a HyperSwap configuration.
- Metro Mirror - Global Mirror w/ Site 3 Global Mirror: A session used for a PowerHA HyperSwap with Global Mirror configuration.
| 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 |
Cluster resource group (CRG)
Specifies the name of the device cluster resource group (CRG) that contains the Auxiliary Storage Pools (ASPs) to use for this session.
There must be ASP copy descriptions that identify the copies of the ASP within the cluster resource group.
For HyperSwap with Global Mirror one of the ASP copy descriptions must be configured for HyperSwap and contain two storage hosts describing the HyperSwap relationship.
- name
- Specify the name of the device cluster resource group.
| Top |
Switchover reverse replication (SWTRVSREPL)
Specifies whether the Metro Mirror or Global Mirror replication restarts after a switchover in the reverse direction or becomes detached.
- *YES
- Replication is reversed after a switchover.
- *NO
- Replication is not reversed after a switchover. The session becomes detached after a switchover.
| Top |
Failover reverse replication (FLVRVSREPL)
Specifies whether replication of the Metro Mirror or Global Mirror restarts after a failover in the the reverse direction or becomes detached.
- *NO
- Replication is not reversed after a failover. The session becomes detached after a failover.
- *YES
- Replication is reversed after a failover.
| Top |
Examples for STRCSMSSN
Example 1: Starting a Global Mirror CSM Session
STRCSMSSN SSN(ORDER) TYPE(*GLOBALMIR) CRG(ORDERCRG)
This command starts a global mirror session within PowerHA. The source and target ASP copy descriptions are determined using the cluster resource group (CRG) ORDERCRG.
Example 2: Starting an CSM Session in the Current Device Domain
STRCSMSSN SSN(ORDER) TYPE(*GLOBALMIR) CRG(ORDERCRG)
DEVDMN(*)
This has the same result as Example 1. The CSM ASP session is started in the current device domain.
Example 3: Starting an CSM Session in a Named Device Domain
STRCSMSSN SSN(ORDER) TYPE(*GLOBALMIR) CRG(ORDERCRG)
DEVDMN(MYDOMAIN)
This is similar to Example 1, but the CSM ASP session is started in the device domain named MYDOMAIN.
| Top |
| Top |