7.3.1 Output modes and notes for log files and trace files

(1) Output-destination file rotation modes

The following table shows the rotation modes:

Rotation method	Description
Wraparound mode(default)	Numbers of files are added to the file name. (example) When the log file name is "hntrN.log" and the number of files is"2" Log file name: "hntr1.log", "hntr2.log"
Shift mode	The file name is fixed, and the numbers of files are added to the name of backup files. (example) When the log file name is "hntr.log", and the number of files is"2" Log file name: "hntr.log" (fixed) Backup file name of the log file:"hntr1.log","hntr2.log"

To Page Top

(2) Output-destination file switchover modes

The current log file or trace file switches based on a certain condition. The two switchover modes are as follows:

• Switching with the file size

  When the file size reaches the specified value, you can switch the output destination file.

• Switching with the file size or at a timing

  If either of the following conditions is met, you can switch the output destination file.

  • The specified time has been reached.

  • The specified file size has been reached.

You need to estimate the proper trace file size. Estimate the total size of trace files based on the following information:

• Quantity of messages received per day (in messages)

• Duration of saved trace information (in days)

Calculate the total size of files, and then estimate the size of one trace file and the number of files that will be needed based on the calculated total file size.

Set the trace file size and number of trace files in the HCSC server runtime definition file. For details about the file, see 6.5.6 HCSC server runtime definition file in the Service Platform Reference Guide.

To Page Top

(3) Notes on acquisition of log and trace data: General notes

The following notes apply to all logs and traces other than the performance analysis traces:

• Files cannot be edited.

• A text viewer or editor with a lock option is not supported. If files are locked, no trace can be output.

• File access permissions cannot be changed.

  If you need to set access permissions manually, set appropriate access permissions. If the access permissions you set are not appropriate, trace output is disabled.

• The file update time cannot be changed.

  If you change the file update time, the output target file may be altered.

• Do not rename or delete a file during trace output processing.

  The target file can be determined from information in the management file. If the management file is not available or is damaged, the output target file is determined based on the file update time. If you need to rename or delete a file, first terminate all trace output processes.

To Page Top

(4) Notes on acquisition of log and trace data: Notes for only HCSC-Manager logs

• The linefeed code at the end of a message is always CR+LF regardless of the platform you are using.

• The following notes also apply to exception and maintenance logs:

  • After you have changed the file size and/or number of files, to apply the changes, you must delete files. Before you delete a file, terminate the trace output process. Delete all files in the directory specified for the cscmng.log.dir property in the HCSC-Manager definition file.

  • In an output trace file, data up to the first EOF character (0x1A) is valid. Data following the EOF character is not guaranteed. Note that the first EOF character may be followed by another EOF character.

  • Even when a trace is output, updating of the file update time is not guaranteed. Whether or not the trace has been output cannot be determined based on the file update time. The file update time is updated when trace output processing is terminated.

To Page Top