Storage system: | ETERNUS DX/AF |
Domain: | DEVICE |
Privileges: | TSOS, OPERATING, HW-MAINTENANCE, |
Routing code: | @ |
provides information on the logical devices of the ETERNUS DX/AF storage systems. At least one unit from the storage system must be attached to permit mapping to the BS2000 devices.
/SHOW-STORAGE-DEVICE-CONFIG
The command supports structured output to S variables (for further information, see the manual “Commands” [1]).
SHOW-STORAGE-DEVICE-CONFIG | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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 storage array.
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 (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 units by means of the mnemonic names of the logical volume.
SELECT =
The set of units can be selected according to the configuration, devices, device type, status, RAID protection and use of local replication.
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.
CONFIGURATION =
Selects the configuration to be output.
CONFIGURATION = *STD
If a mnemonic device name, a VSN or a catalog ID was specified for the UNIT
operand, information is output only for the units specified.
CONFIGURATION = *RAID-GROUP
Outputs information on the unit selected with UNIT
and all other logical volumes contained in the same RAID group of a storage system.
This value may only be specified for individual units.
CONFIGURATION = *ALL-MIRRORS
Outputs information only on the unit selected with UNIT
and its assigned local mirror pairs (clone and snap units), if any exist.
This value may only be specified for individual units.
CONFIGURATION = *SNAP-PAIRS
Outputs information on the unit selected with UNIT
. If this is a unit from snap pairs, information on the original and snap units is output.
This value may only be specified for individual units.
CONFIGURATION = *CLONE-PAIRS
Outputs information on the unit selected with UNIT
. If this is a unit from clone pairs, information on the original and clone units is output.
This value may only be specified for individual units.
CONFIGURATION = *REMOTE-COPY-PAIRS
Outputs information on the unit selected with UNIT
. If this is a unit on remote copy pairs, information on the source and target units is output.
This value may only be specified for individual units.
CONFIGURATION = *SCO-PAIRS
Outputs information on the unit selected with UNIT
. If the unit is in a storage cluster, information about the whole SCO pair on primary and secondary side are displayed. The value must only be put our for single units.
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
.
TYPE =
Outputs information only on units with the specified emulated device type.
TYPE = *ANY
Outputs information on all units regardless of their emulated device type.
TYPE = <device>
Outputs information only on specific device types.
Only device types known to the system are accepted. In dialog mode, the valid device types can be displayed with TYPE=?
. Information can be output only for device types which are emulated in the storage system, in other words for TYPE=D3435/STDDISK
.
STATE =
Outputs information only on units with the specified state as seen by the storage system.
STATE = *ANY
Outputs information on all units regardless of their state as seen by the storage system.
STATE = *READY
Outputs information only on units with the state *READY
.
STATE = *NOT-READY
Outputs information only on units with the state *NOT-READY
.
STATE = *NO-ACCESS
Outputs information only on units with the *NO-ACCESS
state.
RAID-LEVEL =
Outputs information only on units with the specified RAID protection.
RAID-LEVEL = *ANY
Outputs information on all units regardless of their RAID protection.
RAID-LEVEL = *YES
Outputs information only on units with RAID protection.
RAID-LEVEL = *RAID0/*RAID1/*RAID10/*RAID5/*RAID6/*RAID6FR
Outputs information only on units with RAID protection according to RAIDx.
RAID-LEVEL = *NO
Outputs information only on units without RAID protection.
RAID-LEVEL = *FDEV
Outputs information only on flex volumes.
RAID-LEVEL = *TDEV
Outputs information only on Thin Provisioned Volumes (TPVs).
RAID-LEVEL = *VDEV
Outputs information only on Snap Data Volumes (SDVs).
Thin Devices or Flex Volumes that are used as snap units in a storage system ETERNUS DX/AF are not displayed here.
SNAP-USE =
Outputs information only on units with the specified use in snap pairs.
SNAP-USE = *ANY
Outputs information on all units irrespective of their use in snap pairs.
SNAP-USE = *YES
Outputs information only on units which form snap pairs (original units and snap units).
SNAP-USE = *ORIGINAL-UNIT
Outputs information only on original units.
SNAP-USE = *SNAP-UNIT
Outputs information only on snap units.
SNAP-USE = *NO
Outputs information only on units which are not used in snap pairs.
CLONE-USE =
Outputs information only on units with the specified use in clone pairs.
CLONE-USE = *ANY
Outputs information on all units irrespective of their use in clone pairs.
CLONE-USE = *YES
Outputs information only on units which form clone pairs (original units and clone units).
CLONE-USE = *ORIGINAL-UNIT
Outputs information only on original units.
CLONE-USE = *CLONE-UNIT
Outputs information only on clone units.
CLONE-USE = *NO
Outputs information only on units which are not used in clone pairs.
REMOTE-COPY-USE =
Outputs information only on units with the specified use in remote copy pairs.
REMOTE-COPY-USE = *ANY
Outputs information on all units irrespective of their use in remote copy pairs.
REMOTE-COPY-USE = *YES
Outputs information only on units which form remote copy pairs (source units and target units).
REMOTE-COPY-USE = *SOURCE-UNIT
Outputs information only on source units.
REMOTE-COPY-USE = *TARGET-UNIT
Outputs information only on target units.
REMOTE-COPY-USE = *NO
Outputs information only on units which are not used in remote copy pairs.
REMOTE-COPY-USE = *CONCURRENT-SOURCE-UNIT
Outputs information only on concurrent source units.
CLUSTER-USE = *ANY
Outputs information on all units irrespective of their use in a storage cluster.
CLUSTER-USE = *YES
Information is only output for units that are located in a storage cluster.
CLUSTER-USE = *PRIMARY
Information is only output for units that are located on the primary side of a storage cluster.
CLUSTER-USE = *SECONDARY
Information is only output for units that are located on the secondary side of a storage cluster.
CLUSTER-USE = *NO
Information is only output for units that are not located in a storage cluster.
INFORMATION =
Determines the scope of the information which is output.
A header is always 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 units selected with SELECT=
.
INFORMATION = *STD
Global device information is output, e.g. mnemonic name of the logical volume, VSN, BS2000 type, mnemonic name of the emulated controller, state, RAID level, local and remote replication, usable and maximum size of the volume.
INFORMATION = *PHYSICAL
Information on the mnemonic name of the logical volume and its VSN is output, plus information on the connection to the storage system, the channel address which is visible to the server and the affiliation to a RAID group.
The OWNING CONTR
output displays, also in the case of multipath connection, the so-called "owning controller" of the RAID group (storage pool) to which the volume belongs. The I/Os are always directed over the "owning controller"; I/Os to a non-"owning controller" are forwarded internally to the "owning controller". In the case of thin provisioning these is no information for the "owning controller" as the data can be distributed over multiple pools.
INFORMATION = *ALL
The information on *STD
and *PHYSICAL
is output.
INFORMATION = *THIN-DEVICES
Outputs information on Thin Provisioned Volumes (TPVs).
INFORMATION = *FLEX-DEVICES
When Automated Storage Tiering (AST) is used, the information on the devices of the flex pools is displayed.
UPDATE =
Controls updating of the configuration data provided.
UPDATE = *STD
The configuration data is updated in SHC-OSD before the SHOW command is executed.
UPDATE = *NO
The SHOW command is executed without the configuration data being updated in SHC-OSD.
UPDATE = *DISCOVER
Before the SHOW command is executed, the configuration data of the storage system is updated in management instance, StorMan and SHC-OSD. This enables you to recognize that it is available again after a crash and configuration changes to the storage system.
The update processes of the instances involved run asynchronously. The current configuration data may therefore possibly not be available when the command terminates, but only with a delay.
Examples
/SHOW-STORAGE-DEVICE-CONFIG SERIAL-NUMBER=1008,INFORMATION=*STD % ----------------------------------------------------------------------------- % UNIT VOL TYPE SERIAL-NO LOG- STA TIER RAID REM LOC SCO SIZE: % VOLUME TYPE COPY CURR/MAX. % ============================================================================= % BD00 WKBD00 D3435 4621351008 00000 RDY SAS 1 - -/-/- - 14/ 14 GB % BD01 WKBD01 D3435 4621351008 00001 RDY SAS 1 - -/-/- P 14/ 14 GB % BD02 E6BD.0 D3435 4621351008 00002 RDY SAS 1 - -/U/- - 11/ 14 GB % BD03 E6BD.1 D3435 4621351008 00003 RDY SAS 1 S -/U/C - 11/ 14 GB % #0123 4621351008 00123 N-R SAS 5 - -/-/- S / 14 GB
/SHOW-STORAGE-DEVICE-CONFIG UNIT=4D00,INFORMATION=*ALL % UNIT VOL TYPE SERIAL-NO LOG- STA TIER RAID REM LOC SCO SIZE: % VOLUME TYPE COPY CURR/MAX. % ============================================================================= % 4D00 D3435 4631508013 00200 RDY SAS 0 - -/-/U P - / 14 GB % ----------------------------------------------------------------------------- % UNIT VOL HOST-LUN OWNING-CONTR POOL-NAME CLUSTER-NAME % ============================================================================= % 4D00 0 CM13 SCO_RG1 DX8_AF_00
/SHOW-STORAGE-DEVICE-CONFIG SERIAL-NUMBER=9005,INFORMATION=*THIN-DEVICES % UNIT VOL SERIAL-NO !THIN-POOL-NAME !STA!TIER! CAPACITY: % ! ! !TYPE! ALLOC/CURR./CONFIG. % =========================================================================== % 9C80 4621349005!TPP900_06 !N-R!SAS ! 3600/ - / 3600 MB % 9C81 4621349005!TPP900_06 !N-R!SAS ! 3600/ - / 3600 MB % 9C82 4621349005!TPP900_06 !N-R!SAS ! 3600/ - / 3600 MB % 9C83 4621349005!TPP900_06 !N-R!SAS ! 3600/ - / 3600 MB % 9C84 DN01.0 4621349005!TPP900_06 !RDY!SAS ! 3600/ 3600/ 3600 MB % 9C85 DN01.1 4621349005!TPP900_06 !RDY!SAS ! 3600/ 3600/ 3600 MB % 9C86 DN01.2 4621349005!TPP900_06 !RDY!SAS ! 3600/ 3600/ 3600 MB % 9C87 DN01.3 4621349005!TPP900_06 !RDY!SAS ! 3600/ 3600/ 3600 MB
/SHOW-STORAGE-DEVICE-CONFIG SERIAL-NUMBER=9005,RAID-LEVEL=*TDEV,DEVICE=*ANY % --------------------------------------------------------------------------- % UNIT VOL SERIAL-NO !THIN-POOL-NAME !STA!TIER! CAPACITY: % ! ! !TYPE! ALLOC/CURR./CONFIG. % =========================================================================== % 9C80 4621349005!TPP900_06 !N-R!SAS ! 3600/ - / 3600 MB % 9C81 4621349005!TPP900_06 !N-R!SAS ! 3600/ - / 3600 MB % 9C82 4621349005!TPP900_06 !N-R!SAS ! 3600/ - / 3600 MB % 9C83 4621349005!TPP900_06 !N-R!SAS ! 3600/ - / 3600 MB % 9C84 DN01.0 4621349005!TPP900_06 !RDY!SAS ! 3600/ 3600/ 3600 MB % 9C85 DN01.1 4621349005!TPP900_06 !RDY!SAS ! 3600/ 3600/ 3600 MB % 9C86 DN01.2 4621349005!TPP900_06 !RDY!SAS ! 3600/ 3600/ 3600 MB % 9C87 DN01.3 4621349005!TPP900_06 !RDY!SAS ! 3600/ 3600/ 3600 MB
/SHOW-STORAGE-DEVICE-CONFIG SERIAL-NUMBER=1008,INFORMATION=*FLEX-DEVICES % ---------------------------------------------------------------------------- % UNIT VOL SERIAL-NO !FLEX-POOL-NAME !STA!TIER! CAPACITY: % ! ! !TYPE! ALLOC/CURR./CONFIG. % ============================================================================ % BDF6 F-BDF6 4621351008!FTV_Pool_1 !RDY!MIX ! 0/ 3600/ 3600 MB % BDF7 F-BDF7 4621351008!FTV_Pool_1 !RDY!MIX ! 0/ 3600/ 3600 MB % BDF8 F-BDF8 4621351008!FTV_Pool_1 !RDY!MIX ! 0/ 3600/ 3600 MB
/SHOW-STORAGE-DEVICE-CONFIG SERIAL-NUMBER=1008,RAID-LEVEL=*FDEV,DEVICE=*ANY % ----------------------------------------------------------------------------- % UNIT VOL TYPE SERIAL-NO LOG- STA TIER RAID REM LOC SCO SIZE: % VOLUME TYPE COPY CURR/MAX. % ============================================================================= % BDF6 D3435 4621351008 0043C RDY MIX F - -/-/- - - /3600 MB % BDF7 D3435 4621351008 0043D RDY MIX F - -/-/- - - /3600 MB % #043E D3435 4621351008 0043E RDY MIX F - -/-/- - - /3600 MB
Meaning of the output columns (in alphabetical order)
Keyword | Meaning | with INF = | ||||||||||||||||||||||
| Capacity of the device: used / available / configured |
| ||||||||||||||||||||||
| Name of the Storage cluster |
| ||||||||||||||||||||||
| Name of the flex pool in which the device is located |
| ||||||||||||||||||||||
| Channel address visible to the server (host LUN) |
| ||||||||||||||||||||||
| Local unit
|
| ||||||||||||||||||||||
| Internal number of the logical volume in the storage system |
| ||||||||||||||||||||||
| "Owning controller" of the RAID group to which the volume belongs |
| ||||||||||||||||||||||
| Affiliation to a RAID group |
| ||||||||||||||||||||||
| RAID level
|
| ||||||||||||||||||||||
| Remote unit
|
| ||||||||||||||||||||||
| Volume usage in the Storage Cluster
|
| ||||||||||||||||||||||
SED | SED shows, if the volume is a self encrypted disk.
|
| ||||||||||||||||||||||
| Serial number of the storage system |
| ||||||||||||||||||||||
| Usable and maximum size of the volume in MB or GB (from 10 GB) |
| ||||||||||||||||||||||
| Device state of logical unit (as seen by the server)
|
| ||||||||||||||||||||||
| Name of the TPP in which the TPV is located |
| ||||||||||||||||||||||
| Physical disk properties
|
| ||||||||||||||||||||||
| BS2000 device type (D3435 or STDDISK) |
| ||||||||||||||||||||||
| MN of the logical device or # followed by the 4-digit logical volume number if no assignment in BS2000 is possible. |
| ||||||||||||||||||||||
| VSN of the (logical) volume or <empty> if no assignment is possible in BS2000. |
|
S variables
Output information | Name of the S variable | T | Contents | Condition |
Remote copy mode (REC) | var(*LIST).ADD-REM-COPY-FEAT | S | '' | *STD / *ALL |
Clone functionality | var(*LIST).CLONE-USE | S | '' | *STD / *ALL |
Name of the Storage cluster | var(*LIST).CLUSTER-NAME | S | '' | *ALL |
Volume usage in the Storage Cluster | var(*LIST).CLUSTER-TYPE | S | *PRIMARY | *STD / *ALL |
Configured capacity of the volume in MB | var(*LIST).CONFIG-SIZE | I | <integer 0..2147483647> | *THIN-D |
Fullcopy functionality (QuickOPC) | var(*LIST).COPY-USE | '' | *STD / *ALL | |
Available capacity of the volume in MB | var(*LIST).CURR-SIZE | I | <integer 0..2147483647> | *STD / *ALL |
LUN visible to the server LUN (host LUN) | var(*LIST).HOST-LUN | S | '' | *PHYS |
Internal number of the logical volume | var(*LIST).LOGIC-VOL | S | '' | *STD / *ALL |
Maximum size of the volume in Mbytes | var(*LIST).MAX-SIZE | I | <integer 0..2147483647> | *STD / *ALL |
Controller of the storage system which uses the volume | var(*LIST).OWNING-CONTROLLER | S | '' | *PHYS |
Name of the pool in which the device is located | var(*LIST).POOL-NAME | S | '' | *PHYS |
RAID level | var(*LIST).RAID | S | '' | *STD / *ALL |
RAID group | var(*LIST).RAID-GROUP-ID | S | '' | *PHYS |
Remote copy mode (REC) | var(*LIST).REM-COPY | S | '' | *STD / *ALL |
Self encryption | var(*LIST).SELF-ENCRYPTED-DISK | S | *NO *YES | *PHYS |
Serial number | var(*LIST).SERIAL-NO | S | '' | *STD / *ALL |
Snap functionality | var(*LIST).SNAP-USE | S | '' | *STD / *ALL |
Device status | var(*LIST).STA | S | *READY | *STD / *ALL |
Physical disk properties (tiering) | var(*LIST).TIER-TYPE | S | Fibre Channel | *STD / *ALL |
Emulated device type | var(*LIST).TYPE | S | '' | *STD / *ALL |
MN of the logical volume | var(*LIST).UNIT | S | '' | *STD / *ALL |
Used capacity of the volume in MB | var(*LIST).USED-SIZE | I | <integer 0..2147483647> | *THIN-D |
VSN of the logical volume | var(*LIST).VOL | S | '' | *STD / *ALL |
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 | NDE1001 | Device not attached | |
64 | NDE1003 | Volume not online | |
64 | NDE1004 | Pubset not online | |
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 the storage system | |
64 | NDE1810 | Operating system version not in storage system | |
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 | NDE1828 | At least one element found for a storage system | |
64 | NDE2000 | Execution partially successful | |
64 | NDE2001 | Command not executed | |
64 | NDE2006 | No output information available | |
130 | NDE1082 | Memory bottleneck during processing of command |