mksess

Use the mksess command to create a new session.

Syntax

Parameters

-help | -h | -?

Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.

-cptype copy_type

Specifies the session type. The storage systems that are available for a session differ by session type. The following parameter values are listed by storage system type.

IBM® TotalStorage Enterprise Storage Server® Model 800, and IBM DS8000®

fc: FlashCopy®
sgc: Safeguarded Copy
hs: Basic HyperSwap®
mmsd: Metro Mirror Single Direction
mmfofb: Metro Mirror Failover/Failback
pmm: Metro Mirror Failover/Failback with Practice
mm_mm: Metro Mirror - Metro Mirror (This session type is available only for IBM DS8000 storage systems with a microcode level that supports single source to multi-target relationships. To determine whether you can use this session type, refer to the IBM DS8000 documentation for the microcode level that you are using.)
gmsd: Global Mirror Single Direction
gmfofb: Global Mirror Failover/Failback
gm2s: Global Mirror Either Direction
pgm: Global Mirror Failover/Failback with Practice
pgm2s: Global Mirror Either Direction with Two Site Practice
mgm: Metro Global Mirror
pmgm: Metro Global Mirror with Practice
mm_gm: Metro Mirror - Global Mirror
mm_gmp: Metro Mirror - Global Mirror w/ Practice
mm_gm_s3gm: Metro Mirror - Global Mirror w/ Site 3 Global Mirror
mm_gm_4s: Metro Mirror - Global Mirror w/ Site 4 Replication
mm_mm_4s: Metro Mirror - Metro Mirror w/ Site 4 Replication

IBM FlashSystem Spectrum Virtualize

fc: FlashCopy
mmsd: Metro Mirror Single Direction
mmfofb: Metro Mirror Failover/Failback
pmmsvc: Metro Mirror Failover/Failback with Practice
gmsdsvc: Global Mirror Single Direction
gmfofbsvc: Global Mirror Failover/Failback
pgmsvc: Global Mirror Failover/Failback with Practice
gmcvsvc: Global Mirror Failover/Failback with Change Volumes

IBM FlashSystem/ Spectrum Accelerate

snap: Snapshot
mmfofbxiv: Metro Mirror Failover/Failback
gmfofbxiv: Global Mirror Failover/Failback
mm_gm_xiv: Metro Mirror - Global Mirror

-desc description

Specifies a description for the session. The description can have up to 250 alphanumeric characters.

-site1loc

Specifies a location to associate with the site 1 volume role.

-site2loc

Specifies a location to associate with the site 2 volume role.

-site3loc

Specifies a location to associate with the site 3 volume role.

-site4loc

Specifies a location to associate with the site 4 volume role.

-volumegroup {volume_group}

Boolean for weather or not the session name specified is for a volume group used for an SVC snapshot session.

session_name_or_volume_group | -

Specifies a name for the session. For sessions that contain an FlashSystem/IBM Spectrum Accelerate, the session name can have up to 58 alphanumeric characters. For sessions that contain other storage system types, the session name can have up to 250 alphanumeric characters. Session names must be unique.

Alternatively, use the dash (-) to specify that the input for this parameter comes from an input stream (stdin). The dash is supported only in single-shot mode.

Can also specifies the Spectrum Virtualize volume group to associate with the session in the format SPECTRUM-VIRTUALIZE:VOLGROUP:systemName:group Name (ex. SPECTRUM-VIRTUALIZE:VOLGROUP:FAB2-PROD1:mySnapGroup).

Example: Creating a FlashCopy session

The following command creates a FlashCopy session named session1. The location of the site 1 volume role is Boulder.

csmcli> mksess -cptype fc -site1loc Boulder session1