Start ASP Session (STRASPSSN)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Start Auxiliary Storage Pool Session (STRASPSSN) command assigns a name to geographic mirroring, Metro Mirror, Global Mirror and FlashCopy sessions and starts IBM PowerHA for i sessions for them. A geographic mirroring session exists in i5/OS from the time the geographic mirroring mirror copy ASP is created. Metro Mirror, Global Mirror or FlashCopy sessions exists in TotalStorage from the time they are configured in the TotalStorage devices. 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 ASP can be a FlashCopy source ASP. The following cannot be a FlashCopy target ASP:

Restrictions:

Top

Parameters

Keyword Description Choices Notes
SSN Session Name Required, Positional 1
TYPE Session type *GEOMIR, *METROMIR, *GLOBALMIR, *FLASHCOPY Required, Positional 2
ASPCPY ASP copy Values (up to 223 repetitions): Element list Required, Positional 3
Element 1: Preferred source Name
Element 2: Preferred target Name
FLASHTYPE FlashCopy type *COPY, *NOCOPY Optional
PERSISTENT Persistent relationship *YES, *NO 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.

*GEOMIR
The session is a geographic mirroring session.
*METROMIR
The session is a Metro Mirror session.
*GLOBALMIR
The session is a Global Mirror session.
*FLASHCOPY
The session is a FlashCopy session.
Top

ASP copy (ASPCPY)

Specifies the names of the ASP copy descriptions for the ASP session. An 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. ASP copy descriptions must be grouped by device in the parameter.

This is a required parameter. The first two values are required for all sessions. For a FlashCopy session, the values for each device must have the source copy specified first and the target second. For other sessions, a copy's Cluster Resource Group (CRG) overrides the order of specification and is used to identify the current source and target. The third and fourth values are needed by Global Mirror sessions to identify copies that are used to provide a consistent target.

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.

Element 3: Consistency source

*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

*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

FlashCopy type (FLASHTYPE)

Specifies the FlashCopy session type.

Use of this keyword is only valid for a FlashCopy session.

*COPY
The session is a "copy" FlashCopy session.
*NOCOPY
The session is a "no copy" FlashCopy session.
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. These two operations are options on the Change Auxiliary Storage Pool Session (CHGASPSSN) command.

Use of this keyword is only valid for a FlashCopy session.

*YES
The relationship between source and target is persistent.
*NO
The relationship between source and target is not persistent.
Top

Examples

Example 1: Starting a Geographic Mirroring Session

STRASPSSN   SSN(ORDER)   TYPE(*GEOMIR)
            ASPCPY(ORDER ORDERBKP)
            SSPTIMO(60)  PRIORITY(*HIGH)  TRACKSPACE(50)

This command starts a geographic mirroring session within the High Availability Solutions Manager. It sets the suspend timeout value to 60 seconds, specifies that the re-synchronization priority should be the highest posssible and specifies that up to 50 percent of the available tracking space can be used for recording changes.

Example 2: Starting a Metro Mirror Session

STRASPSSN   SSN(ORDER)  TYPE(*METROMIR)
            ASPCPY(ORDER ORDERBKP)

This command starts a Metro Mirror session within the High Availability Solutions Manager. The source ASP copy description is named ORDER and the target ASP copy description is named ORDERBKP.

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