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

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

Appendix K.2 File access logs

This subsection describes the logging information collected for file accesses performed in the File Transfer window, and the format of the output information.

The file access log files allow you to view a history of operations, such as the copying or deletion files and the creation of folders. The controller log file is output to RcHstCFT.log. The agent log file is output to RcHstSFT.log.

You can select which logs are to be output and what kind of information is to be output. For a controller, you configure the settings in the Logging page that is displayed by choosing Options in the File Transfer window. For an agent, you set up Remote Control Agent. For details on how to configure these settings on a controller, see 4.3.9(4) Logging page. For details on how to configure these settings on agents, see 3.4.6 File transmission settings. For each controller and agent, the default setting is not to output log information.

Organization of this subsection
(1) Log output directory
(2) Logging format
(3) Output information
(4) Output examples of file access logs

(1) Log output directory

Log information about file access is output to the following destinations.

Note that agent log information is also output to the controller.

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

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

For Windows NT 4.0, Windows Me, and Windows 98
Controller
\Remote-Control-Manager-installation-directory\log\RcHstCFT.log
When Remote Control Manager is installed in the default directory, log information is output to the following file:
C:\Program Files\hitachi\jp1rcmgr\log\RcHstCFT.log
Agent
\Remote-Control-Agent-installation-directory\log\RcHstSFT.log
When Remote Control Agent is installed in the default directory, log information is output to the following file:
C:\Program Files\Hitachi\jp1rcagt\log\RcHstSFT.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 number of generations is 0. If you set the number to 1 or above, the file name (RcHCFT or RcHSFT) will be replaced with the generation number.

Example
Setting 1 : RcHCFT01.log
Setting 20: RcHCFT20.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 RcHCFT or RcHSFT). 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

The following describes the logging format of file access logs with the use of an output example.

Figure K-2 Logging format of file access logs

[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 0006, DATA COUNT is the header, and 0006 represents the final output line number.

(b) Log information section

The log information section starts with the second line and is output in the CSV format. Each entry has 14 fields, including the line number, output date and time, and operation and object names. They are described in the following format:

Logging format
[Figure]
0001
Represents the line number in a value from 0001 to 9999.
MM/DD/YYYY hh:mm:ss:nnn
Represents the date and time when the operation was performed.
MM/DD/YYYY indicates the date, and hh:mm:ss:nnn indicates the time. nnn indicates a value in milliseconds.
operation
Represents the type of operation. For details about the displayed items, see Table K-3.
object-type
Represents the type of the object on which the operation was performed.
  • D: Folder
  • F: File
  • Unknown: The object type cannot be identified.
object-name
Represents the name of the object that performed the operation or on which the operation was performed.
Requestor information
Represents information about the machine that performed the operation on the object. This information corresponds to items 6 to 9 above.
  • IP-address (or host-name#1)
  • target-folder
  • attribute
  • user-name#2
Receiver information
Represents information about the machine on which the operation was performed on the object. This information corresponds to items 10 to 13 above.
  • IP-address (or host-name#1)
  • target-folder
  • attribute
  • user-name#2
details
Represents the authentication user for remote control during connection. If an access error occurs, a system error code is output.

#1
When a controller is connected by specifying the host name of an agent, the host name is displayed if name resolution fails.

#2
Information is output only when both the controller and the agent versions are 08-00 or later.

(3) Output information

The table below shows, in alphabetical order by item, the types of logs for items indicated in operation in the log information section.

Table K-3 Types of logs for items indicated in operation

Item Log type Meaning
attributes changed Attribute changes The change of a file or folder attribute has finished.
attributes changing Attribute changes The change of a file or folder attribute has started.
canceled#
  • Forwarded files
  • Deleted files
  • Created folders
  • Rename
  • Attribute changes
The operation was canceled.
connected Connection/disconnect Connection was established.
copied Forwarded files Copying of a file or folder has finished.
copying Forwarded files Copying of a file or folder has started.
created Created folders Creation of a folder has finished.
creating Created folders Creation of a folder has started.
deleted Deleted files Deletion of a file or folder has finished.
deleting Deleted files Deletion of a file or folder has started.
disconnected Connection/disconnect Disconnection occurred.
error#
  • Forwarded files
  • Deleted files
  • Created folders
  • Rename
  • Attribute changes
An error occurred.
moved Forwarded files Moving of a file or folder has finished.
moving Forwarded files Moving of a file or folder has started.
renamed Rename Renaming of a file or folder has finished.
renaming Rename Renaming of a file or folder has started.
warning#
  • Forwarded files
  • Deleted files
A warning occurred.

# The operation to which canceled, error, or warning applies is shown by the type of log that was output immediately before this information.


See the explanations in (a) to (f) for details about the information displayed for each type of log. Note that the line number and date are omitted.

(a) Connection/disconnect log

operation
The output items are as follows:
Item Meaning
connected The receiver (requestor) is connected.
disconnected The receiver (requestor) is disconnected.

object-type
No information is output.

object-name
No information is output.

Requestor information
host-name
Indicates the IP address (or host name) of the machine that requested connection or disconnection.
target-folder
No information is output.
attribute
No information is output.
user-name
Indicates the desktop logon user name of the machine that requested the connection. No information is output for disconnection.

Receiver information
host-name
Indicates the IP address (or host name) of the machine that accepted connection or disconnection.
target-folder
No information is output.
attribute
No information is output.
user-name
Indicates the desktop logon user name of the machine that accepted the connection. No information is output for disconnection.

details
Indicates the user name if the connection was established using the user authentication function.
(b) Forwarded files log

operation
The output items are as follows:
Item Meaning
copying Transfer (copying) of an object has started.
moving Transfer (moving) of an object has started.
copied Transfer (copying) of an object has finished.
moved Transfer (moving) of an object has finished.
error An error occurred during transfer of an object.
canceled Transfer of an object was canceled.
warning An object that was being transferred already existed at the destination (a confirmation message for overwriting the object was displayed).

object-type
Indicates whether the object is a folder or file.

object-name
Indicates the name of the object to be transferred.

Requestor information
host-name
Indicates the IP address (or host name) of the machine (sender) that requested the transfer.
target-folder
Indicates the path of the machine (sender) that requested the transfer (higher path for object-name).
attribute
No information is output.
user-name
Indicates the desktop logon user name of the machine (sender) that requested the transfer.

Receiver information
host-name
Indicates the IP address or host name of the machine (receiver) that accepted the transfer. If the controller performed the operation locally, the indicated IP address or host name is the same as that of the requestor.
target-folder
Indicates the path of the machine (receiver) that accepted the transfer (higher path for object-name).
attribute
No information is output.
user-name
Indicates the desktop logon user name of the machine (receiver) that accepted the transfer. If the controller performed the operation locally, the indicated user name is the same as that of the requestor.

details
Indicates a system error code if operation is error, or indicates 80 (a file exists) if operation is warning. No information is output when operation is neither error nor warning.

If an error occurs when Preparing is displayed in the Progress of the File Transfer dialog box, an error message appears, although no error is output to the log. Also, an error is not output if the file to be transferred does not exist.

(c) Deleted files log

operation
The output items are as follows:
Item Meaning
deleting Deletion of an object has started.
deleted Deletion of an object has finished.
error An error occurred during deletion of an object.
canceled Deletion of an object was canceled.
warning A read-only file was found during deletion of an object.

object-type
Indicates whether the object is a folder or file.

object-name
Indicates the name of the object to be deleted.

Requestor information
host-name
Indicates the IP address (or host name) of the machine that requested the deletion.
target-folder
No information is output.
Attribute
No information is output.
user-name
Indicates the desktop logon user name of the machine that requested the deletion.

Receiver information
host-name
Indicates the IP address or host name of the machine that accepted the deletion. If the controller performed the operation locally, the indicated IP address or host name is the same as that of the requestor.
target-folder
Indicates the path of the machine from which the object was to be deleted (higher path for object-name).
attribute
No information is output.
user-name
Indicates the desktop logon user name of the machine that accepted the deletion. If the controller performed the operation locally, the indicated user name is the same as that for the requestor.

details
Indicates a system error code if operation is error, or indicates read only (a read-only file exists) when operation is warning. No information is output if operation is neither error nor warning.

If an error occurs when Preparing is displayed in the Progress of File Deletion dialog box, an error message appears, although no error is output to the log. Also, an error is not output if the file to be deleted does not exist.

(d) Created folders log

operation
The output items are as follows:
Item Meaning
creating Folder creation has started.
created Folder creation has finished.
error An error occurred during folder creation.
canceled Folder creation was canceled.

object-type
Indicates D (folder).

object-name
Indicates the name of the folder to be created.

Requestor information
host-name
Indicates the IP address (or host name) of the machine that requested creation of the folder.
target-folder
No information is output.
attribute
No information is output.
user-name
Indicates the desktop logon user name of the machine that requested creation of the folder.

Receiver information
host-name
Indicates the IP address or host name of the machine that accepted creation of the folder. If the controller performed the operation locally, the indicated IP address or host name is the same as that for the requestor.
target-folder
Indicates the path of the machine where the object was to be created (higher path for object-name).
attribute
No information is output.
user-name
Indicates the desktop logon user name of the machine that accepted creation of the folder. When the controller performed the operation locally, the indicated user name is the same as for the requestor.

details
Indicates a system error code if operation is error. No information is output if operation is not error.
(e) Rename log

operation
The output items are as follows:
Item Meaning
renaming Renaming has started.
renamed Renaming has finished.
error An error occurred during renaming.
canceled Renaming was canceled.

object-type
Indicates whether the object is a folder or file.

object-name
Name of the object to be renamed.

Requestor information
host-name
Indicates the IP address (or host name) of the machine that requested renaming.
target-folder
Indicates the path after the renaming.
Attribute
No information is output.
user-name
Indicates the desktop logon user name of the machine that requested renaming.

Receiver information
host-name
Indicates the IP address (or host name) of the machine that accepted the renaming. If the controller performed the operation locally, the indicated IP address or host name is the same as that for the requestor.
target-folder
Indicates the path before the renaming.
attribute
No information is output.
user-name
Indicates the desktop logon user name of the machine that accepted renaming. If the controller performed the operation locally, the indicated user name is the same as that for the requestor.

details
Indicates a system error code if operation is error. No information is output if operation is not error.

Note that when one of the following operations is performed, an error message appears in a window, but no information is output to the log:

(f) Attribute changes log

operation
The output items are as follows:
Item Meaning
attributes changing Changing of the attribute has started.
attributes changed Changing of the attribute has finished.
error An error occurred during changing of the attribute.
canceled Changing of the attribute was canceled.

object-type
Indicates whether the object is a folder or file.

object-name
Indicates the name of the object whose attribute was to be changed.

Requestor information
host-name
Indicates the IP address (or host name) of the machine that requested changing of the attribute.
target-folder
No information is output.
Attribute
Indicates the code of the attribute after the change. For the meaning of the output codes, see Table K-4.
user-name
Indicates the desktop logon user name of the machine that requested to change the attribute.

Receiver information
host-name
Indicates the IP address or host name of the machine that accepted changing of the attribute. If the controller performed the operation locally, the indicated IP address or host name is the same as that or the requestor.
target-folder
Indicates the path of the machine where the attribute was to be changed (higher path for object-name).
Attribute
Indicates the code of the attribute before the change. For the meaning of the output codes, see Table K-4.
user-name
Indicates the desktop logon user name of the machine that accepted changing of the attribute. If the controller performed the operation locally, the indicated user name is the same as that for the requestor.

details
Indicates a system error code if operation is error. No information is output if operation is not error.

The table below shows the meaning of the codes output for Attribute.

Table K-4 Output attribute codes

Code Meaning
A Archive
C Compression
H Hidden file
R Read-only
S System

(4) Output examples of file access logs

The following provides an example of outputting file access logs. In this example, a controller and an agent are defined as follows:

Controller
  • IP address: 10.100.100.1
  • Desktop logon user name: Admin

Agent
  • IP address: 10.100.100.2
  • Desktop logon user name: User

The example assumes that the following operations were performed between the controller and the agent.

  1. ABC.txt in D:\Temp on the controller was moved to C:\temp on the controller.
  2. ABC.txt in C:\Temp on the controller was moved to D:\temp on the agent.
  3. An attempt to copy ABC.txt in C:\Temp on the controller to A: on the agent failed (The operation was canceled after the error occurred (error code 21)).

The following indicates the file access logs output in this example.

(a) File access logs output on the controller

Figure K-3 Example of file access logs output on the controller

[Figure]

(b) File access logs output on the agent

Figure K-4 Example of file access logs output on the agent

[Figure]