5.4.3 コマンドを実行してシステムログ情報を抽出する場合の環境パラメーター設定ファイル

jr3slgetコマンド実行時に,引数として環境パラメーター設定ファイルを指定すると,ファイルの設定内容を基に,SAPシステムのシステムログ情報が抽出されます。

このファイルは,テキストファイルとしてユーザーが作成します。

<この項の構成>
(1) 設定手順
(2) 設定内容

(1) 設定手順

環境パラメーター設定ファイルの設定手順を次に示します。

  1. 環境パラメーター設定ファイルのサンプルファイルを「jr3slget.ini」の名前でコピーする。
    この「jr3slget.ini」が,デフォルトの環境パラメーター設定ファイルとなります。環境パラメーター設定ファイルのサンプルファイルを次に示します。
    Windowsの場合
    インストール先フォルダ¥agtm¥evtrap¥jr3slget.ini.sample
    UNIXの場合
    /opt/jp1pc/agtm/evtrap/jr3slget.ini.sample
  2. jr3slget.iniを開く。
  3. 設定内容を編集する。
    デフォルトの環境パラメーター設定ファイルの設定内容を次に示します。設定内容については,「(2) 設定内容」を参照してください。

    [図データ]

    コメント行を表す「;」が行頭にある項目は,デフォルトでは設定が有効になっていません。設定を有効にするには,コメント行を表す「;」を外してください。
  4. 環境パラメーター設定ファイルを保存する。
    jr3slgetコマンド実行時に-cnfオプションを指定することで,環境パラメーター設定ファイルの内容を基にSAPシステムのシステムログ情報が抽出されます。

(2) 設定内容

環境パラメーター設定ファイルは,次の形式で記述します。

[セクション]
ラベル=
ラベル=


[セクション]
ラベル=
ラベル=

注意
  • 行頭および「=」の前後に,空白文字などの余計な文字を設定しないでください。
  • セクションおよびラベルでは,指定した値の大文字・小文字は区別されません。
  • 行の先頭に「;」を指定すると,その行はコメントとして扱われます。

次に,環境パラメーター設定ファイルの各セクションで設定する内容を表形式で説明します。表の「引数」列は,jr3slgetコマンドでも指定できる設定値の場合,コマンドで指定する際の引数を示します。「-」は,コマンドでは指定できない項目を示します。

(a) CONNECTセクション

CONNECTセクションでは,コマンド実行時に,SAPシステムとのRFC接続を確立するための情報を指定します。

表5-6 CONNECTセクションに指定できる値

ラベル意味指定できる値デフォルト値引数
ASHOST接続先のアプリケーションサーバのホスト名(トランザクションコードSM51で確認できるホスト名)。1~100バイトの半角英数字。次の形式で指定できる。
  • hostsファイルに指定されたホスト名
  • IPアドレス
  • SAPルーターアドレス
localhost-h
SYSNR接続先のアプリケーションサーバホストで識別するためのシステム番号。0~9900-s
CLIENT接続に利用するユーザーのクライアント名。0~999000-c
USER接続に利用するユーザー名。※11~12バイトの半角英数字。CPIC-u
PASSWD接続に利用するユーザーのパスワード。※31~8バイトの半角文字列。※4ADMIN-p
PASSWD2接続に利用するユーザーの拡張パスワード。※31~40バイトの半角文字列。※4ADMIN-p2
LANG接続に利用するユーザーの言語。SAPシステムで使用されている,2バイトのISO IDまたは1バイトの言語キー。
  • 日本語の場合:JA
  • 英語の場合:EN
なし-l
CODEPAGE接続先のUnicode版SAPシステムで文字コードを変換する時に使用するコードページ。LANGラベルの言語と組み合わせて指定する。※2なし-codepage
注※1
このラベルで指定するユーザーには,次の権限を付与しておく必要があります。

表5-7 ユーザーが汎用モジュールにRFC接続するための権限(S_RFC)

権限項目説明
RFC_TYPE保護されるRFCオブジェクトのタイプFUGR(汎用グループ)
RFC_NAME保護されるRFC名*
ACTVTアクティビティ16(実行)

表5-8 外部管理インターフェースを使用するための権限(S_XMI_PROD)

権限項目説明
EXTCOMPANY外部管理ツールの会社名HITACHI
EXTPRODUCT外部管理ツールのプログラム名JP1
INTERFACEインターフェースIDXAL
また,このラベルで指定するユーザーには,次のタイプのユーザーが使用できます。
  • ダイアログ(Dialog)
  • システム(System)
  • 通信(Communication)
  • サービス(Service)
注※2
LANGラベルとCODEPAGEラベルは,次の組み合わせで設定してください。次の組み合わせ以外の言語とコードページを指定した場合,SAPシステムから取得した情報が文字化けする可能性があります。

表5-9 言語とコードページの指定内容の組み合わせ

接続先SAPシステム接続言語言語(LANG)コードページ(CODEPAGE)
Unicode版日本語JA8000
英語EN指定する必要はありません。指定する場合は,1100を指定してください。
非Unicode版日本語JA指定する必要はありません。指定する場合は,8000を指定してください。
英語EN指定する必要はありません。指定する場合は,1100を指定してください。
LANGラベルの指定を省略した場合,接続先システムで定義されているユーザーの言語が仮定されます。
CODEPAGEラベルの指定を省略した場合,接続先システムのデフォルトコードページが仮定されます。
注※3
PASSWDラベルとPASSWD2ラベルは同時に指定できません。
注※4
接続に利用するユーザーのパスワード,および拡張パスワードは,半角数字(0~9),半角英字(a~z, A~Z),および次の半角記号で定義してください。
 
 !"@△$%&/()=?'`*+~#-_.,;:{[]}¥<>|
 △は,空白文字を示します。

(b) COMMANDセクション

COMMANDセクションでは,jr3slgetコマンドの作業ディレクトリの情報を指定します。

表5-10 COMMANDセクションに指定できる値

ラベル意味指定できる値デフォルト値引数
WORKDIRコマンドの作業ディレクトリ。1~255バイトの半角英数字。相対パスを指定した場合,カレントディレクトリからの相対パスとなる。カレントディレクトリ

(c) TRACEセクション

TRACEセクションでは,jr3slgetコマンドの実行履歴が保存されるメッセージログおよびデータログの情報を指定します。

表5-11 TRACEセクションに指定できる値

ラベル意味指定できる値デフォルト値引数
MSGLOG_LEVELアプリケーションのトレース情報を保存するメッセージログの取得レベル。
  • 0:採取しない
  • 1:エラーだけ採取
  • 2:標準
  • 3:詳細
  • 4:デバッグ
0~42
MSGLOG_SIZEメッセージログを取得するファイル容量。
  • 0:システムの最大値
  • 1~65535:指定サイズ(単位:キロバイト)内でラップアラウンド
0~65535512
MSGLOG_DIRメッセージログファイル(jr3slget.log)の取得先ディレクトリ。1~255バイトの半角英数字。ファイル名部分のjr3slget.logまでを含めて255バイト以内で指定する必要がある。相対パスを指定した場合,コマンドの作業ディレクトリからの相対パスとなる。コマンドの作業ディレクトリ(COMMANDセクションのWORKDIRラベルで変更していないときは,カレントディレクトリ)
DATALOG_LEVELアプリケーションの各種データ情報を保存するデータログの取得レベル。
  • 0:採取しない
  • 1:エラーだけ採取
  • 2:標準
  • 3:詳細
  • 4:デバッグ
0~42
DATALOG_SIZEデータログを取得するファイル容量。
  • 0:システムの最大値
  • 1~65535:指定サイズ(単位:キロバイト)内でラップアラウンド
0~65535512
DATALOG_DIRデータログファイル(jr3slget.dat)の取得先ディレクトリ。1~255バイトの半角英数字。ファイル名部分のjr3slget.datまでを含めて255バイト以内で指定する必要がある。相対パスを指定した場合,コマンドの作業ディレクトリからの相対パスとなる。コマンドの作業ディレクトリ(COMMANDセクションのWORKDIRラベルで変更していないときは,カレントディレクトリ)
注※
32ビットの符号付き整数で示せる0x7FFFFFFF(約2ギガバイト)です。

(d) TARGETセクション

TARGETセクションでは,抽出対象のシステムログ情報を特定するための情報を指定します。

表5-12 TARGETセクションに指定できる値

ラベル意味指定できる値デフォルト値引数
SERVERSAPインスタンス名(トランザクションコードSM51で確認できる,ダイアログサービスを持つSAPインスタンス名)。1~20バイトの半角英数字。(なし)-server

(e) FORMATセクション

FORMATセクションでは,出力されるシステムログ情報の出力形式を指定します。

表5-13 FORMATセクションに指定できる値

ラベル意味指定できる値デフォルト値引数
COLUMN出力されるシステムログ情報の出力形式。フィールドID。フィールドIDについては,「10. コマンド」を参照のこと。列1:<TIME>
列2:<INSTANCE>
列3:<USER>
列4:<PROGRAM>
列5:<MSGNO>
列6:<MSGTEXT>

(f) EXTRACTFILEセクション

EXTRACTFILEセクションでは,システムログ情報の出力ファイルの情報を指定します。

表5-14 EXTRACTFILEセクションに指定できる値

ラベル意味指定できる値デフォルト値引数
SIZE出力ファイル容量。
  • 0:システムの最大値※1
  • 1~65535:指定サイズ(単位:キロバイト)内でラップアラウンド
0~655351024
X2PATHjr3slgetコマンドの-x2オプションで,ログファイル出力を指定したときに適用されるログファイルのパス。※21~255バイトの半角英数字。相対パスを指定した場合,コマンドの作業ディレクトリからの相対パスとなる(COMMANDセクションのWORKDIRラベルで変更していないときは,カレントディレクトリ)。SYSLOG
注※1
32ビットの符号付き整数で示せる0x7FFFFFFF(約2ギガバイト)です。
注※2
指定の出力ファイルと同じディレクトリに,出力ファイル名.ofsという名称で管理ファイルが作成されます。(例:出力ファイル名としてSYSLOGを指定したときSYSLOGファイルとは別にSYSLOG.ofsファイルが管理ファイルとして作成されます)出力ファイルを削除する場合は,この管理ファイルも合わせて削除してください。