Job Management Partner 1/Remote Control Description and Operator's Guide

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

Appendix K.1 Remote control facility logs

This subsection describes what logging information is collected while the remote control facility is in use, as well as the format in which the information is output.

From the log files, you can view basic operation information such as the remote control modes or connected/disconnected remote control programs. The controller log file is output to RcHstCtr.log. The agent log file is output to RcHstAgt.log.

You can determine whether the log should be output and what kind of information should be output by configuring the settings in the Properties dialog box's Logging page on the controller, and in the Remote Control Agent Settings on the agent. For details on how to configure these settings on a controller, see 3.3.7 Logging page. For agents, see 3.4.5 Settings for logging. For both controllers and agents, the default setting is not to output log information.

Log information is output to the following destinations:

Organization of this subsection
(1) Log output directory
(2) Logging format
(3) Output information

(1) Log output directory

Logging information is output to the following location:

For Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 and Windows Vista
Controller
%SYSTEMDRIVE%\ProgramData\hitachi\jp1rcmgr\log\RcHstCtr.log
Agent
%SYSTEMDRIVE%\ProgramData\hitachi\jp1rcagt\log\RcHstAgt.log

For Windows Server 2003, Windows XP, and Windows 2000#
Controller
%SYSTEMDRIVE%:\Documents and Settings\All Users\Application Data\hitachi\jp1rcmgr\log\RcHstCtr.log
Agent
%SYSTEMDRIVE%:\Documents and Settings\All Users\Application Data\hitachi\jp1rcagt\log\RcHstAgt.log

For Windows NT 4.0, Windows Me, and Windows 98
Controller
\remote-control-manager-installation-destination-directory\log\RcHstCtr.log
If the program is installed in the default directory, the log is output to the following file:
C:\Program Files\hitachi\jp1rcmgr\log\RcHstCtr.log
Agent
\remote-control-agent-installation-destination-directory\log\RcHstAgt.log
If the program is installed in the default directory, the log is output to the following file:
C:\Program Files\Hitachi\jp1rcagt\log\RcHstAgt.log

#
The Application Data directory is not displayed by default.

To display the Application Data directory, change the view settings as follows:

  1. Double-click the My Computer icon.
  2. From the Tools menu, choose Folder Options.
  3. From the View tab, select the Advanced area's Show hidden files and folder option.
  4. Click the OK button.

These settings can also be changed from Windows Explorer or Control Panel's Folder Options.

You can also manage log data by generation. The default generation count is 0. If you set the number 1 or above, the last 2 characters of the file name will be replaced with the generation number.

Example
Setting 1 :  RcHstC01.log
Setting 20:  RcHstC20.log

When the number of lines in a log file exceeds the maximum, a new log file xxxxxx01.log is created and the old log file is renamed xxxxxx02.log (xxxxxx is the first six characters of the log file name). Thereafter, each time a new log file is created, the generation number at the end of the old log file name increases by one. When the number of created generations exceeds the maximum, the oldest log file is deleted.

(2) Logging format

This section describes, with an output example, the logging format when the remote control facility is used.

Figure K-1 Logging format when the remote control facility is used

[Figure]

(a) Counter section

Represents the line number for which a log has been output. Columns 1 to 10 contain the counter section's header, and columns 12 to 15 contain the final logging number. For example, in DATA COUNT 0007, DATA COUNT is the header, and 0007 represents the final output line number.

(b) Log information section

The log information section is from the second line onwards. It is comprised of the log's line number, the output date and time, and the log information. They are described in the following format:

Format
0001 MM/DD/YYYY hh:mm:ss:nnn log-type IP-address log-information
0001
Represents the line number in a value between 0001 and 9999. Set in columns 1 to 4.
MM/DD/YYYY
Represents the date. Set in columns 7 to 16.
hh:mm:ss:nnn
Represents the time. nnn indicates a value in milliseconds. Set in columns 18 to 29.
log-type
Represents the type of the log. Set in columns 33 to 43.
  • Information
    Indicates information.
  • Warning
    Indicates a warning.
  • Error
    Indicates an error.
IP-address
Set in columns 45 to 60.
log-information
Set in columns 62 to 161 (99 characters). If the actual log information is shorter than 99 characters, blank spaces are added so that the information will be output in 99 characters.

(3) Output information

Table K-1 lists the contents of log information output by a controller. Table K-2 shows the contents of log information output by an agent.

Table K-1 Controller's log output information and messages

Information type Contents of log information
Connection start Connect Start. Agent Hostname=host-name,
Port=port-number
Connection shutdown Connect Shutdown Request.
Reconnection Connect Restart. Port=port-number
Connection failure Connect Error Occurred.
Error Code=error-code(brief-description-of-the-error)
Authentication failure (permitting controller) Connect Refuse. Controller Not Permit
Authentication failure (user authentication) Connect Refuse. User (user-name#) Authentication Failed (brief-description-of-the-error)
Optimize transaction option HighSpeedOption{Request|Change}. CompOption={Yes|No},
CompSize=size, PollingTime=milliseconds, FlowControl={Yes|No}
HighSpeedOption{Request|Change}. WallpaperOption={Yes|No},
AnimationOption={Yes|No}, DragOption={Yes|No}
HighSpeedOption{Request|Change}. BitmapCache={Yes|No},
UseLocalFont={Yes|No},
ConvertBitmapColor
={monochrome|16 Colors|256 Colors}
HighSpeedOption{Request|Change}.
ActiveDesktop={Yes|No}
Remote control mode RemoteControlMode{Request|Change}. Request={View|Shared|Exclusive},
Response={View|Shared|Exclusive}
Shutdown button Agent Shutdown Request.
Reboot button Agent Reboot Request.
Ctrl + Alt + Delete button Ctrl+Alt+Delete Request.
Line disconnection/failure Socket Error(error-function) Occurred.
Error Code=error-code(brief-description-of-the-error)
Manual disconnection made by agent user Connect Refuse. Connection was rejected by Agent user.
Automatic disconnection made by agent user Connect Refuse. No response from the Agent user.

Note
If a number of items separated by a vertical bar (|) are enclosed in braces ({}), one of the items is selected based on the configuration and/or connection condition and is output.

#
The user name entered from the controller is output.

Table K-2 Agent's log output information and messages

Information type Contents of log information
Connection start Connect Start. Port=port-number
Connection shutdown Connect Shutdown.
Connection failure Connect Error Occurred. Error Code=error-code
Authentication successful (permitted controller) Controller (host-name-or-IP-address)#1 Authentication Success.
Authentication failure (permitting controller) Connect Refuse. Controller Not Permit
Authentication successful (user authentication) User (user-name#2) Authentication Success.
Authentication failure (user authentication) Connect Refuse. User (user-name#2) Authentication Failed (brief-description-of-the-error)
Optimize transaction option HighSpeedOption Receive. CompOption={Yes|No},
CompSize=size, PollingTime=milliseconds, FlowControl={Yes|No}
HighSpeedOption Receive. WallpaperOption={Yes|No},
AnimationOption=Yes, DragOption={Yes|No}
HighSpeedOption Receive. BitmapCache={Yes|No},
UseLocalFont={Yes|No}, ConvertBitmapColor
={monochrome|16 Colors|256 Colors}
Remote control mode RemoteControlMode Receive. Request={View|Shared|Exclusive},
Response={View|Shared|Exclusive}
Shutdown button Agent Shutdown Receive.
Reboot button Agent Reboot Receive.
Ctrl + Alt + Delete button Ctrl + Alt + Delete Receive.
Line disconnection / failure Socket Error (error-function) Occurred.
Error Code=error-code (brief-description-of-the-error)
Manual disconnection made by agent user Connect Refuse. Connection was rejected by Agent user.
Automatic disconnection made by agent user Connect Refuse. No response from the Agent user.

Note
If a number of items separated by a vertical bar (|) are enclosed in braces ({}), one of the items is selected based on the configuration and/or connection condition and is output.

#1
If the connection is permitted for a host name, the host name is output. If the connection is permitted for an IP address, the IP address is output.

#2
The user name entered from the controller is output.