Job Management Partner 1/Performance Management - Agent Option for Enterprise Applications Description, User's Guide and Reference

[Contents][Glossary][Index][Back][Next]

Appendix 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:

  1. Stop all PFM services on the host.

  2. Edit the jpccomm.ini file using a program such as a text editor.

  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 directory

Table J-5 jpccomm.ini file storage directory

Platform Storage directory
Windows installation-folder
Windows (for logical host operation) environment-directory#\jp1pc\
UNIX /opt/jp1pc/
UNIX (for logical host operation) 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:

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)
    [Figure] In Windows
    installation-folder\auditlog\
    [Figure] In Windows (for logical host operation)
    environment-directory#\jp1pc\auditlog\
    [Figure] In UNIX
    /opt/jp1pc/auditlog/
    [Figure] In UNIX (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.

[Contents][Back][Next]

[Trademarks]

All Rights Reserved. Copyright (C) 2010, Hitachi, Ltd.