Job Management Partner 1/Remote Control Description and Operator's Guide
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:
Logging information is output to the following location:
%SYSTEMDRIVE%\ProgramData\hitachi\jp1rcmgr\log\RcHstCtr.log
%SYSTEMDRIVE%\ProgramData\hitachi\jp1rcagt\log\RcHstAgt.log
%SYSTEMDRIVE%:\Documents and Settings\All Users\Application Data\hitachi\jp1rcmgr\log\RcHstCtr.log
%SYSTEMDRIVE%:\Documents and Settings\All Users\Application Data\hitachi\jp1rcagt\log\RcHstAgt.log
\remote-control-manager-installation-destination-directory\log\RcHstCtr.log
\remote-control-agent-installation-destination-directory\log\RcHstAgt.log
To display the Application Data directory, change the view settings as follows:
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.
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.
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
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.
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:
0001 MM/DD/YYYY hh:mm:ss:nnn log-type IP-address log-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. |
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. |
All Rights Reserved. Copyright (C) 2009, 2013, Hitachi, Ltd.