14.4.1 Checking log files

If a problem occurs, JP1/IT Desktop Management 2 - Agent acquires log data. Check the logs, and then take action. You can view the log contents for each PC.

JP1/IT Desktop Management 2 - Agent collects the following three types of log data about the distribution function, by using Remote Installation Manager:

Agent basic log (USER_CLT.LOG file)
Log data for the entire JP1/IT Desktop Management 2 - Agent (Windows event log and MAIN.LOG file)
Log data relating to automatic change of connection destinations (USER.LOG file)

Use the Windows Event Viewer Windows to check the Windows event log. Use a text editor to check other log files, which are stored in JP1/IT Desktop Management 2 - Agent-installation-directory\log.

The following describes each log file:

Organization of this subsection

(1) Agent basic log
(2) Log data for the entire JP1/IT Desktop Management 2 - Agent
(3) Log data relating to automatic change of connection destinations

(1) Agent basic log

Basic log messages about agent operations are output to the USER_CLT.LOG file for each PC. We recommend that you first view this file to check the agent operation. This file contains simple messages indicating that each process has started or stopped. If a process fails, the cause of the error is also output to this file.

The following operations cause data to be output to the USER_CLT.LOG file:

Starting and stopping products and processes
Logon and logoff
Receiving a job execution request
Polling
Receiving and executing jobs
Downloading packages
Uploading a file
Automated registration of system configuration information
Registration in and unregisgration from an ID group
Packaging
Internal error and application exception

For details about the file format and messages, see the manual Job Management Partner 1 Version 10 Job Management Partner 1/IT Desktop Management 2 - Messages.

To Page Top

(2) Log data for the entire JP1/IT Desktop Management 2 - Agent

Log data for the entire JP1/IT Desktop Management 2 - Agent is acquired in the Windows event log and the MAIN.LOG file.

(a) Checking the Windows event log

You can use Event Viewer to check the event log data acquired while using JP1/IT Desktop Management 2 - Agent. In the Log menu of the Event Viewer, you can select Select Computer to check events of other PCs running Windows. For details about how to use the Event Viewer, see the Windows documentation or Help.

Numbers (event IDs) displayed in the Event column in the Event Viewer are equivalent to message IDs. The following describes the meanings of the numbers.

Table 14‒4: Event IDs and their meanings (for JP1/IT Desktop Management 2 - Agent)
Event ID	Description
0 to 999	Windows interface-related
1000 to 1999	TCP/IP-related
5000 to 5999	Setup-related
6000 to 6999	Packaging-related
7000 to 7999	Installation-related
8000 to 8999	Relay-related
10000 to 19999	Managing server-related

In the Event Viewer window, double-click an event to display a detailed description of that event.

Depending on the event, memory dump information might be output in event details. If you contact us about JP1/IT Desktop Management 2 - Agent errors, please provide us with this memory dump information also.

For details about event log messages output by JP1/IT Desktop Management 2, see the manual Job Management Partner 1 Version 10 Job Management Partner 1/IT Desktop Management 2- Messages.

(b) Checking the MAIN.LOG file

For each PC, JP1/IT Desktop Management 2 - Agent acquires log data also in the MAIN.LOG file. The following shows the file format.

Figure 14‒5: MAIN.LOG file format

The meanings of message type and function type displayed in the MAIN.LOG file are as follows.

Table 14‒5: Message types in the Main.LOG file (for JP1/IT Desktop Management 2 - Agent)
Message type	Meaning
`Informational`	Information message
`Warning`	Warning message
`Error`	Error message

Table 14‒6: Function types in the Main.LOG file (for JP1/IT Desktop Management 2 - Agent)
Function type	Meaning
`Package`	During packaging (error in JP1/IT Desktop Management 2 - Agent)
`Install`	During installation (error in JP1/IT Desktop Management 2 - Agent)
`Setup`	During installation in GUI installation mode (error in JP1/IT Desktop Management 2 - Agent)
`TCP/IP`	Interface with TCP/IP
`System`	Interface with Windows
`User`	User log (output from the `LogFile` function of the installation script)
`Server`	During relay (error in JP1/IT Desktop Management 2 - Agent)

To Page Top

(3) Log data relating to automatic change of connection destinations

If the connection destination of an agent is automatically set or changed based on the information file for higher connection destinations, log data for each PC is collected in the USER.LOG file. The following shows the format of the USER.LOG file.

Figure 14‒6: USER.LOG file format

The following shows the meaning of message text displayed in the message is as follows:

Message text	Meaning
`Match [smallest-ID-address]-[largest-ID-address]:Change [old-connection-destination:product-type-of-old-connection-destination]->[new-connection-destination:product-type-of-new-connection-destination]`	The connection destination of the agent was changed normally.
`Match [smallest-ID-address]-[largest-ID-address]:No Changed [existing-connection-destination:type-of-existing-connection-destination]`	The connection destination that has already been set matches the definition in the information file for higher connection destinations. The connection destination does not change.
`No Match IP Address List, No Changed [existing-connection-destination:` `product-type-of-existing-connection-destination]`	The IP address of the agent is not found in the definition of the information file for higher connection destinations. The connection destination does not change.
`Not exist No.[order-of-the-item] Value: LineNo[line-number]`	In the line [`line-number`] in the information file for higher connection destinations, the `n`th item (`n` is indicated by `order-of-the-item`) is not specified. The definition of this line is invalid.
`IP Address is not available:"[specified-value]" :LineNo[line-number]`	In the line [`line-number`] in the information file for higher connection destinations, an invalid IP address is specified. The definition of this line is invalid.
`Higher manager value is over 64 character:"[specified-value]" :LineNo[line-number]`	In the line [`line-number`] in the information file for higher connection destinations, more than 64 single-byte characters are specified as the connection destination. The definition of this line is invalid.
`Connection type value is not "netmdm" or "netmdmw":"[specified-value]" :LineNo[line-number]`	In the line [`line-number`] in the information file for higher connection destinations, a value other than `netmdm` and `netmdmw` is specified as the device type of the connection destination. The definition of this line is invalid.
`Match [smallest-ID-address]-[largest-ID-address]:Change Multicast IP Address [old-multicast-address]->[new-multicast-address]`	The multicast address of the agent was changed normally.
`Match [smallest-ID-address]-[largest-ID-address]:No Changed Multicast IP Address [multicast-address]`	The multicast address that has already been set matches the definition in the information file for higher connection destinations. The multicast address does not change.
`Multicast IP Address is not available:"[multicast-address]":LineNo[line-number]`	In the line [`line-number`] in the information file for higher connection destinations, an invalid multicast address is specified. The definition of this line is valid, except for the multicast address setting.
`Multicast IP Address is under 224.0.0.0:"[specified-value]":LineNo[line-number]`	In the line [`line-number`] in the information file for higher connection destinations, a multicast address smaller than 224.0.0.0 is specified. The definition of this line is valid, except for the multicast address setting.
`Multicast IP Address is over 239.255.255.255:"[specified-value]":LineNo[line-number]`	In the line [`line-number`] in the information file for higher connection destinations, a multicast address larger than 239.255.255.255 is specified. The definition of this line is valid, except for the multicast address setting
`Use Option "MultiBoard Environment": Not Execution`	Automatic change of connection destinations is disabled because the network adapter has been configured during setup of the agent.
`Match [smallest-ID-address]-[largest-ID-address]:Clear SubHostName [registry-number]`	The connection destination that has already been set and that does not match the definition in the information file for higher connection destinations was deleted from the registry.
`Match [smallest-ID-address]-[largest-ID-address]:Clear SubServiceName [registry-number]`	For the connection destination that has already been set, the device type that does not match the definition in the information file for higher connection destinations was deleted from the registry.
`Match [smallest-ID-address]-[largest-ID-address]:Changed Multi Server Option [YES\|NO]`	Settings to perform polling for multiple higher systems were changed normally. If polling to multiple higher systems is performed, YES is displayed. If not, NO is displayed.

To Page Top