Environment parameters file for jr3alget command (jr3alget.ini)
If you specify an environment parameters file as an argument in the jr3alget command, the command extracts the CCMS alert information of the SAP system based on the settings in the file.
You create this environment parameters file as a text file.
- Organization of this page
Setup procedure
To set up the environment parameters file:
-
Before you edit the environment parameters file, check that the jr3alget command is not running.
-
To create a new environment parameters file, copy the sample environment parameters file under the name jr3alget.ini.
This jr3alget.ini becomes the default environment parameters file. The sample file of environment parameters file is as follows:
■Integrated agent host
- In Windows:
-
- For a physical host:
Folder-to-extract-the-archive-file#-for-SAP-system-monitoring-for-Windows\sap_windows\command\agtm\evtrap\jr3alget.ini.sample
#: Agent-path\options\sap_windows_VVRRSS.zip
- In Linux:
-
- For a physical host:
Directory-to-extract-the-archive-file#-for-SAP-system-monitoring-for-Linux/sap_linux/command/agtm/evtrap/jr3alget.ini.sample
#: /opt/jp1ima/options/sap_linux_VVRRSS.tar.gz
-
Open the jr3alget.ini file.
-
Edit the settings.
The settings in the default environment parameters file are as follows; for details about the settings, see Settings:
zum06005.tif
In the case of an item that begins with a semicolon (;), the setting is disabled by default, because the semicolon indicates that it is a comment line. To enable the setting, remove the semicolon.
-
Save the environment parameters file.
By specifying the -cnf option in the jr3alget command, you can extract the CCMS alert information of the SAP system based on the settings in the environment parameters file.
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. In a table, the Argument column indicates the argument that is specified in the jr3alget command, if applicable. N/A means that the item cannot be specified with the command.
CONNECT section
The CONNECT section specifies information needed to establish RFC connection with the SAP system at the time of command execution.
Label |
Description |
Permitted values |
Default value |
Argument |
---|---|---|---|---|
ASHOST |
Host name of the connection-target application server (which can be verified by transaction code SM51) |
1 to 100 single-byte alphanumeric characters in one of the following formats:
|
localhost |
-h |
SYSNR |
System number that can be identified by the connection-target application server host |
0-99 |
00 |
-s |
CLIENT |
User's client name used for establishing connection |
0-999 |
000 |
-c |
USER |
User name used for establishing connection#1 |
1 to 12 single-byte alphanumeric characters |
CPIC |
-u |
PASSWD |
User's password used for establishing connection#2 |
1 to 8 single-byte characters#3 |
ADMIN |
-p |
PASSWD2 |
User's extended password used for establishing connection#2 |
1 to 40 single-byte characters#3 |
ADMIN |
-p2 |
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 |
-l |
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#4 |
None |
-codepage |
- #1
-
The user specified in this label must have already been granted the following authorizations:
Table 2‒109: Authorizations required by the user to establish RFC connection with function modules (S_RFC) Authorization
Description
Value
RFC_TYPE
Type of RFC object to be protected
FUGR (function group)
RFC_NAME
RFC name to be protected
*
ACTVT
Activity
16 (execution)
Table 2‒110: Authorizations required for use of external management interfaces (S_XMI_PROD) Authorization
Description
Value
EXTCOMPANY
Company name of the external management tool
HITACHI
EXTPRODUCT
Program name of the external management tool
JP1
INTERFACE
Interface ID
XAL
You can use the following user types for the user specified in this label:
-
Dialog
-
System
-
Communication
-
Service
-
- #2
-
Specify the PASSWD label if the SAP system is applying conventional password rules. Specify the PASSWD2 label if the SAP system is applying extended password rules. The PASSWD and PASSWD2 labels are mutually exclusive.
- #3
-
A user's password or extended password that is used for establishing connection must consist of single-byte numeric characters (from 0 to 9), single-byte alphabetic characters (from a to z, A to Z), and the following single-byte symbols:
!, @, $, %, &, /, (, ), =, ?, ', `, *, +, ~, #, -, _, ., :, {, [, ], }, <, >, |
- #4
-
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 2‒111: 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.
COMMAND section
The COMMAND section specifies information about the work directory for the jr3alget command.
Label |
Description |
Permitted values |
Default value |
Argument |
---|---|---|---|---|
WORKDIR |
Work directory for the command |
1 to 255 single-byte alphanumeric characters. If a relative path is specified, it is treated as the path relative to the current directory. |
Current directory |
N/A |
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 |
Argument |
---|---|---|---|---|
MSGLOG_LEVEL |
Message log collection level for saving application trace information:
|
0-4 |
2 |
N/A |
MSGLOG_SIZE |
File size for collecting the message log:
|
0-65535 |
512 |
N/A |
MSGLOG_DIR |
Message log file (jr3alget.log) collection-target directory |
1 to 255 single-byte alphanumeric characters. The total length, including file name jr3alget.log, must not exceed 255 bytes. If a relative path is specified, it is treated as the path relative to the work directory for the command. |
Work directory for the command (or the current directory if it has not been changed by the WORKDIR label in the COMMAND section) |
N/A |
DATALOG_LEVEL |
Data log collection level for saving various types of data information for applications:
|
0-4 |
2 |
N/A |
DATALOG_SIZE |
File size for collecting data log:
|
0-65535 |
512 |
N/A |
DATALOG_DIR |
Data log file (jr3alget.dat) collection-target directory |
1 to 255 single-byte alphanumeric characters. The total length, including file name jr3alget.log, must not exceed 255 bytes. If a relative path is specified, it is treated as the path relative to the work directory for the command. |
Work directory for the command (or the current directory if it has not been changed by the WORKDIR label in the COMMAND section) |
N/A |
TARGET section
The TARGET section specifies information that identifies the CCMS alert information to be extracted.
Label |
Description |
Permitted values |
Default values |
Argument |
---|---|---|---|---|
MONITOR_SET |
Monitor set name (for details, see the -ms option) |
1 to 60 single-byte alphanumeric characters |
SAP CCMS Technical Expert Monitors |
-ms |
MONITOR |
Monitor name (for details, see the -mn option) |
1 to 60 single-byte alphanumeric characters |
All Monitoring Contexts |
-mn |
FORMAT section
The FORMAT section specifies the output format of the CCMS alert information.
Label |
Description |
Permitted values |
Default values |
Argument |
---|---|---|---|---|
COLUMN |
Output format of CCMS alert information |
Field ID. For details about the field ID, see Output format and contents of jr3alget in Chapter 1 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> |
N/A |
TIMEZONE |
Time zone for time information specified in field IDs <ALERTDATE>, <ALERTTIME>, <STATCHGDAT>, and <STATCHGTIM> |
|
UTC |
TIMEZONE |
EXTRACTFILE section
The EXTRACTFILE section specifies information about the output file for the CCMS alert information.
Label |
Description |
Permitted values |
Default value |
---|---|---|---|
TYPE |
Format of file for storing CCMS Alert Information:
If you configure a new environment for JP1/IM - Agent, 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 |
WRAP1 |
SIZE |
Size of one storage file:
|
0 to 65535 |
10240 |
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 |
Option section
The Option section specifies information that determines the base point for extracting CCMS alert information. If you do not set a label in this section, the default value is used.
For details about the recommended collection base time for remote monitoring, see Notes on the collection base time.
Label |
Description |
Permitted value |
Default value |
---|---|---|---|
SHIFTEXTRACTTIME# |
The collection base time (units: seconds) that determines the base point for extracting CCMS alert information. Relative to the time at which to perform the collection, specify a value that indicates the amount of time by which to shift the time period (defined by two time points) for which to extract CCMS alert information. |
0-600 |
5 |
- #
-
If, due to the processing delay in the SAP system, the saved CCMS alert information does not correctly reflect the actual time at which it has arisen, set a value greater than the default value for this label.
The following example shows how to set the collection base time:
-
When 10 seconds is to be set as the collection base time
[Option] SHIFTEXTRACTTIME=10
Notes on the collection base time
Observe the following precautions when setting the collection base time:
-
Add the Option section and the SHIFTEXTRACTTIME label when you create or update the environment parameters file.
-
Make adjustments to the collection base time recommended for remote monitoring by taking into account the following concept behind the recommended collection base time:
- Concept behind the collection base time
-
Due to processing delay in the SAP system, the saved system log or CCMS alert information may not accurately reflect the actual time at which it arose. In this case, even when the local host is being monitored, some of the system log or CCMS alert information is not extracted, which is the same as what happens when a time delay in the SAP system (time difference between hosts) exceeds the collection base time. To avoid this problem, the default collection base time is set at 5 seconds. When a remote host is to be monitored, the effect of time delay in the SAP system must also be taken into consideration, and therefore 5 more seconds (which gives sufficient margin to accommodate an environment that meets the prerequisite of keeping a time difference between hosts to less than 1 second) is added to the collection base time, with 10 seconds being set as the recommended collection base time.