6.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) TARGET section
The TARGET section specifies information that identifies the CCMS alert information to be extracted.
Label |
Description |
Permitted values |
Default value |
---|---|---|---|
MONITOR_SET# |
Monitor set name (name displayed as CCMS monitor set on the SAP system Alert Monitor (transaction code RZ20)) |
1 to 60 single-byte alphanumeric characters |
SAP CCMS Monitor Templates |
MONITOR# |
Monitor name (name displayed in the tree of the CCMS monitor set on the SAP system Alert Monitor (transaction code RZ20)) |
1 to 60 single-byte alphanumeric characters |
Entire System |
- #
-
Specifying multiple targets is not permitted. To monitor multiple monitors, use the CCMS function of the SAP system to combine all the targets to be monitored into a single monitor, and then monitor this monitor from PFM - Agent for Enterprise Applications.
(2) EXTRACTFILE section
The EXTRACTFILE section specifies information about the file to which CCMS alert information is to be output.
Label |
Description |
Permitted values |
Default value |
---|---|---|---|
TYPE |
Format of file for storing CCMS Alert Information:
If you configure a new environment for PFM - Agent for Enterprise Applications, we recommend that you specify WRAP2. If you want to change the format of storage files after you have started system operations, first stop any products monitoring the storage files, and then delete the storage files and their management files#1. |
WRAP1 or WRAP2 |
WRAP2 Note that if there is no TYPE label for reasons such as upgrading from Version 9 or earlier, WRAP1 is assumed. |
SIZE |
Size of one storage file:
|
0 to 65535 |
10240#2 |
X2PATH |
|
|
|
NUM |
Number of files to be stored in the WRAP2 format. This is applicable only when WRAP2 is specified in the TYPE label. |
2 to 9 |
5 |
(3) FORMAT section
The FORMAT section specifies the output format of the CCMS alert information.
Label |
Description |
Permitted values |
Default values |
---|---|---|---|
COLUMN |
Output format of CCMS alert information |
Field ID. For details about the field ID, see Output format and contents in the jr3alget command in Chapter 10. Commands. |
Column 1: <ALERTDATE> Column 2: <ALERTTIME> Column 3: <MTSYSID> Column 4: <MTMCNAME> Column 5: <OBJECTNAME> Column 6: <FIELDNAME> Column 7: <VALUE> Column 8: <SEVERITY> Column 9: <MSG> |
TIMEZONE |
Time zone specification for the time information of the following field IDs
|
|
UTC |
(4) TRACE section
The TRACE section specifies information about the message log and data log that store the history of CCMS alert information extraction.
Label |
Description |
Permitted values |
Default value |
---|---|---|---|
MSGLOG_LEVEL |
Message log collection level for saving application trace information:
|
0-4 |
2 |
MSGLOG_SIZE |
File size for collecting the message log:
|
0-65535 |
512 |
MSGLOG_DIR |
Message log file (jr3alget.log) collection-target directory |
(Cannot be changed) |
log |
DATALOG_LEVEL |
Data log collection level for saving various types of data information for applications:
|
0-4 |
2 |
DATALOG_SIZE |
File size for collecting the data log:
|
0-65535 |
512 |
DATALOG_DIR |
Data log file (jr3alget.dat) collection-target directory |
(Cannot be changed) |
log |
(5) CONNECT section
The CONNECT section specifies information needed to establish RFC connection with the SAP system.
Label |
Description |
Permitted values |
Default value |
---|---|---|---|
LANG |
User language used for connection |
Japanese and English are supported. 2-byte ISO ID or 1-byte language key that is used in the SAP system:
|
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 code 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 6‒6: Combination of language and code page specifications Connection-target SAP system
Connection language
Language (LANG)
Code page (CODEPAGE)
Unicode version
Japanese
JA
8000
English
EN
No need to specify. If you specify a code page, specify 1100.
Non-Unicode version
Japanese
JA
No need to specify. If you specify a code page, specify 8000.
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.