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

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

5.3.2 Settings

Specify the settings in the environment parameters file in the following format:

[section]
label=value
label=value
...
...
[section]
label=value
label=value

Notes
  • Do not specify any unneeded characters, such as spaces at the beginning of a line or before and after an equals sign (=).
  • The values specified in section and label are not case-sensitive.
  • A line beginning with a semicolon (;) is treated as a comment.

The following tables describe the contents of each section in the environment parameters file.

Organization of this subsection
(1) EXTRACTFILE section
(2) FORMAT section
(3) TRACE section
(4) CONNECT section

(1) EXTRACTFILE section

The EXTRACTFILE section specifies information about the file to which system log information is to be output.

Table 5-1 Values permitted in the EXTRACTFILE section

Label Description Permitted values Default value
SIZE Size of the output file:
  • 0: Maximum value for the system#1
  • 1-65535: Wraparound within the specified size (in kilobytes)
 0-65535 1024
X2PATH Path to the output file#2, #3 1-255 single-byte alphanumeric characters. If a relative path is specified, it is treated as the path relative to the instance environment directory.
  • In Windows: log\SYSLOG
  • In UNIX: log/SYSLOG

#1
This is 0x7FFFFFFF (about 2 gigabytes), which can be expressed as a 32-bit signed integer.

#2
A management file named output-file-name.ofs is created in the same directory as the specified output file (e.g., if SYSLOG is specified as the output file name, SYSLOG.ofs is created as a management file in addition to the SYSLOG file). If you delete this output file, make sure that you also delete the management file.

#3
If the default storage location is changed, the jpcras command cannot collect the information in the event of a problem.

(2) FORMAT section

The FORMAT section specifies the output format of the system log information.

Table 5-2 Values permitted in the FORMAT section

Label Description Permitted values Default values
COLUMN Output format of system log information Field ID. For details about the field ID, see 10. Commands. Column 1: <TIME>
Column 2: <INSTANCE>
Column 3: <USER>
Column 4: <PROGRAM>
Column 5: <MSGNO>
Column 6: <MSGTEXT>

(3) TRACE section

The TRACE section specifies information about the message log and data log that store the history of system log information extraction.

Table 5-3 Values permitted in the TRACE section

Label Description Permitted values Default value
MSGLOG_LEVEL Message log collection level for saving application trace information:
  • 0: Do not collect
  • 1: Collect only errors
  • 2: Standard
  • 3: Details
  • 4: Debug
 0-4 2
MSGLOG_SIZE File size for collecting the message log:
  • 0: Maximum value for the system#
  • 1-65535: Wraparound within the specified size (in kilobytes)
 0-65535 512
MSGLOG_DIR Message log file (jr3slget.log) collection-target directory (Cannot be changed) log
DATALOG_LEVEL Data log collection level for saving various types of data information for applications:
  • 0: Do not collect
  • 1: Collect only errors
  • 2: Standard
  • 3: Details
  • 4: Debug
 0-4 2
DATALOG_SIZE File size for collecting the data log:
  • 0: Maximum value for the system#
  • 1-65535: Wraparound within the specified size (in kilobytes)
 0-65535 512
DATALOG_DIR Data log file (jr3slget.dat) collection-target directory (Cannot be changed) log

#
This is 0x7FFFFFFF (about 2 gigabytes), which can be expressed as a 32-bit signed integer.

(4) CONNECT section

The CONNECT section specifies information needed to establish RFC connection with the SAP system.

Table 5-4 Values permitted in the CONNECT section

Label Description Permitted value Default value
LANG User language used for connection 2-byte ISO ID or 1-byte language key that is used in the SAP system:
  • EN or E
 None
CODEPAGE Code page used to convert character codes in the Unicode version of the SAP system at the destination Value combined with the language in the LANG label# None

#
Set the LANG and CODEPAGE labels in the applicable combination shown below. If any other combination of language and code page is specified, an encoding error might occur in the information acquired from the SAP system.

Table 5-5 Combination of language and code page specifications

Connection-target SAP system Connection language Language (LANG) Code page (CODEPAGE)
Unicode version English EN No need to specify. If you specify a code page, specify 1100.
Non-Unicode version English EN No need to specify. If you specify a code page, specify 1100.
If you omit specification of the LANG label, the user language defined in the connection-target system is assumed.
If you omit specification of the CODEPAGE label, the default code page in the connection-target system is assumed.

[Contents][Back][Next]

[Trademarks]

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