To display path information

When displaying path information, if you specify either the -item or -c parameter and also specify the -path parameter, you can select the items to display and display a summary of path information. This section describes each parameter, path information and displayed items.

To display path information

-path

When you specify the -path parameter and do not specify either the -c or -item parameter, the information will be displayed about the HDLM managed paths without abbreviating or selecting items.

In the sub-parameters (following -path), you can filter the paths to be listed using -hdev and sort the list using -srt. When you omit both parameters, the command displays information for all the paths in order of increasing AutoPATH_IDs.

For details on what is displayed in each item, see Table 2.

AutoPATH_IDs displayed by the -path parameter depend on the sequence in which HDLM detects the paths after a host is started up. Because of this, make sure that you use the path name PathName to identify a path.

The sub-parameters are as follows:

-pstv|-vstv

If the -pstv parameter is specified, information about the physical storage system is displayed. If the -vstv parameter is specified, information about the storage system recognized by the operating system is displayed. If neither parameter is specified, information is displayed according to the value specified in the -pstv parameter of set operations.

For information about the items that are displayed differently depending on the specified -pstv and -vstv parameters, see TO_SET_UP_THE_HDLM_OPERATING_ENVIRONMENT=GUID-D1BCA75A-32B0-45BF-A8E5-66FBD9877543=2=EN=.html#GUID-D1BCA75A-32B0-45BF-A8E5-66FBD9877543__HYO07004V080001.

-hdev host-device-name

Displays information only for the paths accessing the specified host device.

Specify the name of the logical device file (minus the partition number), /dev/sddlm[aa-pap], for the HDLM device. For details on logical device files for HDLM devices, see LOGICAL_DEVICE_FILES_FOR_HDLM_DEVICES=GUID-1FB8E878-1356-4536-B854-9F544BC9B9C6=2=EN=.html.

The host-device-name string is case-sensitive.

-stname

Use this parameter to display the model ID of the storage system in the product ID element of the DskName field. When this parameter is omitted, the command displays the product ID or emulation type of the storage system instead.

For details about the information displayed for product IDs, see Table 4.

-iem: Use this parameter to add IEP to path information and display information about intermittent errors.

-srt {pn|lu|cp}

Use this parameter to sort the path information in ascending order, according to the specified sorting keys.

The sorting keys are as follows: the first sorting key is the name of the storage system (DskName), the second sorting key is the value specified by the -srt parameter, and the third sorting key is AutoPATH_ID.

The available parameter values to specify the second sorting key are:

pn: Path name
lu: LU number of the storage system
cp: Port number of the CHA

When the -srt parameter is omitted, the path information is listed in ascending order of AutoPATH_IDs.

-hbaportwwn: Displays port WWN information for the HBAs connected to the storage system.

-t: Omits the title for each information item.

Example

The following example shows how to display information about the paths that access a host device whose name is sddlmaa.

To display path information, by selecting a display item

-path -item

When you specify the -path parameter together with the -item parameter, the command only displays the items specified by the value of the -item parameter.

When the value of the -item parameter is omitted, only the PathID and the Status fields are displayed.

The following table lists the correspondence between the display items that can be selected by using the -item parameter and the parameter values that can be specified after the -item parameter.

Table. Correspondence between the items displayed by the dlnkmgr view -path -item command and the values of the -item parameter
Items displayed by the dlnkmgr view -path -item command	Values specified after the -item parameter
`PathID`^#	None
`PathName`	`pn`
`DskName`	`dn`
`iLU`	`lu`
`ChaPort`	`cp`
`Status`^#	None
`Type`	`type`
`IO-Count`	`ic`
`IO-Errors`	`ie`
`DNum`	`dnu`
`HDevName`	`hd`
`IEP`	`iep`
`HBAPortWWN`	`hbaportwwn`
`Physical-LDEV`	`phys`
`Virtual-LDEV`	`virt`

#

Because both PathID and Status are always displayed, you do not have to specify any parameters.

In the sub-parameters following -path -item, you can list the paths (-hdev) and sort the list (-srt). If you omit both parameters, the command displays information for all the paths in ascending order of AutoPATH_IDs.

These sub-parameters are:

-pstv|-vstv

-hdev host-device-name

Displays information only for the paths accessing the specified host device.

The host-device-name string is case-sensitive.

When you specify this parameter, HDevName is displayed by default. It is not necessary to specify hd for the -item parameter.

-stname

For details about the information to be displayed for product IDs, see Table 4.

When you use this parameter, DskName is displayed by default. It is not necessary to specify dn for the -item parameter.

-srt {pn|lu|cp}

Use this parameter to sort the path information in ascending order, according to the specified sorting key.

The available parameter values to specify the second sorting key are:

pn: Path name
lu: LU number of the storage system
cp: Port number of the CHA

When the -srt parameter is omitted, the path information is listed in order of ascending AutoPATH_IDs.

When you use this parameter, the items used for the sorting keys (DskName, AutoPATH_ID, and the item specified by this parameter) are displayed by default. Therefore, it is not necessary to specify these items for the -item parameter.

-t: Omits the title for each information item.

Example: In the following example, IO-Count is selected as the display item and the path information is sorted in ascending order of the by LUs.

# /opt/DynamicLinkManager/bin/dlnkmgr view -path -item ic -srt lu -stname
Paths:000012 OnlinePaths:000012
PathStatus   IO-Count    IO-Errors
Online       0           0

PathID DskName                                    iLU              Status     IO-Count
000006 HITACHI .VSP_5000        .39368            000BE0           Online              0
000007 HITACHI .VSP_5000        .39368            000BE0           Online              0
000008 HITACHI .VSP_5000        .39368            000BE1           Online              0
000009 HITACHI .VSP_5000        .39368            000BE1           Online              0
000010 HITACHI .VSP_5000        .39368            000BE2           Online              0
000011 HITACHI .VSP_5000        .39368            000BE2           Online              0
000000 HITACHI .VSP_Gx00        .489072           000800           Online              0
000001 HITACHI .VSP_Gx00        .489072           000800           Online              0
000002 HITACHI .VSP_Gx00        .489072           000801           Online              0
000003 HITACHI .VSP_Gx00        .489072           000801           Online              0
000004 HITACHI .VSP_Gx00        .489072           000802           Online              0
000005 HITACHI .VSP_Gx00        .489072           000802           Online              0
KAPL01001-I The HDLM command completed normally. Operation name = view(-vstv), completion time = yyyy/mm/dd hh:mm:ss
#

To display path information, by abbreviating the list items

-path -c

When you specify the -path parameter together with the -c parameter, the command selects certain items to be displayed, and shortens the contents of each item so that the information about each path fits into a single line on the screen.

The items that are displayed are PathID, DskName, iLU, CP, Status, and Type.

For details on what is displayed for each item, see Table 2.

When you use the -c parameter, the number of characters that can be displayed in the product ID element of the DskName field is limited to 10. When there are 11 or more characters in the product ID, the 8th and following characters are abbreviated to ellipses (...).

The sub-parameters (following -path -c) are:

-pstv|-vstv

-stname

For details about the information about product IDs, see Table 4.

-srt {lu|cp}

Use this parameter to sort the path information in ascending order, according to the specified sorting key.

The available parameter values to specify the second sorting key are:

lu: LU number of the storage system
cp: Port number of the CHA

When the -srt parameter is omitted, the path information is listed in ascending order of AutoPATH_IDs.

-t: Omits the title for each information item.

Example: The following example shows how to abbreviate the display of information about the paths, ordered by iLU.

Items of path information

Table 2 describes the displayed path information. The following explains the table headings:

No summary displayed: The user specifies only the -path parameter or the -path -item parameter.
Summary displayed: The user specifies the -path -c parameter.

Table. Path information
Displayed item		Description
No summary displayed	Summary displayed	Description
`Paths`		Total number of displayed paths, indicated by a decimal number.
`OnlinePaths`		Number of online paths from within the displayed paths, indicated by a decimal number. When the value of `Paths` equals the value of `OnlinePaths`, all paths are online. If the value of `OnlinePaths` is less than that of `Paths`, some paths are offline. In this case, you should check the offline paths and take appropriate action for any paths that have an error status.
`PathStatus`		Status of the displayed paths. The displayed status indicates the following: `Online`: All paths are available. `Reduced`: Some paths are not available. `Reduced` means that some paths might have an error status, in which case you should check the status of individual paths and resolve the problem for any paths that have an error status.
`IO-Count`		Total I/O count for all the displayed paths, indicated by a decimal number. The maximum value that can be displayed is 2³²- 1 (4294967295). If the total I/O count reaches the maximum value, it will re-start from 0. The count might increase when the path status is Offline(C). This is due to `ioctl` for device management, so even if the count increases, the data on the disk is not affected.
`IO-Errors`		Total I/O error count for all the displayed paths, indicated by a decimal number. The maximum value that can be displayed is 2³²- 1 (4294967295). If the total I/O error count reaches the maximum value, it will re-start from 0.. If the setting for retrying I/O when all paths fail is enabled (setting when using a channel board (25-Gbps iSCSI optical)), the value might be larger because I/O errors are counted even during I/O retries.
`PathID`		The AutoPATH_ID indicated by a decimal number. The AutoPATH_ID is assigned every time the host is restarted. When a new LU was added and the host has not been restarted, AutoPATH_ID is re-assigned to each path of the LU when you execute the HDLM-configuration definition utility (`dlmcfgmgr`).
`PathName`^#1	-	The path name, which indicates a path. When you modify the system configuration or replace a hardware item, you should check the path names to identify the physical path that will be affected by the change. `Path` `name` consists of the following four elements, separated by periods: Host port number (hexadecimal number) Bus number (hexadecimal number) Target ID (hexadecimal number) Host LU number (hexadecimal number) For details about each element of the path name and its representation in Linux, see Table 3.
`DskName`^#1	`DskName`	Storage system name, which identifies the storage system that is accessed by a path. A storage system name consists of the following three elements, separated by periods: Vendor ID: The name of the storage system vendor (for example, `HITACHI`). Product ID: Indicates the storage system product ID, emulation type, or model ID (for example, OPEN-3). For more details, see Table 4. Serial number: The serial number of the storage system (for example, `15001`). You can identify an actual storage system by referencing the above information from the storage system management program.
`iLU`^#1	`iLU`	LU number of the storage system. This number combined with the storage system name (shown in `DskName`) identifies the LU that is accessed by a path. For XP8 indicated by a hexadecimal number. The first two characters of `iLU` are 00, the middle two numbers are the CU number, and the last two characters are the internal LU number within the CU. For VSP 5000 series, VSP One B20, VSP E series, VSP Gx00 models, VSP Fx00 models, and VSP N series indicated by a hexadecimal number. The first two characters of `iLU` are the number of the logical DKC (Disk Controller), the middle two numbers are the CU number, and the last two characters are the internal LU number within the CU.
`ChaPort`^#1	`CP`	Port number of the CHA, which identifies the CHA port that is mounted on the storage system. You can identify an actual CHA port by referencing this number from the storage system management program.
`Status`		Status of the path `Online`: Online `Offline(C)`: Offline status caused by a command operation `Offline(E)`: Offline due to an error `Online(E)`: Failure has occurred (If none of the paths accessing one LU have an `Online` status, one of those paths is changed to the `Online(E)` status.) Paths that are `Offline(E)` or `Online(E)` require corrective action. The appropriate action can be determined by referring to COM_NL_WHAT_TO_DO_FOR_A_PATH_ERROR=GUID-477D552A-B034-4CE0-AB4E-DF8EEDA4C398=3=EN=.html.
`Type`^#1	`Type`	Attribute of the path `Own`: Owner path `Non`: Non-owner path If the storage system is supported by HDLM, usually all paths are owner paths.^#2
`IO-Count`^#1	`-`	Total I/O count for the path, indicated by a decimal number. The maximum value that can be displayed is 2³²- 1 (4294967295). If the total I/O count reaches the maximum value, it will re-start from 0. To reset the `IO-Count` value to 0, execute the `dlnkmgr` command's `clear` operation. Executing the `clear` operation also resets the number of I/O errors (`IO-Errors`) to 0. For details about the `clear` operation, see COM_MNL_CLEAR_(RETURNS_THE_PATH_STATISTICS_TO_THE_INITIAL_VALUE)=GUID-38CB6E46-33AD-4900-A011-3F2687D6F85C=3=EN=.html.
`IO-Errors`^#1	`-`	Total I/O error count for the path, indicated by a decimal number. The maximum value that can be displayed is 2³²- 1 (4294967295). If the total I/O error count reaches the maximum value, it will re-start from 0. To reset the `IO-Errors` value to 0, execute the `dlnkmgr` command's `clear` operation. Executing the `clear` operation also clears the number of I/O operations (`IO-Count`) to 0. For details about the `clear` operation, see COM_MNL_CLEAR_(RETURNS_THE_PATH_STATISTICS_TO_THE_INITIAL_VALUE)=GUID-38CB6E46-33AD-4900-A011-3F2687D6F85C=3=EN=.html. If the setting for retrying I/O when all paths fail is enabled (setting when using a channel board (25-Gbps iSCSI optical)), the value might be larger because I/O errors are counted even during I/O retries.
`DNum`^#1	`-`	Dev number, where 0 (fixed) is displayed. This item pertains to a partition number.
`HDevName`^#1	`-`	Host device name. The name of the logical device file (minus the partition number), `/dev/sddlm`[`aa-pap`], for the HDLM device. For details on logical device files for HDLM devices, see LOGICAL_DEVICE_FILES_FOR_HDLM_DEVICES=GUID-1FB8E878-1356-4536-B854-9F544BC9B9C6=2=EN=.html.
`IEP`^#1	`-`	Information about the intermittent error. This item is displayed only when you specify `-iem` with the `-path` parameter. One of the following values is displayed for each path: `-` Indicates that intermittent error monitoring is disabled or the monitoring time for an intermittent error is out of range. A value of at least 0 Indicates the number of errors that occurred during intermittent error monitoring. `*` Indicates that an intermittent error occurred (automatic failbacks do not check the path).
`HBAPortWWN`^#1	`-`	A 16-digit hexadecimal number indicating the WWN information for an HBA connected to the storage system. This item is displayed only when you specify `-iem` together with the `-hbaportwwn` parameter. For an iSCSI interface, a hyphen (`-`) is displayed.
`Physical-LDEV`	`-`	The model ID, serial number, and iLU number of a physical volume are separated by periods and displayed. You can identify the physical volume from this information. If the volume is not virtualized, a hyphen (`-`) is displayed.
`Virtual-LDEV`	`-`	Displays the model ID, serial number, and iLU number of a virtual volume, separated by periods. You can identify the virtual volume from this information. If the volume is not virtualized, a hyphen (`-`) is displayed.

Legend:: - : Not displayed

#1: The path information is displayed only when a value is specified for the -path -item parameter.

#2

Non-owner paths exist in the following cases:

When a global-active device is being used, and the non-preferred path option is set

Table. Elements of a path name
Element	Linux representation
Host port number (example: 0000)	Host ID (host port number)
Bus number (example: 0000)	Channel number (bus number)
Target ID (example: 000000000000003A)	Target ID
Host LU number(example: 0005)	Lun (host LU number)

To obtain information about each element, use the HDLM-configuration definition utility (dlmcfgmgr). For details about this utility, see DLMCFGMGR_UTILITY_FOR_MANAGING_THE_HDLM_CONFIGURATION=GUID-206DE304-3FED-4BCC-AD77-A75B4DC0E01D=2=EN=.html.

Table. Product ID displayed by the view -path operation
Model names of storage systems	Product ID
Model names of storage systems	Without the -stname parameter	With the -stname parameter (displays the following for the model name)
VSP 5000 series	Emulation type^#1	VSP_5000
Virtual storage system "VSP G1000, G1500 and VSP F1500"^#2		VSP_G1000
VSP One B20		VSP_One_Block^#3
VSP E series		VSP_Ex00
VSP Gx00 models		VSP_Gx00
VSP Fx00 models		VSP_Fx00
VSP N series^#4		VSP_Gx00
VSP N series^#4		VSP_Fx00
XP8		XP8

#1: When a summary is displayed by specifying the -path -c parameter and there are 11 or more characters in the summary string, any characters after the 9th character are not displayed, and ellipsis (...) are displayed instead.

#2: When the primary volume of the global-active device is not registered to a virtual storage system, the model ID of the storage system of the primary volume is displayed. Note that VSP_G1000 is displayed when the primary volume is not connected to a host.

#3: When a summary is displayed by specifying the -path -stname -c parameter and there are 11 or more characters in the summary string, any characters after the 9th character are not displayed, and ellipsis (...) are displayed instead.

#4: VSP_Gx00 or VSP_Fx00 is displayed.