B.2.8 getsession Command

NAME

getsession - Displays the execution status of migration/replication and EC (ACM)

SYNOPSIS

[Solaris OS/Linux OS]

/opt/FJSVssmgr/sbin/vscmcmd getsession [-i session-id] [-a]
/opt/FJSVssmgr/sbin/vscmcmd getsession -h

[Windows OS]

$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe getsession [-i session-id] [-a]
$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe getsession -h

($INS_DIR means "Program Directory" specified at the Manager installation.)

DESCRIPTION

This command displays the execution status of migration/replication and EC (ACM).

Execute this command as the administrator for the operating system (that is, with “Administrator” or “root” privileges).

OPTIONS

-i session-id

Specifies the session ID to display the execution status of a specific session.

If you do not specify this operand, the status of all migration, replication, and EC (ACM) in progress is displayed.

-a: This option displays detailed information.

-h: Indicates how to use the command.

EXAMPLES

Displaying the status of all migrations, replications and ECs (ACM) that are executing. For ECs (ACM), the first digit of the session ID is “0”.

# /opt/FJSVssmgr/sbin/vscmcmd getsession
SID      Type        FromVirtualDiskName ToVirtualDiskName BackUp Phase        TotalCapacity
10010001 migration   VDISK_MIG001        -                 Yes    copying(87%) 1024MB
10010002 replication VDISK_REP001        VDISK_REP002      -      Equivalent   500MB
00010003 EC(ACM)     VDISK_ACM001        VDISK_ACM002      -      Equivalent   500MB
Command terminated normally.

Displaying the status of the migration executing with the section ID “10010001”.

# /opt/FJSVssmgr/sbin/vscmcmd getsession -i 10010001
SID      Type      FromVirtualDiskName ToVirtualDiskName BackUp Phase      TotalCapacity
10010001 migration VDISK_001           -                 Yes    Equivalent 1024MB
Command terminated normally.

Displaying the status of the replication executing with the section ID “10010002”.

# /opt/FJSVssmgr/sbin/vscmcmd getsession -i 10010002
SID      Type        FromVirtualDiskName ToVirtualDiskName BackUp Phase      TotalCapacity
10010002 replication VDISK_REP001        VDISK_REP002      -      Equivalent 500MB
Command terminated normally.

Displaying the status of the EC (ACM) executing with the section ID “00010003”. For ECs (ACM), the first digit of the session ID is “0”.

# /opt/FJSVssmgr/sbin/vscmcmd getsession -i 00010003
SID      Type    FromVirtualDiskName ToVirtualDiskName BackUp Phase      TotalCapacity
00010003 EC(ACM) VDISK_ACM001        VDISK_ACM002      -      Equivalent 500MB
Command terminated normally.

Table B.8 Display items and meanings of the getsession command
Display item	Displayed when the -a option is not specified	Meaning
SID	Yes	Session ID of migration/replication
Type	Yes	Session type migration: Migration replication: Replication EC(ACM): ACM copy
FromVirtualBoxName	No	Migration: Name of the virtual enclosure that includes the virtual disk performing migration Replication or EC (ACM): Name of the virtual enclosure containing the replication or EC (ACM) source virtual disk
FromVirtualDiskName	Yes	Migration: Name of the virtual disk performing migration Replication or EC (ACM): Name of the replication or EC (ACM) source virtual disk
ToVirtualBoxName	No	Migration: “-”(Hyphen):no information Replication or EC (ACM): Name of the virtual enclosure containing the replication or EC (ACM) destination virtual disk
ToVirtualDiskName	Yes	Migration: “-”(Hyphen):no information Replication or EC (ACM): Name of the replication or EC (ACM) destination virtual disk
BackUp	Yes	Migration: Backup disk information Yes: After completing migration, retain a backup disk. No: After completing migration, do not retain a backup disk. Replication or EC (ACM): “-”(Hyphen):no information
SwitchName	Yes	Name of the virtualization switch performing migration/replication
Application	No	Migration or replication The character string "VSC" is displayed. EC (ACM) The character string "other" is displayed.
Phase	Yes	Migration, replication or EC (ACM) execution status Equivalent: Synchronization maintained Copying(nn%): Synchronization completed (nn%: Percentage of data copying completed) No pair: Waiting for execution Err suspend: Abnormal condition No pair: Copying not executed Finish: Copying completed Suspend: Suspended Halt: Detected a path error in the copy destination device, and has suspended the copy operation
TotalCapacity	Yes	Migration: Capacity (MB) of the virtual disk performing migration Replication or EC (ACM): Capacity (MB) of the replication or EC (ACM) source virtual disk ETERNUS SF AdvancedCopy Manager : Total copy size (MB)
StartDate	No	Start date of migration, replication or EC (ACM)
Abend	No	Error cause 0x00: Normal COPY_ABEND_CAUSE_OK 0x01: Mirror volume error COPY_ABEND_CAUSE_MIRROR 0x02: Copy source volume error COPY_ABEND_CAUSE_SRC 0x03: Copy destination volume error COPY_ABEND_CAUSE_DST 0x04: VS900 management area error COPY_ABEND_CAUSE_MANAGEMENT_ARE 0x80: Other error COPY_ABEND_CAUSE_OTHER 0x81: Engine unsupported COPY_ABEND_CAUSE_ENGINE_UNSUPORT
ManagementArea	No	Management area information Unit-name + LunV-number: Obtained management area "-": No management area "unknown": A management area exists but cannot be obtained.

EXIT STATUS

0: Execution status has been displayed.

1: Execution status could not be displayed.