J.4 Settings for outputting action log data

Use the jpccomm.ini file to specify the settings for outputting action logs. If you do not specify these settings, action logs will not be output. This subsection describes the settings and procedure for outputting action logs.

Organization of this subsection

(1) How to specify settings
(2) Details of the jpccomm.ini file

(1) How to specify settings

To specify settings for outputting action logs:

Stop all PFM services on the host.
Edit the jpccomm.ini file using a program such as a text editor.
Save the jpccomm.ini file and then close it.

To Page Top

(2) Details of the jpccomm.ini file

This subsection describes the jpccomm.ini file.

(a) Storage directory

Table J‒5: jpccomm.ini file storage directory
OS environment	Host environment	Storage directory
Windows	Host environment	`installation-folder`
Windows	Logical host	`environment-directory`^#`\jp1pc\`
Linux	Host environment	`/opt/jp1pc/`
Linux	Logical host	`environment-directory`^#`/jp1pc/`

#: The environment directory is on the shared disk that was specified when the logical host was created.

(b) Format

The following information is defined in the jpccomm.ini file:

Whether action logs are to be output
Action log output destination
Number of action log files to be saved
Size of the action log files

The specification format is as follows:

"item-name"=value

The following table lists and describes the settings.

Table J‒6: Settings and their initial values that are specified in the jpccomm.ini file
No.	Item	Description
1	`[Action Log Section]`	Specifies the section name. This item cannot be changed.
2	`Action Log Mode`	Specifies whether action logs are to be output. This item is mandatory. Initial value `0` (Do not output) Permitted values `0` (Do not output), `1` (Output) If any other value is specified, an error message is issued and action logs are not output.
3	`Action Log Dir`	Specifies the action log output destination. In a logical host environment, specify a directory on the shared disk. If the specified directory is not on the shared disk, action logs are output to each physical host that constitutes the logical host. If the specified path exceeds the maximum length or access to the specified directory fails, an error message is output to the common log and action logs are not output. Initial value None Value assumed when the item is omitted (default) • In Windows `installation-folder\auditlog\` • In Windows (for logical host operation) `environment-directory`^#`\jp1pc\auditlog\` • In Linux `/opt/jp1pc/auditlog/` • In Linux (for logical host operation) `environment-directory`^#`/jp1pc/auditlog/` # The environment directory is on the shared disk that was specified when the logical host was created. Permitted values Character strings from 1 to 185 bytes in size
4	`Action Log Num`	Specifies the maximum number of log files. This is the total number of the current output file and the shift files. Initial value None Value assumed when the item is omitted (default) `5` Permitted values Integer in the range from 2 to 10 If a nonnumeric character is specified, an error message is output and `5` is set as the default. If the specified value is outside the permitted range, an error message is output and the integer in the range from 2 to 10 that is closest to the specified value is set.
5	`Action Log Size`	Specifies the log file size in kilobytes. Initial value None Value assumed when the item is omitted (default) `2048` Permitted values Integer in the range from 512 to 2,096,128. If a nonnumeric character is specified, an error message is output and the default value of 2,048 is set. If the specified value is outside the permitted range, an error message is output and the integer in the range from 512 to 2,096,128 that is closest to the specified value is set.

To Page Top