Start SVC Session (STRSVCSSN)
| Where allowed to run: All environments (*ALL) Threadsafe: Yes |
Parameters Examples Error messages |
The Start Storage Area Network (SAN) Volume Controller Auxiliary Storage Pool Session (STRSVCSSN) command assigns a name to Metro Mirror, Global Mirror and FlashCopy sessions and starts IBM PowerHA for i sessions for them. Metro Mirror, Global Mirror or FlashCopy sessions exists in the SAN Volume Controller (SVC) from the time they are configured in the SAN Volume Controller clusters. The IBM PowerHA for i sessions allow IBM PowerHA for i to manage and monitor their activity. The IBM PowerHA for i sessions are named so that users and IBM PowerHA for i can identify to one another which session a management or monitoring activity pertains.
A session continues to exist until it is ended even if the session operation has completed. This is done because a session consists of an operation and the status of the operation. Keeping the session beyond the completion of the actual operation allows the session completion information to be retrieved.
Any auxiliary storage pool (ASP) can be a FlashCopy source ASP. The following cannot be a FlashCopy target ASP:
- A Metro Mirror source or target.
- A Global Mirror source or target.
- A target of some other FlashCopy cannot itself be a FlashCopy target.
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 started.
- 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, Positional 1 |
| TYPE | Session type | *METROMIR, *GLOBALMIR, *FLASHCOPY | Required, Positional 2 |
| DEVDMN | Device domain | Name, * | Optional |
| ASPCPY | ASP copy | Values (up to 223 repetitions): Element list | Optional |
| Element 1: Preferred source | Name | ||
| Element 2: Preferred target | Name | ||
| CRG | Cluster resource group | Name | Optional |
| INCR | Incremental flash | *NO, *YES | Optional |
| CPYRATE | Copy rate | 0-100, 0 | Optional |
| CLNRATE | Cleaning rate | 0-100, 0 | Optional |
| GRAINSIZE | Grain size | 256, 64 | Optional |
| CNSGRP | Consistency group | Name, *GEN | Optional |
| RVSCNSGRP | Reverse consistency group | Name, *GEN, *NONE | Optional |
| SWTRVSREPL | Switchover reverse replication | *YES, *NO | Optional |
| FLVRVSREPL | Failover reverse replication | *NO, *YES | Optional |
| Top |
Session (SSN)
Specifies the name of the session to be started.
This is a required parameter.
- name
- Specify the name for the ASP session.
| Top |
Session type (TYPE)
Specifies the type of session being started.
This is a required parameter.
- *METROMIR
- The session is a Metro Mirror session.
- *GLOBALMIR
- The session is a Global Mirror session.
- *FLASHCOPY
- The session is 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 names of the SAN Volume Controller (SVC) ASP copy descriptions for the ASP session. A SAN Volume Controller ASP copy description is required for each copy of each ASP device, whether primary, secondary or UDFS ASP, that participates as a source or target in the session. SAN Volume Controller ASP copy descriptions must be grouped by device in the parameter.
This is a required parameter for FlashCopy ASP sessions. The values for each device must have the source copy specified first and the target second. For other sessions, this parameter is ignored as the cluster resource group (CRG) parameter determines the SVC ASP copy descriptions to use for the ASP session.
You can specify 223 values for this parameter.
Element 1: Preferred source
- name
- Specify the name of a preferred source ASP copy description.
Element 2: Preferred target
- name
- Specify the name of the preferred target ASP copy description that corresponds to the preferred source copy description.
| Top |
Cluster resource group (CRG)
Specifies the name of the cluster resource group (CRG) that identifies the SAN Volume Controller (SVC) ASP copy descriptions to use use for this ASP session. This parameter is only valid for Metro Mirror and Global Mirror sessions.
- name
- Specify the name of the cluster resource group.
| Top |
Incremental flash (INCR)
Specifies if the FlashCopy is an incremental FlashCopy.
Use of this keyword is only valid for a FlashCopy session.
- *NO
- The FlashCopy session is not incremental.
- *YES
- The FlashCopy session is incremental.
| 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.
- 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.
- 0-100
- The clearning rate for the FlashCopy.
| Top |
Grain size (GRAINSIZE)
Specifies the FlashCopy grain size in kilobytes (KB). More information on FlashCopy grains and grain size can be found in the SAN Volume Controller Information Center.
Use of this keyword is only valid for a FlashCopy session.
- 256
- The grain size for the FlashCopy is 256 KB.
- 64
- The grain size for the FlashCopy is 64 KB.
| Top |
Consistency group (CNSGRP)
Specifies the name of the consistency group to use when creating the FlashCopy session.
Use of this keyword is only valid for FlashCopy sessions.
- *GEN
- A new consistency group is to be created. The consistency group name will be generated by the SAN Volume Controller.
- name
- The name of the consistency group to use for the FlashCopy session. If the consistency group does not exist on the SAN Volume Controller, it will be created.
| Top |
Reverse consistency group (RVSCNSGRP)
Specifies the name of the reverse consistency group to use when creating the FlashCopy session. The reverse consistency group is used by the CHGSVCSSN command with OPTION(*REVERSE).
Use of this keyword is only valid for FlashCopy sessions.
- *GEN
- A new reverse consistency group is to be created. The reverse consistency group name will be generated by the SAN Volume Controller.
- *NONE
- A reverse consistency group and reverse FlashCopy mappings will not be created. Use this value if the CHGSVCSSN command with OPTION(*REVERSE) will never be executed.
- name
- The name of the reverse consistency group to use for the FlashCopy session. If the reverse consistency group does not exist on the SAN Volume Controller, it will be created.
| 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 is not valid for FlashCopy sessions.
- *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 is not valid for FlashCopy sessions.
- *NO
- Replication is not reversed after a failover.
- *YES
- Replication is reversed after a failover.
| Top |
Examples
Example 1: Starting a Metro Mirror Session
STRSVCSSN SSN(ORDER) TYPE(*METROMIR) CRG(ORDERCRG)
This command starts a metro mirorr session within IBM PowerHA for i. The source and target ASP copy descriptions are determined using the cluster resource group (CRG) ORDERCRG.
Example 2: Starting an ASP Session in the Current Device Domain
STRSVCSSN SSN(ORDER) TYPE(*METROMIR) CRG(ORDERCRG) DEVDMN(*)
This has the same result as Example 1. The ASP session is started in the current device domain.
Example 3: Starting an ASP Session in a Named Device Domain
STRSVCSSN SSN(ORDER) TYPE(*METROMIR) CRG(ORDERCRG) DEVDMN(MYDOMAIN)
This is similar to Example 1, but the ASP session is started in the device domain named MYDOMAIN.
Example 4: Starting a FlashCopy Session
STRSVCSSN SSN(ORDER) TYPE(*FLASHCOPY)
ASPCPY(ORDER ORDERBKP)
INCR(*NO) CPYRATE(0)
This command starts a FlashCopy session within IBM PowerHA for i. The source ASP copy description is named ORDER and the target ASP copy description is named ORDERBKP. The FlashCopy will not be incremental and has a copy rate of 0. A consistency group will be generated by the SAN Volume Controller.
Example 5: Starting a FlashCopy Session using an existing consistency group
STRSVCSSN SSN(ORDER) TYPE(*FLASHCOPY)
ASPCPY(ORDER ORDERBKP)
INCR(*NO) CPYRATE(0) CNSGRP("fccstgrp1")
This command starts a FlashCopy session within IBM PowerHA for i. The source ASP copy description is named ORDER and the target ASP copy description is named ORDERBKP. The FlashCopy will not be incremental and has a copy rate of 0. The FlashCopy will use the existing consistency group fccstgrp1.
| 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 |