When you want to configure the system so that HDLM messages are output to syslog, specify user for the system function name (Facility) in the syslogd settings file.
The following shows an example when syslogd is used, the system function name (Facility) is user, and the priority level (Priority) is an information message (info) level or higher are output to the /tmp/syslog.user.log file:
user.info /tmp/syslog.user.log
You can check path errors by referring to the KAPL08xxx messages that are output to the syslog.
To obtain detailed information about a path failure, check the execution results of the view operation as indicated by the error message.
For details on the view operation, see view (displays information).
The following is an example of a message:
KAPL08022-E Error in path occurred. 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
The message elements are explained below:
- 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. When you want to add a new LU without restarting the host, AutoPATH_IDs are re-assigned to each path of the LU when you execute the dlmcfgmgr utility.
This path ID is also the same as PathID displayed by the dlnkmgr command's view operation. For details on this view operation, see view (displays information).
- PathName
The path name indicates a path. When you modify the system configuration or replace a piece of hardware, you should check the path names to identify the 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 path name is also the same as PathName displayed by the command's view operation. For details on the path name, see view (displays information).
- DNum
A Dev number, which is equivalent to a partition number in Linux.
A device number beginning from 0 is assigned to the device in the LU.
In Linux, this value is fixed to 0.
This is the same as the DNum that is displayed by the view operation. For details on the view operation, see view (displays information).
- HDevName
The name of the host device.
The logical device file name of the HDLM device to which access is made by way of the path, minus the partition number, is displayed in the format sddlm[aa-pop] (for example, sddlmaa, or sddlmaaa). For details on logical device files for HDLM devices, see Logical device files for HDLM devices.
This is the same as the HDevName that is displayed by the view operation. For details on the view operation, see view (displays information).