SHC-OSD V15.0 (en)

&pagelevel(3)&pagelevel

Storage system:	ETERNUS DX/AF
Domain:	DEVICE
Privileges:	TSOS, OPERATING, HW-MAINTENANCE, SW-MONITOR-ADMINISTRATION, HSMS-ADMINISTRATION
Routing code:	@

/SHOW-CLONE-SESSION-STATUS provides information on the status of clone pairs in storage systems.

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.

The command supports structured output to S variables (for further information, see the manual “Commands” [1]).

SHOW-CLONE-SESSION-STATUS

UNIT = BY-VOLUME(...) / BY-PUBSET(...) / *BY-STORAGE(...) /
			list-poss(24): <alphanum-name 1..4 with-wildcards>
	*BY-VOLUME(...)
		\|	VOLUME = list-poss(24): <vsn 1..6>
	*BY-PUBSET(...)
		\|	PUBSET = list-poss(24): <cat-id 1..4>
	*BY-STORAGE(...)
		\|	SERIAL-NUMBER = *ALL / <alphanum-name 3..14>
		\|	,LOGICAL-VOLUME = *ALL / <x-text 1..4>
,SELECT = ALL-PRESEL ECTED / BY-ATTRIBUTES(...)
	*BY-ATTRIBUTES(...)
		\|	,REMOTE-COPY-USE = STD / TARGET-UNIT
		\|	,DEVICE = ALL-PRESEL ECTED / ALL-DEFINED / ATTACHED / DETACHED / *ANY
,UPDATE = STD / NO /* *DISCOVER
,CLONE-TYPE = ANY / COPY / *MIRROR
,INFORMATION = STD / CONTINUOUS-COPY

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-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-STORAGE(...)
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=
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.
The selection can only be made if the target unit is unique. Concurrent remote copy is not supported in the output.

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 =
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 =
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=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     
%  -----------------------------------------------------------------------------

Meaning of the output columns (in alphabetical order)

Keyword

Meaning

with INF=

ACTIVE-FOR

Time since activation (/ACTIVATE-CLONE), format: DDD.HH:MM:SS. The ACTIVE-FOR value displays the time between the current BS2000 time and the timestamp in the storage system, when the clone has been synchronized. To display the correct value for ACTIVE-FOR the time of BS2000 and the storage system must be synchronous.

*STD
*CONT-C

CLONE see CLONE-UNITS *CONT-C

CLONE UNITS

MN of a clone unit or internal number of the logical volume in the storage system

*STD

CLUSTER-NAME Name of the storage cluster *CONT-C

CONT-COPY

Using the Continuous Copy function for the volume

`Y`	Function is used
–	Function is not used

*STD

LOG-VOL

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

`ACTIVE`	Active storage system
`STANDBY`	Standby storage system
`NONE`	No operating status
`UNKNOWN`	Unknown operating status

*CONT-C

PERCENT-COPIED

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

`NORMAL`	synchronized operating
`DISABLED`	Cluster deactivated
`INITIALIZED`	Cluster initialized, no volumes
`MAINTENANCE`	clone sessions are beeing cleaned
`FAILED`	Synchronisation not possible
`FAILED-OVER`	Failover executed
`COPYING`	Synchronisation for secondary storage system running
`COPYING-BACK`	Synchronisation for primary storage system running
`FAILBACK-READY`	Ready for failback
`FAILED-BACK`	failback executed
`UNKNOWN`	network problem

*CONT-C

SERIAL-NO

Serial number of the storage system

*STD
*CONT-C

STATE

Device status.

`REST-IN-PROG`	Unit being reconstructed from the clone unit, data will be copied from the clone unit to the unit, no separate processing (only ETERNUS DX/AF with QuickOPC)
`SPLIT`	Clone unit is connected to a unit n and is `READY`, separate processing
`SYNCHRONIZING`	Unit is copied to clone unit, the clone unit is `NOT-READY`, no separate processing (ETERNUS DX/AF only)
`SYNCHRONIZED`	The clone pair is synchronized, the clone unit is `NOT-READY`, no separate processing (ETERNUS DX/AF with EC only)
`FAILED`	Error state

*STD
*CONT-C

STATUS

Status des Storage Clusters

`NORMAL`	Normal operating
`DISABLED`	Deactivated
`HALT`	Error in storage cluster, see `HALT-FACTOR`
`UNKNOWN`	Unknown

*CONT-C

TYPE

Selected clone type (and thus also the replication function)

`COPY`	complete copy (QuickOPC)
`MIRROR`	mirrored copy (EC)

*STD

UNIT

MN of a unit or internal number of the logical volume in the storage system

*STD

*CONT-C

VOLUME

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 `DDDD.HH:MM:SS` without leading zeros	var(LIST).CLONE-UNIT(LIST).ACTIVE-FOR	S	'' <c-string 13..13>	*STD
Selected clone type (and replication function) COPY: complete copy (QuickOPC) MIRROR: mirrored copy (EC)	var(LIST).CLONE-UNIT(LIST).CLONE-TYPE	S	COPY MIRROR	*STD
Using the Continuous Copy function for the volume	var(LIST).CLONE-UNIT(LIST).CONTINUOUS-COPY	S	'' Y	*STD
Internal number of the logical volume	var(LIST).CLONE-UNIT(LIST).LOGIC-VOL	S	'' <c-string 1..5>	*STD
Data copied to the clone unit in percent	var(LIST).CLONE-UNIT(LIST).PERCENT-COPIED	I	<Integer 0..100>	*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 RESTORE-IN-PROGRESS: Copying from the clone unit to the unit (after /RESTORE-FROM-CLONE) (ETERNUS DX/AF with QuickOPC) SPLIT: Clone pair being separated after reconstruction SYNCHRONIZING: Unit is being copied to clone unit (ETERNUS DX/AF) SYNCHRONIZED: Clone pair is synchronized (ETERNUS DX/AF with EC) *FAILED: Error state	var(LIST).CLONE-UNIT(LIST).STA	S	RESTORE-IN-PROGRESS SPLIT SYNCHRONIZING SYNCHRONIZED *FAILED	*STD
MN of a clone unit	var(LIST).CLONE-UNIT(LIST).UNIT	S	'' <mnemo-name>	STD CONT-C
VSN of a clone unit	var(LIST).CLONE-UNIT(LIST).VOL	S	'' <vsn>	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 NORMAL: Synchronous operation DISABLED: Cluster disabled INITIALIZED: Cluster initialized but no volumes yet MAINTENANCE: Clone sessions are cleared FAILED: Synchronization not possible FAILED-OVER: Failover executed COPYING: Synchronization to secondary storage system in progress COPYING BACK: Synchronization to primary storage system in progress FAILBACK-READY: Ready for failback FAILED-BACK: Failback executed *UNKNOWN: Network problem	var(*LIST).CLUSTER-PHASE	S	NORMAL DISABLED INITIALIZED MAINTENANCE FAILED FAILED-OVER COPYING COPYING-BACK FAILBACK-READY FAILED-BACK *UNKNOWN	*CONT-C
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).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	'' <c-string 3..14>	*STD
MN of a unit	var(*LIST).UNIT	S	'' <mnemo-name>	STD CONT-C
Internal number of the logical volume	var(*LIST).UNIT-LOGIC-VOL	S	'' <c-string 1..5>	*STD
VSN of a unit	var(*LIST).UNIT-VOL	S	'' <vsn>	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	NDE1043	Pubset type not supported
	64	NDE1100	Invalid pubset state
	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	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	NDE2000	Execution partially successful
	64	NDE2001	Command not executed
	64	NDE2006	No output information available
	130	NDE1082	Memory bottleneck during processing of command

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-CLONE-SESSION-STATUS Displays the status of clone pairs

Output for clone pairs

Outputs for ETERNUS DX/AF

Meaning of the output columns (in alphabetical order)

S variables