QUERY PATHS

Authorization

Privilege Class: B, E

Purpose

Use QUERY PATHS to display:

All paths installed to a specific device or range of devices
Installed path status

Operands

rdev
rdev1-rdev2
TO rdev
TO rdev1-rdev2: is the real device number or range of real device numbers whose path allocation information you want. Each rdev in the active configuration can be entered as a 4-digit hexadecimal number between X'0000' and X'FFFF'. For a device 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 where the device is configured. You can specify a single device address, a range of device addresses, or any combination thereof. A range of devices cannot span subchannel sets.

Usage Notes

The standard response lines for QUERY PATHS are shown in the following example. They are called standard because they will always be displayed for a device that has installed paths.

Device 0291, Status ONLINE
 CHPIDs to Device 0291 (PIM)  : 19 1B 2E 2F
  Physically Available (PAM)  : +  +  +  +
  Online               (LPM)  : +  +  +  +

          Legend         + Yes - No

The query response reflects the current hardware information for paths that are physically installed and physically available. The logical path information you see represents a snapshot of what CP knows based on information in the RDEV.
For information about the devices associated with a specific channel path, see QUERY CHPID.
Error messages produced for this command may vary depending on how the device was specified on the command line. When a single device is listed on the command line, an error will be reported if there is no query information available for that single device. For example:
```
query paths to  102
HCPQPA0040E Device 0102 does not exist
Ready(00040);
```
When a range of devices is listed on the command line, only devices that have query information available are shown. Errors messages are not issued for individual devices within the range. For example:
```
query paths to  100-105
Device 0105, Status OFFLINE
 CHPIDs to Device 0105 (PIM)  : 19 1B 2E 2F
  Physically Available (PAM)  : +  +  +  +
  Online               (LPM)  : +  +  +  +

           Legend     + Yes - No
Ready;
```
If query information is not available for at least one device in a range, then a generic error message will be issued. For example:
```
query paths to  100-102
HCPQPA1003E 0100-0102 was not found.
Ready(01003);
```

Responses

Response 1 (Generic):

The following is the full, generic response to the QUERY PATHS command. Normally, you will see only pieces of this response, as CP displays only the lines that have data. For example, if the device does not have any offline channel paths, CP would not display lines 6 through 10. The maximum number of channel paths is 8, as shown in the example. CP displays only the number of channel paths attached to the device. The responses that follow this generic one will show examples of these shortened responses.


 1     Device rdev, Status status
 2      CHPIDs to Device rdev (PIM)  : chpid1 .......... chpid8
 3       Physically Available (PAM)  :  +/-   ..........   +/- 
 4       Online               (LPM)  :  +/-   ..........   +/- 
 5       Preferred                   :  +/-   ..........   +/- 
 6       Offline by Authorized User  :  +/-   ..........   +/- 
 7       Offline by ESCON Manager    :  +/-   ..........   +/- 
 8       Out of Path Group by Guest  :  +/-   ..........   +/- 
 9       Offline by Control Unit     :  +/-   ..........   +/- 
10       Offline, Wrong CU Connection:  +/-   ..........   +/- 
11       Transport Mode Supported    :  +/-   ..........   +/- 
12       Encrypted Link              :  +/-   ..........   +/-
13       Authenticated Link          :  +/-   ..........   +/-                            
14                            Legend     + Yes - No

Line

Explanations

1

tells you the real device number of the device and its status. The status field can contain the following:

BOXED: device is not available to CP, usually because of a hardware condition
DISABLE: device is disabled
ENABLE: device is enabled
OFFLINE: device is offline
ONLINE: device is online
QUIESCED: device is offline for maintenance
SUBCHOFF: device is subchannel disabled, see VARY SUBCHANNEL.
TEST-ONL: device has been forced online in test mode, see VARY (Real Device).

2

identifies the real device number and the channel path identifiers (CHPIDs) of all paths physically installed to that device. This is also known as the path installed mask (PIM).

3

identifies the paths that are physically available to the device. This is also known as the path available mask (PAM).

4

identifies the paths that are logically online to the device. This is also known as the logical path mask (LPM).

5

identifies the preferred paths to the device, if applicable.

6

identifies the paths that are logically offline because the VARY PATH command was issued by an authorized user.

7

identifies the paths that are logically offline because the ESCON configuration program has taken them offline.

8

identifies the paths removed from the path group by a guest that is managing the paths to a device.

9

identifies the channel paths that are unavailable to the device and locked offline while service is applied to this channel path. Once service on this channel path is completed, a corresponding resume issued by the Service Representative (SR) will cause this channel path to be varied online to the device. If for some reason the resume request did not vary this channel path back online, the FORCE option on the VARY PATH command can be used to override the quiesced path and vary the channel path online to the device. The FORCE option should only be used when the SR indicates that service is complete and a resume was issued but did not vary the channel path online.

10

identifies the paths that are logically offline because the wrong control unit connection was detected. This could happen as a result of a cable swap, for example.

11

indicates whether CHPIDs are enabled for Transport Mode. Use of High Performance FICON® for IBM Z® (zHPF) requires channel paths capable of Transport Mode. Moreover, a guest with the CHPIDVIRTUALIZATION ONE directory option can use zHPF only if Transport Mode is supported on all FICON channels in the system, or, in an SSI cluster, on all systems in the guest's assigned relocation domain.

12

identifies the paths that are encrypted.

13

identifies the paths that are authenticated.

14

identifies the legend information.

Response 2 (Path Status):

The following is an example of a query response you may see after an operator has issued the VARY PATH command:

Device 0291, Status ONLINE
 CHPIDs to Device 0291 (PIM)  : 19 1B 2E 2F
  Physically Available (PAM)  : +  +  +  +
  Online               (LPM)  : -  -  -  +
  Offline by Authorized User  : +  +  +  -
                       Legend     + Yes - No

This example shows:

device 291 is online and there are 4 paths physically installed to the device (19,1B,2E,2F)
1 path (2F) is logically online
3 paths (19,1B,2E) are logically offline because someone issued the VARY PATH command.

Response 3:

The following is an example of a query response you may see for a device that has never been online (for example, the device may have been listed in the DEVICES statement in the configuration file as NOTINITialized_at_ipl):

Device 019E, Status SUBCHOFF
 CHPIDs to Device 019E (PIM)  : 19 1B 2E 2F
  Physically Available (PAM)  : +  +  +  +
  Online               (LPM)  : -  -  -  -
                       Legend     + Yes - No

This example shows:

device 19E is in the subchannel disable state and has 4 paths physically installed to the device (19,1B,2E,2F)
all paths are logically offline

Response 4:

The following is an example of a query response you may see when several paths are offline for different reasons:

Device 0192, Status ONLINE
 CHPIDs to Device 0192 (PIM)  : 11 12 1A 22 30 40
  Physically Available (PAM)  : +  +  +  +  +  +
  Online               (LPM)  : -  -  +  +  +  -
  Offline by Authorized User  : +  -  -  -  -  -
  Offline by Control Unit     : -  +  -  -  -  +
                       Legend     + Yes - No

This example shows:

device 192 is in the online state and has 6 paths physically installed to the device (11,12,1A,22,30,40)
3 paths (1A,22,30) are logically online to the device
3 paths (11,12,40) are logically offline to the device
1 path (11) is logically offline because someone issued the VARY PATH command.
2 paths (12,40) are logically offline because someone has issued a command at the control unit in order to service the device

Messages

HCP003E Invalid option - {option|command contains extra option(s) starting with option}
HCP009E Invalid range - rdev-rdev
HCP021E A real device number was not supplied or it is invalid.
HCP026E Operand missing or invalid
HCP040E Device rdev does not exist
HCP1003E rdev-rdev was not found.
HCP1150E DASD {rdev|vdev} is not a valid base exposure.
HCP6706E Invalid RDEV - rdev. RDEV not initialized