Hitachi

JP1 Version 12 JP1/Performance Management - Remote Monitor for Platform Description, User's Guide and Reference


J.4 Action log output settings

Use the jpccomm.ini file to specify settings that enable output of action logs. If you do not specify these settings, action logs will not be output. This subsection describes how to specify the action log output settings and provides details about the jpccomm.ini file.

Organization of this subsection

(1) How to specify the settings

To specify the action log output settings:

  1. Stop all Performance Management services on the host.

  2. Use a program such as a text editor to edit the jpccomm.ini file.

  3. Save the jpccomm.ini file, and then close it.

(2) Details of the jpccomm.ini file

This subsection describes the jpccomm.ini file.

(a) Storage folder

The storage folder is PFM-Manager-installation-folder.

(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 file

The specification format is as follows:

"item-name"=value

The following table lists and describes the settings to be specified in the jpccomm.ini file.

Table J‒8: Settings specified in the jpccomm.ini file and their initial values

Item

Description

[Action Log Section]

Specifies the section name. This item cannot be changed.

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 output, in which case action logs are not output.

Action Log Dir

Specifies the output destination for action logs, using an absolute path.

In a logical host environment, specify a directory on the shared disk.

If the directory you specify is not on the shared disk, Performance Management will output action logs to each physical host that forms the basis for the logical host.

If you specify a path that exceeds the maximum allowable length, or the system is unable to access the directory, an error message is output to the common log and Performance Management will not output action logs.

  • Initial value:

    Omitted

  • Value used when this item is omitted (default):

    On physical hosts:

    - Windows: installation-folder\auditlog

    - UNIX: /opt/jp1pc/auditlog/

    On logical hosts:

    - Windows: environment-directory\jp1pc\auditlog

    - UNIX: environment-directory/jp1pc/auditlog

  • Available values:

    Character strings from 1 to 185 bytes in length

Action Log Num

Specifies the maximum number of log files. This is the total number of current output file and shift files.

  • Initial value

    Omitted

  • 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 the value 5 (the default) is set.

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 the closest to the specified value is set.

Action Log Size

Specifies the log file size in kilobytes.

  • Initial value

    Omitted

  • Value assumed when the item is omitted (default)

    2,048

  • Permitted values

    Integer in the range from 512 to 2,096,128

If a nonnumeric character is specified, an error message is output and a value of 2,048 (the default) 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 the closest to the specified value is set.