Storage system: | ETERNUS DX/AF |
Domain: | DEVICE |
Privileges: | TSOS, OPERATING, HW-MAINTENANCE, |
Routing code: | @ |
displays information on the status of remote copy pairs and remote links and on the operating parameters set for all supported remote copy configurations.
/SHOW-REMOTE-COPY-STATUS
The remote copy status can be: ACTIVE
, ERROR
, IN-HOLD
or BROKEN
. The status is dependent on the availability of the physical source units, target units and (at least) one remote link. In other words, the physical volumes that contain the source or target units must be ready for operation; it does not mean that the source or target units can be addressed from the host. For more details see also section "Remote copy status".
The command supports structured output to S variables (for further information, see the manual “Commands” [1]).
SHOW-REMOTE-COPY-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-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 of the storage system and the internal number of the logical volume.
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 = *ALL-SOURCE-UNITS
Selects all source units of the storage system.
LOGICAL-VOLUME = *ALL-TARGET-UNITS
Selects all target units 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 =
The set of units can be selected according to the remote copy status, access path, synchronization, link status, copy mode and the remote copy parameter ON-ERROR
.
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.
REMOTE-COPY-STATUS =
Outputs information only on remote copy pairs with the specified remote copy status.
REMOTE-COPY-STATUS = *ANY
Outputs information on all remote copy pairs regardless of their remote copy status.
REMOTE-COPY-STATUS = *ACTIVE
Outputs information only on ACTIVE
remote copy pairs.
REMOTE-COPY-STATUS = *IN-HOLD
Outputs information only on remote copy pairs in the remote copy status IN-HOLD
.
REMOTE-COPY-STATUS = *ERROR
Outputs information only on remote copy pairs with the remote copy status ERROR
.
TARGET-ACCESS =
Outputs information only on remote copy pairs with the specified access path.
TARGET-ACCESS = *ANY
Outputs information on all remote copy pairs regardless of the access path set.
TARGET-ACCESS = *BY-SOURCE
Outputs information on all remote copy pairs with the BY-SOURCE
access path.
TARGET-ACCESS = *DIRECT
Outputs information on all remote copy pairs with the DIRECT
access path.
TARGET-ACCESS = *NONE
Outputs information on all remote copy pairs with no access path to the target unit.
SYNCHRONIZED =
Outputs information on the remote copy pairs depending on their synchronization.
SYNCHRONIZED = *ANY
Outputs information on all remote copy pairs regardless of their synchronization.
SYNCHRONIZED = *YES
Outputs information only on synchronized remote copy pairs.
SYNCHRONIZED = *NO
Outputs information only on non-synchronized remote copy pairs.
LINK-STATUS =
Outputs information only on remote copy pairs with the specified availability of the remote link.
LINK-STATUS = *ANY
Outputs information on all remote copy pairs regardless of the availability of their remote link.
LINK-STATUS = *AVAILABLE
Outputs information only on remote copy pairs whose remote link is available.
LINK-STATUS = *NOT-AVAILABLE
Outputs information only on remote copy pairs whose remote link is not available.
COPY-MODE =
Outputs information only on remote copy pairs with the specified copy mode.
COPY-MODE = *ANY
Outputs information on all remote copy pairs regardless of their copy mode.
COPY-MODE = *SYNCHRONOUS
Outputs information only on remote copy pairs with the copy mode SYNCHRONOUS
.
COPY-MODE = *ASYNCHRONOUS
Outputs information only on remote copy pairs with the copy mode ASYNCHRONOUS
.
COPY-MODE = *ASYNC-STACK
Outputs information only on remote copy pairs with the copy mode ASYNC-STACK
(stack mode, asynchronous REC).
COPY-MODE = *ASYNC-THROUGH
Outputs information only on remote copy pairs with the copy mode ASYNC-THROUGH
(through mode, asynchronous REC).
DEVICE =
Outputs information on units with the specified status in BS2000.
DEVICE = *ALL-PRESELECTED
Outputs information on all units in accordance with the global setting for SHC-OSD (value of DEVICE-PRESELECTION
in the output of /SHOW-SHC-PROCESSING
).
DEVICE = *ALL-DEFINED
Selects all units generated in BS2000.
DEVICE = *DETACHED
Selects all units generated in BS2000 which are detached.
DEVICE = *ATTACHED
Selects all units attached in BS2000.
DEVICE = *ANY
Selects all devices of the storage system specified with UNIT
.
INFORMATION =
Determines the scope of the information which is output.
A header line is output followed by a line with the corresponding values for each unit, see the examples for the command.
The information shown always relates to the remote copy pairs selected with SELECT=...
.
INFORMATION = *SUMMARY
Summary information is output on the mnemonic names of the source and target units, the remote copy status, the access path, the state of the source and target units, the remote link and the synchronization state of the source and the target units.
The information output reflects the view on the remote copy pair and not on an individual unit. Detailed information about a unit is supplied by /SHOW-STORAGE-DEVICE-CONFIG
(see "SHOW-STORAGE-DEVICE-CONFIG Displays the device configuration (ETERNUS DX/AF)")
INFORMATION = *PORT-STATUS
Outputs information on the status of the remote links for the remote copy pairs.
INFORMATION = *ALL
Outputs all information specified for *SUMMARY
and *PORT-STATUS
.
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.
Examples for ETERNUS DX/AF
/SHOW-REMOTE-COPY-STATUS UNIT=2204,INFORMATION=*PORT-STATUS % ----------------------------------------------------------------------------- % SRC TAR !SOURCE: !TARGET: !CONN % UNIT UNIT ! SERIAL-NO PORT-NAME ! SERIAL-NO PORT-NAME !-STA % ============================================================================= % 2304 2204! 4531125002 FCP_CM00CA01P00 ! 4531107011 FCP_CM00CA01P00 ! UP % ! 4531125002 FCP_CM01CA01P00 ! 4531107011 FCP_CM01CA01P00 ! UP % -----------------------------------------------------------------------------
/SHOW-REMOTE-COPY-STATUS UNIT=9A01,INFORMATION=*ALL % ----------------------------------------------------------------------------- % SRC TAR VOLUME!REMOTE-COPY TARGET!LAST-STA-CHNG!LINK !SYNC!SRC!CON!CAS % UNIT UNIT !STATE MODE ACCESS!DDDD.HH:MM:SS! ! !-RA!R-C!R-C % ============================================================================= % 9A01 9C01 S351.1!IN-HOLD SYNC DIRECT! 183.19:31:08!AVAIL.! 99%! - !NO ! - % ----------------------------------------------------------------------------- % SRC TAR !SOURCE: !TARGET: !CONN % UNIT UNIT ! SERIAL-NO PORT-NAME ! SERIAL-NO PORT-NAME !-STA % ============================================================================= % 9A01 9C01! 4621347002 FCP_CM00CA00P00 ! 4621349005 FCP_CM01CA01P03 ! UP % ! 4621347002 FCP_CM01CA01P03 ! 4621349005 FCP_CM00CA00P00 ! UP % -----------------------------------------------------------------------------
Examples for concurrent remote copy
With concurrent target units, two lines with the different target units are output for each source unit.
ETERNUS DX/AF (REC)
/SHOW-REMOTE-COPY-STATUS UNIT=9A40,INFORMATION=*ALL % ----------------------------------------------------------------------------- % SRC TAR VOLUME!REMOTE-COPY TARGET!LAST-STA-CHNG!LINK !SYNC!SRC!CON!CAS % UNIT UNIT !STATE MODE ACCESS!DDDD.HH:MM:SS! ! !-RA!R-C!R-C % ============================================================================= % 9A40 9C40 S3SN.0!IN-HOLD ASYN DIRECT! 128.01:52:13!AVAIL.! 89%! - !YES! - % 9A40 BD20 S3SN.0!ACTIVE SYNC BY-SRC! - !AVAIL.! 33%! - !YES! - % ----------------------------------------------------------------------------- % SRC TAR !SOURCE: !TARGET: !CONN % UNIT UNIT ! SERIAL-NO PORT-NAME ! SERIAL-NO PORT-NAME !-STA % ============================================================================= % 9A40 9C40! 4621347002 FCP_CM00CA00P00 ! 4621349005 FCP_CM01CA01P03 ! UP % ! 4621347002 FCP_CM01CA01P03 ! 4621349005 FCP_CM00CA00P00 ! UP % ----------------------------------------------------------------------------- % 9A40 BD20! 4621347002 FCP_CM00CA01P03 ! 4621351008 FCP_CM00CA01P03 ! UP % ! 4621347002 FCP_CM01CA00P00 ! 4621351008 FCP_CM01CA00P00 ! UP % -----------------------------------------------------------------------------
Example for cascaded remote copy (ETERNUS DX/AF)
With cascaded remote copy two lines are output when a cascading unit is specified. The cascading unit of the line is displayed in the last column. When non-cascading units are specified, only a line with a remote copy pair is output.
/SHOW-REMOTE-COPY-STATUS UNIT=9C41,INFORMATION=*ALL % ----------------------------------------------------------------------------- % SRC TAR VOLUME!REMOTE-COPY TARGET!LAST-STA-CHNG!LINK !SYNC!SRC!CON!CAS % UNIT UNIT !STATE MODE ACCESS!DDDD.HH:MM:SS! ! !-RA!R-C!R-C % ============================================================================= % 9A41 9C41 S3SN.1!IN-HOLD ASYN DIRECT! 9.00:57:30!AVAIL.! 87%! - !NO !TAR % 9C41 BD21 S3Y4.1!IN-HOLD SYNC DIRECT! 0.04:15:08!AVAIL.!100%! - !NO !SRC % ----------------------------------------------------------------------------- % SRC TAR !SOURCE: !TARGET: !CONN % UNIT UNIT ! SERIAL-NO PORT-NAME ! SERIAL-NO PORT-NAME !-STA % ============================================================================= % 9A41 9C41! 4621347002 FCP_CM00CA00P00 ! 4621349005 FCP_CM01CA01P03 ! UP % ! 4621347002 FCP_CM01CA01P03 ! 4621349005 FCP_CM00CA00P00 ! UP % ----------------------------------------------------------------------------- % 9C41 BD21! 4621349005 FCP_CM00CA00P01 ! 4621351008 FCP_CM00CA00P01 ! UP % ! 4621349005 FCP_CM01CA00P01 ! 4621351008 FCP_CM01CA00P01 ! UP % -----------------------------------------------------------------------------
Example for asynchronous processing mode
ETERNUS DX/AF (REC)
/SHOW-REMOTE-COPY-STATUS UNIT=*BY-STORAGE(SERIAL-NUMBER=7002), SELECT=*BY-ATTRIBUTES(COPY-MODE=*ASYNCHRONOUS),INFORMATION=*SUMMARY % --------------------------------------------------------------------------- % SRC TAR VOLUME!REMOTE-COPY TARGET!LAST-STA-CHNG!LINK !SYN!SRC!CON!CAS % UNIT UNIT !STATE MODE ACCESS!DDDD.HH:MM:SS! !CH !-RA!R-C!R-C % =========================================================================== % 9A40 9C40 S3SN.0!IN-HOLD ASYN DIRECT! 497.21:00:52!AVAIL.! 89%! - !YES! - % 9A41 9C41 S3SN.1!IN-HOLD ASYN DIRECT! 497.21:00:52!AVAIL.! 87%! - !NO !TAR
The last status change (LAST-STA-CHNG
) in remote copy status IN-HOLD
is output for ETERNUS DX/AF.
Meaning of the output columns (in alphabetical order)
Keyword | Meaning | with INF = | ||||||||
| Status of the remote link between the storage systems
|
| ||||||||
| concurrent remote copy
|
| ||||||||
| Time since the last action for halting or resuming replication in the format For a correct output of the value |
| ||||||||
| State of the remote links.
|
| ||||||||
| Name of the port |
| ||||||||
| Processing mode
|
| ||||||||
| Remote copy status
|
| ||||||||
| Serial number of the storage system |
| ||||||||
| This output column contains data of the local storage system: see |
| ||||||||
| MN of the first emulated controller (on the storage system with the source unit) / Serial number of the storage system with the source unit |
| ||||||||
| MN or internal numbers of the logical volume in the local storage system |
| ||||||||
| Synchronization value of a remote copy pair (0..100%, ETERNUS DX/AF)
|
| ||||||||
| MN or internal number of the logical volume in the remote storage system |
| ||||||||
| This output column contains data of the remote storage system: see |
| ||||||||
| Access path to the data of a remote copy pair
|
| ||||||||
| VSN of the (logical) volume |
|
S variables
Output information | Name of the S variable | T | Contents | Condition |
MN of the first emulated controller (with the source unit). | var(*LIST).LINK.SOURCE-CONTR-UNIT1 | S | '' | *ALL |
MN of the first emulated controller (with the target unit) | var(*LIST).LINK.TARGET-CONTR-UNIT1 | S | '' | *ALL |
Internal number of the logical volume | var(*LIST).SOURCE-LOGIC-VOL | S | '' | *PORT-STA |
Port name in the storage system with the source unit (when | var(*LIST).SOURCE-PORT(*LIST).NAME | S | <c-string 1..24> | *PORT-STA |
Serial number of the storage system with the source unit | var(*LIST).SOURCE-SERIAL-NO | S | '' | *PORT-STA |
MN of the source unit | var(*LIST).SOURCE-UNIT | S | '' | *PORT-STA |
cascaded remote copy | var(*LIST).SUMM.CASCADED-RDF | S | *NO | *SUM |
concurrent remote copy | var(*LIST).SUMM.CONCURR-TARGET | S | *YES | *SUM |
Is the data consistent after the split? | var(*LIST).SUMM.CONSISTENT-DATA | S | *YES | *SUM |
Time since the last action for halting or resuming replication in the format For a correct output of the value | var(*LIST).SUMM.LAST-STA-CHANGE | S | <c-string 13..13> | *SUM |
State of the remote links. | var(*LIST).SUMM.LINK-STA | S | '' | *SUM |
Number of ports in the storage system with the source unit (ETERNUS DX/AF) | var(*LIST).SUMM.NUM-OF-SOURCE-PORTS | I | <integer 0..4> | *SUM |
Number of ports in the storage system with the target unit (ETERNUS DX/AF) | var(*LIST).SUMM.NUM-OF-TARGET-PORTS | I | <integer 0..4> | *SUM |
Synchronization value (ETERNUS DX/AF). | var(*LIST).SUMM.PERCENT-COPIED | I | <integer 0..100> | *SUM |
Remote copy mode: | var(*LIST).SUMM.REM-COPY-MODE | S | *SYNCH | *SUM |
Remote copy status | var(*LIST).SUMM.REM-COPY-STA | S | *ACTIVE | *SUM |
State of synchronization. | var(*LIST).SUMM.REM-COPY-SYNCH | S | *YES | *SUM |
Access path to the data of a remote copy pair. | var(*LIST).SUMM.TARGET-ACCESS | S | *BY-SOURCE | *SUM |
Internal number of the logical volume | var(*LIST).TARGET-LOGIC-VOL | S | '' | *PORT-STA |
Status of the link between the storage systems (ETERNUS DX/AF) | var(*LIST).TARGET-PORT(*LIST).CONN-STA | S | *UP | *PORT-STA |
Port name in the storage system with the target unit (when | var(*LIST).TARGET-PORT(*LIST).NAME | S | '' | *PORT-STA |
Serial number of the storage system with the target unit | var(*LIST).TARGET-SERIAL-NO | S | '' | *PORT-STA |
MN of the target unit | var(*LIST).TARGET-UNIT | S | '' | *PORT-STA |
VSN of the volume | var(*LIST).VOL | S | '' | *PORT-STA |
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 | NDE1020 | No remote copy function for the specified unit | |
64 | NDE1024 | Remote controller not found | |
64 | NDE1100 | Invalid pubset state | |
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 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 | NDE2000 | Execution partially successful | |
64 | NDE2001 | Command not executed | |
64 | NDE2006 | No output information available | |
64 | NDE2012 | Illegal parameter combination | |
130 | NDE1082 | Memory bottleneck during processing of command |