3.10.1 How to specify
Create a definition file (ftslog.conf) as shown below. The definitions take effect when the event log daemon (jftslogd) starts.
- Organization of this subsection
(1) Attributes of the definition file
Create a definition file with the following attributes:
Item name |
Setting |
---|---|
File name |
ftslog.conf |
Directory name |
/var/opt/jp1_fts/sys |
Owner |
Superuser |
Access permission |
Owner: r |
(2) Contents of the definition file
Use a text editor to write definitions in the definition file (ftslog.conf) according to the method described below.
The following figure shows the format of a definition file:
In a definition file, one definition is specified on a single line. A maximum of 2,048 bytes can be specified per line.
There must be space or a tab between a definition name and the colon (:) and between the colon and a value. The definition name can be preceded by spaces or tabs. Any number of characters following a hash mark (#) through a linefeed code are treated as a comment.
If there is no definition file or the definition is invalid, the command uses the default values.
The following table lists and describes the definition names and the values.
Definition name |
Description |
Value |
---|---|---|
rotation size |
Specifies the maximum size of an event log file (in megabytes). Event log files are rotated so that the size of a file does not exceed the specified size. |
((1 to 9,999)) <<2>> |
rotation days |
Specifies a usage period for an event log file (in days). When the specified number of days elapses for one event log, the next event log is used. |
((1 to 366)) <<omitted>> |
rotation files |
Specifies the number of backup event log files. Rotation occurs among the specified number of files. |
((2 to 500)) <<5>> |
output level |
Specifies output levels for the event log. Only events at the specified levels are output. To specify multiple levels, delimit them with the comma (,). Example: output level : 0,1,2 |
((0 to 6)) <<0, 1, 2, 3, 4, 5, 6>> |
file name |
Specifies the name of the default event log file, expressed as a full path. The actual file name is generated by suffixing .serial-number to the specified default file name. Example: If the default file name is /var/log/ftsevent.log, the first file that is generated will be /var/log/ftsevent.log.1. The serial number that is assigned is from 1 to the number of event log backup files. Example: In the above example, if the number of backup files is 3, the following files are generated: "/var/log/ftsevent.log.1" "/var/log/ftsevent.log.2" "/var/log/ftsevent.log.3" |
((1 to 250 bytes)) <</var/opt/jp1_fts/trace/ftsevent.log>> |
The following table describes the output levels for the event log.
Level |
Messages that are output |
---|---|
0 |
Error messages reporting an error that resulted in cancellation or termination of processing |
1 |
Messages reporting an error in a function that did not result in cancellation or termination of processing but that prevented normal operation of the function |
2 |
Start and termination of the daemon |
3 |
Transmission termination status |
4 |
Transmission start status |
5 |
Details of the transmission status |
6 |
ftstran command status messages |
The following figure shows an example of a definition file: