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

5.4.2 Using the HDLM command (dlnkmgr) to handle a program error

The following shows the procedure for handling a program error by using the HDLM command (dlnkmgr).

Organization of this subsection

(1) Examine the messages

(2) Obtain program information

(3) Take action for the program error

(4) Contact your HDLM vendor or maintenance company

(1) Examine the messages

Examine the message that is output to the event log in the host. If an error occurs in an HDLM program, a message other than KAPL08xxx is output to the event log. Examine the content of the message. Messages with error level E (Error) or higher require corrective action.

(2) Obtain program information

Obtain the information to be reported to your HDLM vendor or maintenance company (if there is a maintenance contract for HDLM).

Use the DLMgetras utility for collecting HDLM error information to collect the error information. For details on the DLMgetras utility and the information it collects, see 8.2 DLMgetras (utility for collecting HDLM error information).

Some of the information collected by the DLMgetras utility might be cleared when the system is restarted. When an error occurs, as soon as possible execute the DLMgetras utility.

When an error occurs in the HDLM GUI, collect the screenshot at the time the error occurred.

(3) Take action for the program error

Take the action recommended for the message in 9. Messages.

If the error occurs again after you take the corrective action, use the dlnkmgr command's view operation to check the status of the HDLM program, and then take the appropriate corrective action. For details on the view operation, see 7.7 view (Displays information).

Execute the following command:

Example:

>dlnkmgr view -sys
If the KAPL01012-E message appears as a result of executing the command

The following shows the KAPL01012-E message:
 
KAPL01012-E Could not connect the HDLM manager. Operation name = view
 
Start the HDLM manager.

For details about how to start the HDLM manager, see 4.5.1 Starting the HDLM manager.
If the KAPL01013-E message appears as a result of executing the command

The following shows the KAPL01013-E message:
 
KAPL01013-E An error occurred in internal processing of the HDLM command. Operation name = view details = aa...aa
 
aa...aa indicates character string. Restart the host.
If the same error re-occurs after you take action, go to the following subsection (4) Contact your HDLM vendor or maintenance company.

(4) Contact your HDLM vendor or maintenance company

If the error cannot be resolved, contact your HDLM vendor or maintenance company if there is a maintenance contract for HDLM, and report the information collected by the DLMgetras utility.

[Contents][Back][Next]

[Trademarks]