HiCommand Dynamic Link Manager User's Guide (for Windows(R))

5.2 Checking error information in messages

You can check path errors by referring to the KAPL08xxx messages that are output to Event log.

To obtain detailed information about a path, check the following windows according to the type of message.

For the HDLM GUI

Path List view in the Path Management window

For a command

Execution results of the view operation.

For details on the view operation, see 7.7 view (Displays information).

Based on the applicable message, detailed information about a path can be obtained by checking the execution results of the view operation.

The following is an example of a message:

Message that is output when a path error occurs.
KAPL08022-E A path error occurred. ErrorCode = aa...aa, PathID = bb...bb, PathName = cc...cc.dd...dd.ee...ee.ff...ff,DNum = gg...gg,HDevName = hh...hh
KAPL08019-E The path (aa...aa) detected an error (bb...bb). (cc...cc)

Message that is output when there is no online paths to the LU.
KAPL08026-E An error occurred on all the paths of the LU. PathID = aa...aa

Message that is output when there is no online paths to the LU if the LU dynamic removal functionality is used.
KAPL05301-E Path has been removed.

Note

When a path is added to an LU, the following messages might appear:
- KAPL08019-E and KAPL08022-E
- KAPL05301-E
Note that these messages are output by Windows activities, and not by an error.

When an LU is deleted from the HDLM management target by using the LU deletion functionality, the KAPL08022-E message might not be output to the event log. In this case, refer to the KAPL05301-E message to check the path information.

The elements of the message are explained below.

For details about the KAPL05301-E message, see When an LU or path is deleted due to disconnection of a path in (2) Checking that the LU or path is deleted dynamically in 4.6.2 Deleting an LU dynamically.

ErrorCode

The error number generated when Windows detected the path error.

PathID

The ID assigned to a path. This ID is called the AutoPATH_ID. AutoPATH_IDs are re-assigned every time the host is restarted.

This path ID is the same as the path ID displayed in the Path List view in the Path Management window.

The path ID is also the same as PathID displayed by the command's view operation. For details on the view operation, see 7.7 view (Displays information).

PathName

The path name, which indicates a physical path. When you modify the system configuration or replace a hardware item, you should check the path names to identify the physical paths that will be affected by the change.

A path name consists of the following four elements, separated by periods:

Host port number (hexadecimal)

Bus number (hexadecimal)

Target ID (hexadecimal)

Host LU number (hexadecimal)

This name is the same as the path name displayed in the Path List view in the Path Management window for the HDLM GUI. For details on the path names, see 6.2.4 Path List view in the view frame for the HDLM GUI.

The path name is also the same as PathName displayed by the command's view operation. For details on the path name, see 7.7 view (Displays information).

DNum

A Dev number. A 0 is displayed for a Dev that indicates the entire LU.

This is the same as the DNum that is displayed by the view operation. For details on the view operation, see 7.7 view (Displays information).

HDevName

The name of the host device.

A drive letter appears. If no drive letter has been assigned, a hyphen (-) appears.

This is the same as the HDevName that is displayed by the view operation. For details on the view operation, see 7.7 view (Displays information).

[Contents][Back][Next]

[Trademarks]