Hitachi

JP1 Version 12 for UNIX Systems JP1/File Transmission Server/FTP Description, Reference and Operator's Guide


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:

Table 3‒11: Attributes of the definition file (ftslog.conf)

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:

[Figure]

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.

Table 3‒12: Definition names and 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:

[Figure]