QUERY EDEVICE
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
- For queries that contain device numbers that represent emulated and non-emulated devices, responses will be generated only for emulated devices.
- 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.
- 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).
- 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.
- The majority of the extra details information is obtained at VARY ON time, not when you issue the QUERY EDEVICE DETAILS command.
- The maximum length of the inquiry response data display is 255 bytes.
- 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:
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;
Response 2:
q edev 306-310
None of the devices specified are emulated devices.
Ready;
Response 3:
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:
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:
q edev 500 details
EDEV 0500 TYPE UNK
Ready;
Response 6:
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:
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:
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:
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:
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:
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.
- 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.
- 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.
- 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:
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