Job Management Partner 1/Software Distribution Administrator's Guide Volume 2

[Contents][Glossary][Index][Back][Next]

6.4.1 Checking log files

If an error occurs, a log is collected in JP1/Software Distribution Client (client). You should check the contents of the log before taking an action. The contents of the log can be checked for each PC.

JP1/Software Distribution Client (client) collects the following five types of logs:

You can check the Windows NT event log from Windows NT Event Viewer. All other log files, which are stored in the installation directory \LOG for JP1/Software Distribution Client, can be checked by using a text editor.

The following is an explanation of logs.

Organization of this subsection
(1) Basic client log
(2) Log for entire JP1/Software Distribution Client (client)
(3) Installation script-related log
(4) LogFile function output log for the installation script
(5) Log related to updating the connection destination automatically

(1) Basic client log

Basic log messages related to the operation of a client are output to the USER_CLT.LOG file for each PC. When checking the operation of a client, this file is the first source of information that you should refer to. This file contains brief messages about the start and termination of each process. If processing fails, the cause of the error is also output to this file.

The following operations can have information output to the USER_CLT.LOG file:

For details about file formats and messages, see 7.2 Lists of basic client log messages.

(2) Log for entire JP1/Software Distribution Client (client)

The log for the entire JP1/Software Distribution Client (client) is produced in the event log for Windows NT and in the MAIN.LOG file.

(a) Checking Windows NT event logs

For Windows NT operating system, event logs that are collected during the use of JP1/Software Distribution Client (client) can be displayed using Event Viewer. You should check the event that is indicated as Software Distribution in the source column of Event Viewer. You can also check events on other hosts on which Windows NT is running by selecting Select Computer in the Log menu of Event Viewer. For details about how to use Event Viewer, see the Windows NT documentation or Help files.

The numbers (event IDs) that are displayed in the event column of Event Viewer correspond to message IDs, and they have the following meanings:

Table 6-15 Event IDs and their meanings (JP1/Software Distribution Client (client))

Event ID Description
0-999 Windows NT interface
1000-1999 TCP/IP-related
5000-5999 Setup-related
6000-6999 Packaging-related
7000-7999 Installation-related
60000 and above User output

Double-clicking an event in the Event Viewer window displays detailed information about the event.

Some events produce memory-dump information in the event details. When contacting Hitachi regarding a JP1/Software Distribution Client (client) error, please provide this information along with other pieces of relevant information.

For event log messages that are output by Software Distribution, see 7.1 Lists of event log messages.

(b) Checking the MAIN.LOG file

JP1/Software Distribution Client (client) produces a message log for each PC in the MAIN.LOG file, in the following file format:

Figure 6-8 Format of the MAIN.LOG file

[Figure]

The message type and function type that are displayed in the MAIN.LOG file have the following meanings:

Table 6-16 MAIN.LOG file message type (JP1/Software Distribution Client (client))

Message type Meaning
Informational Information message
Warning Warning message
Error Error message

Table 6-17 MAIN.LOG file function type (JP1/Software Distribution Client (client))

Function type Meaning
Package Packaging (an error within JP1/Software Distribution Client)
Install Installing (an error within JP1/Software Distribution Client)
Setup Installing in GUI installation mode (an error within JP1/Software Distribution Client)
TCP/IP TCP/IP interface
System Windows NT interface
User User log (output from the LogFile function of installation script)
Server Relaying (an error within JP1/Software Distribution Client)

(3) Installation script-related log

Syntax errors and runtime errors from installation scripts and collect scripts are collected in the SCRIPT.LOG file for each PC. Because the contents of this log are also output to the log (the MAIN.LOG file) for the entire JP1/Software Distribution Client (client), you should check the MAIN.LOG file when checking how the installation script log relates to the JP1/Software Distribution Client (client) log. The SCRIPT.LOG file has the following format:

Script syntax check starting message

Figure 6-9 Format of the SCRIPT.LOG file (script syntax check starting message)

[Figure]

Script execution starting message

Figure 6-10 Format of the SCRIPT.LOG file (script execution starting message)

[Figure]

Script syntax error message

Figure 6-11 Format of the SCRIPT.LOG file (script syntax error message)

[Figure]

(4) LogFile function output log for the installation script

When the user outputs a log by using the LogFile function of an installation script, the contents of the log are collected in the USER.LOG file for each PC. Because the contents of this log are also output to the log (the MAIN.LOG file) for the entire JP1/Software Distribution Client (client), you should check the MAIN.LOG file when checking how the installation script log relates to the JP1/Software Distribution Client (client) log. The USER.LOG file has the following format:

Figure 6-12 Format of the USER.LOG file

[Figure]

(5) Log related to updating the connection destination automatically

When client connection destinations are automatically set or changed by an information file for higher connection destinations, log is collected in the USER.LOG file for each PC. The USER.LOG file has the following format:

Figure 6-13 Format of the USER.LOG file

[Figure]

The messages that are displayed and their meanings are summarized as follows:

Message Meaning
Match smallest-IP-address-largest-IP-address: Change old-connection-destination: old-connection-destination-product-type -> new-connection-destination: new-connection-destination-product-type The connection destination for the client was successfully changed.
Match smallest-IP-address-largest-IP-address: No Changed existing connection-destination: existing-connection-destination-type The connection destination that is already specified matches the definition in the information file for higher connection destinations. The connection destination is not changed.
No Match IP Address List, No Changed existing connection-destination: existing-connection-destination-type The client IP address is not in the definition range of the information file for higher connection destinations. The connection destination is not changed.
Not exist No. item-sequence Value: LineNo line-number An item-sequence item is not specified in the line-number line of the information file for higher connection destinations. The definition in the line is invalid.
IP Address is not available:"specified-value" :LineNo line-number An invalid IP address is specified in the line-number line of the information file for higher connection destinations. The definition in the line is invalid.
Higher manager value is over 64 character:"specified-value" :LineNo line-number A value containing more than 65 characters is specified in the line-number line of the information file for higher connection destinations. The definition in the line is invalid.
Connection type value is not "netmdm" or "netmdmw":"specified-value" :LineNo line-number A value other than netmdm or netmdmw is specified as a connection destination product type in the line-number line of the information file for higher connection destinations. The definition in the line is invalid.
Match smallest-IP-address-largest-IP-address: Change Multicast IP Address old-multicasting-address -> new-multicasting-address The client's multicasting address was changed normally.
Match smallest-IP-address-largest-IP-address: No Changed Multicast IP Address multicasting-address The multicasting address that is already specified matches the definition in the information file for higher connection destinations. The multicasting address is not changed.
Multicast IP Address is not available:"multicasting-address":LineNo line-number An invalid multicasting address is specified in the line-number line of the information file for higher connection destinations. The definition in the line is still valid, but the multicasting address specification is invalid.
Multicast IP Address is under 224.0.0.0:"specified-value" :LineNo line-number A multicasting address with a value less than 224.0.0.0 is specified in the line-number line of the information file for higher connection destinations. The definition in the line is still valid, but the multicasting address specification is invalid.
Multicast IP Address is over 239.255.255.255:"specified-value" :LineNo line-number A multicasting address with a value greater than 239.255.255.255 is specified in the line-number line of the information file for higher connection destinations. The definition in the line is still valid, but the multicasting address specification is invalid.
Use Option "MultiBoard Environment": Not Execution Set multiple network adapters is selected in the client setup; connection destinations cannot be changed automatically.
Use Option "Auto Change higher manager by instructions to execute job": Not Execution Automatically set the higher system that sent an execution request as a connection destination is selected in the client setup; connection destinations cannot be changed automatically.