Storage system: | ETERNUS DX/AF, Symmetrix/VMAX3 |
Domain: | DEVICE |
Privileges: | TSOS, OPERATING, HW-MAINTENANCE, |
Routing code: | @ |
provides information on the status of clone pairs in storage systems.
/SHOW-CLONE-SESSION-STATUS
When device selection takes place, SHC-OSD automatically determines the correct volumes on the storage system concerned and then outputs the data which is relevant for the system. Only clone pairs of one storage system type can be selected (e.g. ETERNUS DX/AF or Symmetrix/VMAX3).
The command supports structured output to S variables (for further information, see the manual “Commands” [1]).
SHOW-CLONE-SESSION-STATUS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
UNIT =
Selects the units by means of a particular VSN (*BY-VOLUME
), a particular catalog ID (*BY-PUBSET
), by means of the serial number and the internal number of the logical volume in the storage system (*BY-SYMMETRIX/*BY-STORAGE
), or directly by means of the logical volume's mnemonic device name. At least one unit must be attached per emulated controller.
UNIT = *BY-VOLUME(...)
Selects the units by means of a particular VSN.
VOLUME = list-poss(24): <vsn 1..6>
Specifies the volume’s VSN.
UNIT = *BY-PUBSET(...)
Selects units by means of a pubset ID or volume set ID. Information is output for all volumes of the specified pubset. IDs of SF pubsets, volume sets or imported SM pubsets can be specified. No information is output for exported SM pubsets.
PUBSET = list-poss(24): <cat-id 1..4>
Specifies the pubset ID or volume set ID.
UNIT = *BY-SYMMETRIX(...)
Only relevant for Symmetrix/VMAX3.
Selects the unit by means of the serial number of the storage system and the internal number of the logical volume in the storage system.
SERIAL-NUMBER = <alphanum-name 3..12>
Specifies the serial number of the storage system (make sure it is unique!).
LOGICAL-VOLUME = *ALL
Selects all logical volumes of the storage system.
LOGICAL-VOLUME = <x-text 1..4>
Specifies the internal number of the logical volume in the storage system.
UNIT = *BY-STORAGE(...)
Only relevant for ETERNUS DX/AF.
Selects the unit by means of the serial number and the internal number of the logical volume in the storage system.
SERIAL-NUMBER = *ALL
All storage systems are selected.
All known clone pairs are output.
Processing this command can take some time if several storage systems exist.
SERIAL-NUMBER = <alphanum-name 3..14>
Specifies the serial number of the storage system (make sure it is unique!).
LOGICAL-VOLUME = *ALL
Selects all logical volumes of the storage system.
LOGICAL-VOLUME = <x-text 1..4>
Specifies the internal number of the logical volume in the storage system.
UNIT = list-poss(24): <alphanum-name 1..4 with-wildcards>
Selects the unit by means of the mnemonic device name of the logical volume.
SELECT =
Selects the units by means of their remote copy use or their status as seen by BS2000.
SELECT = *ALL-PRESELECTED
The set of units is not restricted further. The global setting for SHC-OSD applies (value of DEVICE-PRESELECTION
in the output of /SHOW-SHC-PROCESSING
).
SELECT = *BY-ATTRIBUTES(...)
The set of units is restricted by means of selection criteria.
CLONE-TYPE=
Only relevant for ETERNUS DX/AF.
Specifies the clone type (and thus also the replication function) that is output.
CLONE-TYPE = *ANY
Information on all clone types is output.
CLONE-TYPE = *COPY
Information on the COPY clone type (and thus the QuickOPC replication function) is output.
CLONE-TYPE = *MIRROR
Information on the MIRROR clone type (and thus the EC replication function) is output.
REMOTE-COPY-USE =
Units with the specified remote copy use are selected.
REMOTE-COPY-USE = *STD
Outputs information on all units regardless of their remote copy use.
REMOTE-COPY-USE = *TARGET-UNIT(...)
Selects the clone pairs which are assigned to the target unit of a remote copy pair. The relevant source unit is specified in the UNIT
operand.
For ETERNUS DX/AF the selection can only be made if the target unit is unique. Concurrent remote copy is not supported in the output.
RA-GROUP =
Only relevant for Symmetrix/VMAX3.
Selects the target unit using the RA group in the case of concurrent target units.
RA-GROUP = *UNIQUE
Selects the one existing target unit.
RA-GROUP = <integer 1..250>
Selects the target units of the specified source RA group.
DEVICE =
Selects the units by means of their status as seen by BS2000.
DEVICE = *ALL-PRESELECTED
Selects all units corresponding to the global setting for the SHC-OSD subsystem (value of DEVICE-PRESELECT
in the output of /SHOW-SHC-PROCESSING
).
DEVICE = *ALL-DEFINED
Selects all units generated in BS2000.
DEVICE = *DETACHED
Selects units which are generated in BS2000 but detached.
DEVICE = *ATTACHED
Selects all units attached in BS2000.
DEVICE = *ANY
Selects all units of the storage system which was specified in the UNIT
operand.
UPDATE =
Controls updating of the data provided.
UPDATE = *STD
The data is updated in SHC-OSD before the SHOW command is executed.
UPDATE = *NO
The SHOW command is executed without the data being updated in SHC-OSD.
UPDATE = *DISCOVER
Before executing the SHOW-command the data in the Storage Manager and in SHC-OSD is updated.
CLONE-TYPE =
just for ETERNUS DX/AF.
Determines the clone-typ (and with that, the replicationsfunction), that is displayed.
CLONE-TYPE = *ANY
Informationen about all clone-types is displayed.
CLONE-TYPE = *COPY
Informationen about clone-types COPY (and with that, the replicationsfunction QuickOPC) is displayed.
CLONE-TYPE = *MIRROR
Informationen about clone-types MIRROR (and with that, the replicationsfunction EC) is displayed.
INFORMATION =
just for ETERNUS DX/AF.
The Operand INFORMATION is just relevant for the clone-type COPY in combination with the usage of the continuous copy function.
INFORMATION = *STD
The Output in old format is displayed.
INFORMATION = *CONTINUOUS-COPY
The output contains extended continuous copy information
Examples
/SHOW-CLONE-SESSION-STATUS UNIT=*BY-PUBSET(PUBSET=BT10)
/SHOW-CLONE-SESSION-STATUS UNIT=*BY-STOR(SERIAL-NUM=1003,LOGICAL-VOLUME=100)
/SHOW-CLONE-SESSION-STATUS UNIT=*BY-SYMM(SERIAL-NUM=227, LOGICAL-VOLUME=100),REMOTE-COPY-USE=*TARGET-UNIT(RA-GROUP=*UNIQUE)
/SHOW-CLONE-SESSION-STATUS UNIT=5244
Output for clone pairs
The layout of the SYSOUT output differs because not all output fields are supplied with values by all storage systems. SHC-OSD automatically selects the correct output format.
Outputs for ETERNUS DX/AF
/SHOW-CLONE-SESSION-STATUS UNIT=*BY-STORAGE(SERIAL-NUMBER=7022) % ----------------------------------------------------------------------------- % UNIT VOLUME! ! !SERIAL-NO LOG-VOL % ----------------------------------------------------------------------------- % CLON- VOLUME!STATE !ACTIVE-FOR !TYPE CONT- PERCENT- % UNITS ! !DDDD.HH:MM:SS! COPY COPIED % ============================================================================= % 4609 ! ! ! 4621637022 00009 % 460A !SYNCHRONIZED ! - ! MIRROR - 100 % 0000A % ----------------------------------------------------------------------------- % 4610 ! ! ! 4621637022 00010 % 4611 !SYNCHRONIZED ! - ! MIRROR - 100 % 00011 % ----------------------------------------------------------------------------- % 4612 ! ! ! 4621637022 00012 % 4613 !SPLIT ! 96.02:02:03! COPY - 100 % 00013 % -----------------------------------------------------------------------------%
/SHOW-CLONE-SESSION-STATUS UNIT=4D80 % ----------------------------------------------------------------------------- % UNIT VOLUME! ! !SERIAL-NO LOG-VOL % ----------------------------------------------------------------------------- % CLON- VOLUME!STATE !ACTIVE-FOR !TYPE CONT- PERCENT- % UNITS ! !DDDD.HH:MM:SS! COPY COPIED % ============================================================================= % 4D80 TOBI.0! ! ! 4621637022 002AC % 4D82 TOBI.0!SPLIT ! 0.00:20:50! COPY Y 100 % 002AE % -----------------------------------------------------------------------------
/SHOW-CLONE-SESSION-STATUS UNIT=4DC0,INFORMATION=*CONTINUOUS-COPY % ----------------------------------------------------------------------------- % ! PRIMARY ! SECONDARY % UNIT VOLUME!LOG-VOL SERIAL-NO MODE !LOG-VOL SERIAL-NO MODE % ! CLUSTER-NAME ! PHASE STATUS % ----------------------------------------------------------------------------- % CLONE VOLUME! LOG-VOL STATE %COPIED! LOG-VOL STATE %COPIED % ----------------------------------------------------------------------------- % ! ACTIVE-FOR ! ACTIVE-FOR % ============================================================================= % 4DC0 T2H1.0!002BC 4621637022 ACTIVE !00228 4631508013 STANDBY % ! AF_DX8_02 ! NORMAL NORMAL % 4DC6 T2HC.0! 002C2 SPLIT 51%! 0022E SPLIT 51% % ! 167.00:28:21 ! 167.00:28:21 % 4DC4 T2HB.0! 002C0 SPLIT 52%! 0022C SPLIT 52% % ! 167.00:47:52 ! 167.00:47:53 % -----------------------------------------------------------------------------
Outputs for Symmetrix/VMAX3
/SHOW-CLONE-SESSION-STATUS UNIT=*BY-SYMMETRIX(SERIAL-NUMBER=207) % ----------------------------------------------------------------------------- % UNIT VOLUME! ! !SERIAL-NO LOG-VOL % ----------------------------------------------------------------------------- % CLON- VOLUME!STATE !ACTIVE-FOR !INDIRECT SIZE PERCENT- BACK/ % UNITS ! !DDD.HH:MM:SS!UNIT CLONE COPIED DIFF % ============================================================================== % 260A ! ! !000190100207 0004D % 26D2 !CREATED ! - !7734 MB 7734 MB 0 % 0016F Y/Y % ----------------------------------------------------------------------------- % 260B ! ! !000190100207 0004E % 26D3 !CREATED ! - !7734 MB 7734 MB 0 % 00170 Y/Y % ----------------------------------------------------------------------------- % 260C ! ! !000190100207 0004F % 26D4 !CREATED ! - !7734 MB 7734 MB 0 % 00171 Y/Y % ----------------------------------------------------------------------------- % 260D ! ! !000190100207 00050 % 26D5 !PRECOPY ! - ! 0 MB 0 MB 100 % 00172 Y/N % ----------------------------------------------------------------------------- % 260E ! ! !000190100207 00051 % 26D6 !PRECOPY ! - ! 0 MB 0 MB 100 % 00173 Y/N % ----------------------------------------------------------------------------- % 2804 ! ! !000190100207 002DD % 2807 !RECREATED ! - ! 0 MB 0 MB 100 % 002E0 Y/Y % 2806 !RECREATED ! - ! 1 MB 1 MB 99 % 002DF Y/Y % 2805 !COPIED !176.23:57:25! 0 MB 0 MB 100 % 002DE Y/Y % ----------------------------------------------------------------------------- % 28E1 ! ! !000190100207 0041A % 28E8 !CREATED ! - !3984 MB 3984 MB 0 % 00421 Y/Y % 28E7 !CREATED ! - !3984 MB 3984 MB 0 % 00420 Y/Y % 28E3 !CREATED ! - !3984 MB 3984 MB 0 % 0041C Y/Y % 28E2 !CREATED ! - !3984 MB 3984 MB 0 % 0041B Y/Y % -----------------------------------------------------------------------------
Meaning of the output columns (in alphabetical order)
Keyword | Meaning | with INF= | ||||||||||||||||||||||||||
| Time since activation ( | *STD *CONT-C | ||||||||||||||||||||||||||
| Setting of the clone pair for copying in the background (Symmetrix/VMAX3 only)
| *STD | ||||||||||||||||||||||||||
CLONE | see CLONE-UNITS | *CONT-C | ||||||||||||||||||||||||||
| MN of a clone unit or internal number of the logical volume in the storage system (5-character if the 1st character is not 0 (VMAX3) or with prefix #) | *STD | ||||||||||||||||||||||||||
CLUSTER-NAME | Name of the storage cluster | *CONT-C | ||||||||||||||||||||||||||
| Using the Continuous Copy function for the volume
| *STD | ||||||||||||||||||||||||||
| Setting of the clone pair for the
| *STD | ||||||||||||||||||||||||||
| Still unchanged on the unit concerned / for the particular status (in MB or GB) | *STD | ||||||||||||||||||||||||||
| Internal number of the logical volume in the storage system | *STD *CONT-C | ||||||||||||||||||||||||||
MODE | Operating status of the primary or secondary storage system in the storage cluster
| *CONT-C | ||||||||||||||||||||||||||
| Copied or remaining data volume in percent. Clone units can be completely copied and still show 99%, due to a short assignement by BS2000 during the seperation of original and clone unit. | *STD | ||||||||||||||||||||||||||
PHASE | Operating status of the storage cluster
| *CONT-C | ||||||||||||||||||||||||||
| Serial number of the storage system | *STD *CONT-C | ||||||||||||||||||||||||||
| Device status.
| *STD *CONT-C | ||||||||||||||||||||||||||
STATUS | Status des Storage Clusters
| *CONT-C | ||||||||||||||||||||||||||
| Selected clone type (and thus also the replication function)
| *STD | ||||||||||||||||||||||||||
| MN of a unit or internal number of the logical volume in the storage system (5-character if the 1st character is not 0 (VMAX3) or with prefix #). | *STD *CONT-C | ||||||||||||||||||||||||||
| VSN of a unit | *STD *CONT-C | ||||||||||||||||||||||||||
%COPIED | copied data amount in percent | *CONT-C |
S variables
The S variables are identical for all storage systems; not all values are necessarily supplied.
Output information | Name of the S variable | T | Contents | Condition INF= |
Period since a clone unit was activated, format | var(*LIST).CLONE-UNIT(*LIST).ACTIVE-FOR | S | '' | *STD |
Setting for copying in the background (Symmetrix/VMAX3) | var(*LIST).CLONE-UNIT(*LIST).BACKG-COPY | S | Y | *STD |
Unchanged data on the clone unit during the *COPY-ON-ACCESS status or data that is still to be restored (in MB) (Symmetrix/VMAX3) | var(*LIST).CLONE-UNIT(*LIST).CLONE-INDIRECT-SIZE | I | <integer 0..268435456> | *STD |
Selected clone type (and replication function) | var(*LIST).CLONE-UNIT(*LIST).CLONE-TYPE | S | COPY | *STD |
Using the Continuous Copy function for the volume | var(*LIST).CLONE-UNIT(*LIST).CONTINUOUS-COPY | S | '' | *STD |
Setting for reconstruction and restart | var(*LIST).CLONE-UNIT(*LIST).DIFFERENTIAL | S | Y | *STD |
Internal number of the logical volume | var(*LIST).CLONE-UNIT(*LIST).LOGIC-VOL | S | '' | *STD |
Data copied to the clone unit in percent | var(*LIST).CLONE-UNIT(*LIST).PERCENT-COPIED | I | <Integer 0..100> | *STD |
First copy process after the start of the clone session has been completed, unit has been copied in full onto the clone unit (does not mean that the clone pair is synchronous) (Symmetrix/VMAX3) | var(*LIST).CLONE-UNIT(*LIST).PRECOPIED | S | Y | *STD |
Timestamp since a clone unit in primary storage system with fromat DDDD.HH:MM:SS without leading zeros was activated. | var(*LIST).CLONE-UNIT(*LIST).PRIMARY.ACTIVE-FOR | S | '' <c-string 13..13> | *CONT-C |
Internal number of a logical volume | var(*LIST).CLONE-UNIT(*LIST).PRIMARY.LOGIC-VOL | S | '' <c-string 1..5> | *CONT-C |
copied data on the clone unit in the primary storage system in percent | var(*LIST).CLONE-UNIT(*LIST).PRIMARY.PERCENT-COPIED | I | <Integer 0..100> | *CONT-C |
Device status of a clone-unit on primary storage system (see INF=*STD) | var(*LIST).CLONE-UNIT(*LIST).PRIMARY.STA | S | *RESTORE-IN-PROGRESS *SPLIT *SYNCHRONIZING *SYNCHRONIZED *FAILED | *CONT-C |
Timestamp since a clone unit in secondary storage system with fromat DDDD.HH:MM:SS without leading zeros was activated. | var(*LIST).CLONE-UNIT(*LIST).SECONDARY.ACTIVE-FOR | S | '' <c-string 13..13> | *CONT-C |
Internal number of a logical volume | var(*LIST).CLONE-UNIT(*LIST).SECONDARY.LOGIC-VOL | S | '' <c-string 1..5> | *CONT-C |
copied data on the clone unit in the secondary storage system in percent | var(*LIST).CLONE-UNIT(*LIST).SECONDARY.PERCENT-COPIED | I | <Integer 0..100> | *CONT-C |
Device status of a clone-unit on secondary storage system (see INF=*STD) | var(*LIST).CLONE-UNIT(*LIST).SECONDARY.STA | S | *RESTORE-IN-PROGRESS *SPLIT *SYNCHRONIZING *SYNCHRONIZED *FAILED | *CONT-C |
Device status of a clone unit | var(*LIST).CLONE-UNIT(*LIST).STA | S | *CREATE-IN-PROGRESS | *STD |
MN of a clone unit | var(*LIST).CLONE-UNIT(*LIST).UNIT | S | '' | *STD *CONT-C |
Unchanged data on the unit (in MB) (Symmetrix/VMAX3) | var(*LIST).CLONE-UNIT(*LIST).UNIT-PROTECTED-SIZE | I | <integer 0..268435456> | *STD |
VSN of a clone unit | var(*LIST).CLONE-UNIT(*LIST).VOL | S | '' | *STD *CONT-C |
Name of the storage cluster | var(*LIST).CLUSTER-NAME | S | <c-string 0..16> | *CONT-C |
Operating status of the Storage Cluster | var(*LIST).CLUSTER-PHASE | S | *NORMAL | *CONT-C |
Operating status of the primary storage system | var(*LIST).CLUSTER-STATUS | S | *NORMAL *DISABLED *HALT *UNKNOWN | *CONT-C |
Number of assigned clone units | var(*LIST).NUM-OF-CLONE-UNITS | I | <integer 0..65535> | |
Operating status of the primary storage system *ACTIVE: Active storage system *STANDBY: Standby storage system *NONE: No operating status *UNKNOWN: Unknown operating status | var(*LIST).PRIMARY.MODE | S | *ACTIVE *STANDBY *NONE *UNKNOWN | *CONT-C |
Serial number of the primary storage system | var(*LIST).PRIMARY.SERIAL-NO | S | '' <c-string 3..14> | *CONT-C |
Internal number of the volume in the primary storage system | var(*LIST).PRIMARY.UNIT-LOGIC-VOL | S | '' <c-string 1..5> | *CONT-C |
Operating status of the secondary storage system *ACTIVE: Active storage system *STANDBY: Standby storage system *NONE: No operating status *UNKNOWN: Unknown operating status | var(*LIST).SECONDARY.MODE | S | *ACTIVE *STANDBY *NONE *UNKNOWN | *CONT-C |
Serial number of the secondary storage system | var(*LIST).SECONDARY.SERIAL-NO | S | '' <c-string 3..14> | *CONT-C |
Internal number of the volume in the secondary storage system | var(*LIST).SECONDARY.UNIT-LOGIC-VOL | S | '' <c-string 1..5> | *CONT-C |
Serial number of the storage system | var(*LIST).SERIAL-NO | S | '' | *STD |
MN of a unit | var(*LIST).UNIT | S | '' | *STD *CONT-C |
Internal number of the logical volume | var(*LIST).UNIT-LOGIC-VOL | S | '' | *STD |
VSN of a unit | var(*LIST).UNIT-VOL | S | '' | *STD *CONT-C |
Command return codes
(SC2) | SC1 | Maincode | Meaning |
0 | CMD0001 | Command executed successfully | |
1 | CMD0202 | Syntax error | |
32 | NDE2002 | Internal error | |
64 | CMD0087 | Function not permitted in the current input mode or with the current task privileges | |
64 | CMD0216 | Required privilege not available | |
64 | NDE1000 | Device not found or not in the storage system | |
64 | NDE1001 | Device not attached | |
64 | NDE1002 | Controller not found | |
64 | NDE1003 | Data medium not online or not unique | |
64 | NDE1004 | Pubset not found or wrong pubset type | |
64 | NDE1010 | Enginuity version is not supported (too low) | |
64 | NDE1043 | Pubset type not supported | |
64 | NDE1100 | Invalid pubset state | |
64 | NDE1114 | Serial number not found | |
64 | NDE1115 | Serial number not unique | |
64 | NDE1116 | Storage system’s logical volume not found | |
64 | NDE1119 | No target unit found | |
64 | NDE1125 | Initialization of storage system information running | |
64 | NDE1126 | Device unknown or storage system not supported | |
64 | NDE1127 | Device of a storage system is not supported | |
64 | NDE1128 | At least one unit from system is not Symmetrix/VMAX3 | |
64 | NDE1150 | No gatekeeper device found | |
64 | NDE1800 | Device not found or not in the storage system | |
64 | NDE1810 | Storage system’s operating system version not supported | |
64 | NDE1814 | Storage system’s serial number not found | |
64 | NDE1815 | Storage system’s serial number not unique | |
64 | NDE1816 | Storage system’s logical volume not found | |
64 | NDE1890 | Management instance not found | |
64 | NDE1702 | Connection to SYMAPI server aborted | |
64 | NDE2000 | Execution partially successful | |
64 | NDE2001 | Command not executed | |
64 | NDE2006 | No output information available | |
64 | NDE2011 | Symmetrix license not entered | |
130 | NDE1082 | Memory bottleneck during processing of command |