QUERY EDEVICE

Read syntax diagramSkip visual syntax diagram Query EDEVice rdevrdev1-rdev2DETAILSPATHINFOINQUIRYPAGEpageALLSTORAGE

Authorization

Privilege Class: B

Purpose

Use QUERY EDEVICE to display the device type and other detailed information associated with an emulated device.

Operands

rdev
rdev1-rdev2
specifies the emulated devices for which you want information to be displayed. An rdev in the active configuration can be entered as a 4-digit hexadecimal device number between X'0000' and X'FFFF'. For an rdev in the active or standby configuration, the device number can be a 5-digit hexadecimal number between X'00000' and X'3FFFF' with the leading digit specifying the subchannel set of the device for which you want information to be displayed. A range of devices cannot span subchannel sets.
DETAILS
displays detailed information associated with an emulated device.
ALL
displays information for all emulated devices in the active configuration, but does not include the information that is displayed with the DETAILS operand.
PATHINFO
displays information associated with individual path activity.
INQUIRY
displays information from the standard inquiry page of the LUN associated with the emulated device.

The data returned by the INQUIRY option is in hexadecimal format. The IOEXPLOR EXEC can be used as an alternative in order to receive formatted data.

For further details on the information contained in the output, consult your storage hardware vendor.

PAGE page
displays information from the specified vital product data page of the device. The page operand must be a hexadecimal page number between X'00' and X'FF'.
STORAGE
displays information for the pools of storage used by emulated devices, instead of the configuration of specific emulated devices. This operand will provide (in bytes) the configured size, amount used, and maximum amount used of each pool. It will also include the number of allocation and release requests that were satisfied by the pools.

Usage Notes

  1. For queries that contain device numbers that represent emulated and non-emulated devices, responses will be generated only for emulated devices.
  2. If you query an emulated device that was cleared with the SET EDEVICE command, the response will indicate that the device is still an emulated device, but no other information is associated with it.
  3. Detailed information for emulated devices associated with 1750 and 2145 attributes includes an indication for each path specifying whether the path is a preferred (PREF) path or a not-preferred path (NOTPREF).
  4. Some of the detailed information will be displayed only after the device is varied online successfully. If you do the QUERY EDEVICE DETAILS before the VARY ON or after a VARY OFFLINE, fewer details will be displayed.
  5. The majority of the extra details information is obtained at VARY ON time, not when you issue the QUERY EDEVICE DETAILS command.
  6. The maximum length of the inquiry response data display is 255 bytes.
  7. An NVMe EDEVICE might indicate that it is not operational by displaying Int Req following the device attributes. The message indicates that intervention is required because there is a problem with the underlying NVMe PCI function. For example, the NVMe PCI function might have been removed from the configuration. To recover, the EDEVICEs that are associated with the NVMe function must be deleted and redefined.

Responses

Response 1:

To query the emulated devices in the device range 300-305, enter the following:
q edev 300-305
EDEV 0300 TYPE FBA ATTRIBUTES 2105
EDEV 0301 TYPE FBA ATTRIBUTES SCSI
EDEV 0302 TYPE FBA ATTRIBUTES 2107
EDEV 0303 TYPE FBA ATTRIBUTES 1750
EDEV 0304 TYPE FBA ATTRIBUTES FLASH
EDEV 0305 TYPE FBA ATTRIBUTES NVM
Ready;
Note: Devices in the range that are not emulated devices do not appear in the response.

Response 2:

If none of the devices specified on the command are emulated devices, the following response will be displayed:
q edev 306-310
None of the devices specified are emulated devices.
Ready;

Response 3:

To query detailed information about an emulated device, for example, device 1111, enter the following:
q edev 1111 details
EDEV 1111 TYPE FBA ATTRIBUTES 2105
  VENDOR: IBM      PRODUCT: 2105F20          REVISION: .293
  BLOCKSIZE:        512  NUMBER OF BLOCKS: 390656
  PATHS:
    FCP_DEV: B908  WWPN: 5005076300CD04DA  LUN: 5144000000000000
      CONNECTION TYPE: POINT_TO_POINT STATUS: ONLINE
  EQID: ABCDEFGH
  SERIAL NUMBER: 2146561344562
  

This response shows one possible value for STATUS: ONLINE. The other possible values are OFFLINE and RECOVERY. RECOVERY indicates that the system is undergoing error recovery and should return to ONLINE status soon.

Response 4:

To query detailed information about emulated devices in the device range 800-801, 850, and 888, enter the following:
q edev 800-801 details
EDEV 0800 TYPE FBA ATTRIBUTES 2105
  VENDOR:  IBM     PRODUCT: 2105F20          REVISION: .293
  BLOCKSIZE:        512  NUMBER OF BLOCKS: 390656
  PATHS:
    FCP_DEV: B046  WWPN: 5005076300C904DA  LUN: 513A000000000000
      CONNECTION TYPE: SWITCHED STATUS: ONLINE
    FCP_DEV: B906  WWPN: 5005076300C904DA  LUN: 513A000000000000
      CONNECTION TYPE: SWITCHED STATUS: ONLINE
  EQID: IBM000002105000000000000144132F6F20000000000000000 
  SERIAL NUMBER: 00112233445566
EDEV 0801 TYPE FBA ATTRIBUTES 2105
  PATHS:
    FCP_DEV: B046  WWPN: 5005076300C904DA  LUN: 513B000000000000
  EQID: ABCDEFGH

q edev 850 details
EDEV 0850 TYPE FBA ATTRIBUTES 1750
  VENDOR: IBM      PRODUCT: 1750500          REVISION: 1.67
  BLOCKSIZE:        512  NUMBER OF BLOCKS: 65536
  PATHS:
    FCP_DEV: 2406  WWPN: 500507630E85FC66  LUN: 4010401200000000 NOTPREF
      CONNECTION TYPE: SWITCHED STATUS: ONLINE
    FCP_DEV: 2406  WWPN: 505507630E05FC66  LUN: 4010401200000000 PREF
      CONNECTION TYPE: SWITCHED STATUS: ONLINE
  EQID: IBM000002105000000000000144235F6F2000000000000FFFF
  SERIAL NUMBER: 11223344556677

q edev 888 details
EDEV 0888 TYPE FBA ATTRIBUTES 2145
  VENDOR: IBM      PRODUCT: 2145             REVISION: 0000
  BLOCKSIZE:        512  NUMBER OF BLOCKS: 10485760
  PATHS:
    FCP_DEV: 2FCB WWPN:  5005076801402797  LUN: 000E000000000000 NOT PREF
      CONNECTION TYPE: SWITCHED STATUS: ONLINE
    FCP_DEV: 2FCB WWPN:  5005076801402991  LUN: 000E000000000000 PREF
      CONNECTION TYPE: SWITCHED STATUS: ONLINE
  EQID: IBM000002105000000000000141462F6F2000000000000BB00
  SERIAL NUMBER: 11223344556677

Note that the 801 device does not list much detail because it is not varied online.

Response 5:

To query detailed information about emulated device 500 (which has been cleared using the SET EDEVICE command), enter the following:
q edev 500 details
EDEV 0500 TYPE UNK
Ready;

Response 6:

If you enter QUERY EDEVICE DETAILS and the emulated device has been expanded and has not yet been varied offline and online to make use of the expanded space, you see the following line in the response:
PENDING EXPANSION NUMBER OF BLOCKS:  148493740

The blocks are the new size which will be used by CP once the device is varied offline and online.

Response 7:

To query information about the pools of reserved storage that are used for the configuration of emulated devices, enter the following:
q edev storage

                                       Allocations        Releases        
           Size      Used    Maximum   Total     Failed   Total     Failed
  Primary: 122880    20928   21024     66        0        0         0     
Secondary: 6524928   0       0         0         0        0         0     
Ready; T=0.01/0.01 15:06:03

Response 8:

To query whether a real device at address 7F00 has an equivalency ID (EQID) assigned to it, enter the following:

q edev 7f00 details       
                                               
11:58:21 EDEV 7F00 TYPE FBA ATTRIBUTES FLASH                             
11:58:21   VENDOR: IBM PRODUCT: FlashSystem-9840 REVISION: 1136          
11:58:21   BLOCKSIZE: 512 NUMBER OF BLOCKS: 20971520                     
11:58:21   PATHS:                                                        
11:58:21     FCP_DEV: 1741 WWPN: 500507605E819CC1 LUN: 0000000000000000  
11:58:21       CONNECTION TYPE: SWITCHED STATUS: ONLINE                  
11:58:21   EQID: 00020E662C220E6-0000-0201-0005F8C500000000013FFFFF 
11:58:21   SERIAL NUMBER: 20e662c220e6-0000-0166-0001a2
Ready; T=0.01/0.01 11:58:21 

Response 9:

To query the standard inquiry page of the SCSI LUN backing an emulated device, enter the following:

q edev 111 inquiry
- Begin - EDEV 0111 - Standard Inquiry Page -
00000532 9F101002 49424D20 20202020 32313037 39303020 20202020 20202020
2E323034 37353034 31393131 34303020 20202020 20202020 00600DA0 0A000300
03200000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
00323037 35003236 34303400 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
00080000
- End - EDEV 0111 - Standard Inquiry Page - 

Response 10:

To query the vital product data page 83 of the SCSI LUN backing an emulated device, enter the following:

q edev 111 inquiry page 83
- Begin - EDEV 0111 - Vital Product Data Page 83 -
00830024 01030010 60050763 03FFC09C 00000000 00001400 01140004 00000032
01150004 00000000
- End - EDEV 0111 - Vital Product Data Page 83 -

Response 11:

To query information associated with path activity on an emulated device, enter the following:
query edev 400 pathinfo
EDEV 0400 TYPE FBA ATTRIBUTES 2107 ALUA SUPPORTED: YES
  PATHS:
    FCP_DEV: 1D1D WWPN: 5005076306081588
    LUN: 4064401600000000 ALUA OPTIMIZED: NO
      SELECTED: 43
      ADAPTER ERRORS: 1
      SOFTWARE: 0
      HARDWARE: 0
      TRANSPORT: 1
      OTHER: 0
    TIMEOUT ERRORS: 0
    SCSI ERRORS: 8
      RESERVATION: 0
      QUEUE FULL: 0
      DEVICE BUSY: 4
      ACA ACTIVE: 1
      ABORT TASK: 0
      CHECK CONDITIONS: 3
        MEDIUM: 0
        HARDWARE: 0
        NOT READY: 1
        ABORTED: 0
        OTHER: 2
    LAST ERROR TIME: Apr 30 2020 08:57:00
    LAST ERROR TYPE: SCSI DEVICE BUSY
    LAST FAILURE TIME: Apr 30 2020 08:57:00
    LAST FAILURE REASON: DIAG

The response for QUERY EDEVICE PATHINFO differs from QUERY EDEVICE DETAILS in that path info displays the ALUA state of the specified path. ALUA SUPPORTED can be YES, NO, or UNKNOWN, if the emulated device has yet to perform a discovery on the status.

This response also displays the number and type of errors that have occurred on the paths recently, as well as the time of the most recent error type.

If the error is an adapter error, the following types may be displayed:
ADAPTER SOFTWARE
failure in the adapter microcode
ADAPTER HARDWARE
failure in the adapter hardware
TRANSPORT DEAD
failure in accessing the link
OTHER ADAPTER
another adapter failure; for example, busy link, login failure, etc.
If the error is a SCSI command error, the type of error is listed:
  • SCSI RESERVATION
  • SCSI QUEUE FULL
  • SCSI DEVICE BUSY
  • SCSI ACA ACTIVE
  • SCSI ABORT TASK
  • MEDIUM CHECK COND
  • HARDWARE CHECK COND
  • NOT READY CHECK COND
  • ABORTED CHECK COND
  • OTHER CHECK COND

If the device becomes unresponsive, the error displayed is TIMEOUT ERROR.

Below the error type, the time of the most recent failure is also displayed, along with the reason for failure:
NONE
No failures have occurred on this path since the last reset.
INIT
The last failure occurred on this path during initialization.
DIAG
The last failure occurred on this path during self-diagnostics.
ADAP
The last failure occurred on this path as a result of an adapter error.
SCSI
The last failure occurred on this path as a result of a SCSI command error.
INQ
The last failure occurred on this path as a result of a SCSI Inquiry peripheral error.
RETRY
The last failure occurred on this path due to too many retries of the IO operation.

Response 12:

The DETAILS response for an NVMe EDEVICE might include the following lines:
SEGMENT: segment number/number of segments
HYPERPAV POOL: pool number
PCIFUNCTION: rpfid
The segment number value is the number of the first disk block that is accessible via the emulated device. The pool number value is the HyperParallel Access Volume pool number that is associated with the device. The rpfid value is the identifier of the real PCIe function that is used to access the NVMe device.

Messages

  • HCP002E Invalid operand - operand
  • HCP003E Invalid option - command contains extra option(s) starting with option
  • HCP009E Invalid range - range
  • HCP6704E Missing token at end of line.
  • HCP8710E INQUIRY error on EDEV rdev
  • HCP8711E EDEV rdev does not support VPD page page