自動応答メソッド: OS コマンドの実行 

用途

監視アーキテクチャ警告への自動応答として、任意の OS コマンドを実行することができます。自動応答メソッドCCMS_AUTO_REACT_OP_COMMAND を、この目的に使用することができます。ただし、セキュリティ上の理由から、このことは以前に外部 OS コマンド (トランザクション SM69) で定義されたコマンドにのみ適用されます。

自動応答メソッドを使用するには、SAP サービスマーケットプレイスから最新の SAPXPG を使用します (http://service.sap.com/swdc → Download → Support Packages and Patches → Entry by Application Group → SAP NetWeaver → SAP NETWEAVER → SAP NETWEAVER 04 → Entry by Component → AS ABAP → SAP KERNEL 6.40 32/64-BIT → <Platform> → Database independent)。

この自動応答メソッドの主要な機能は、警告の詳細をパラメータとして OS コマンドに転送できることです。このために、メソッドパラメータを使用します。メソッドパラメータには、実行時に関連する警告データによって置き換えられる引数を含めることができます。

自動応答メソッドには、以下のメソッドパラメータがあります。

メソッドパラメータ	意味
COMMAND	警告の場合に実行される論理コマンド。
PARAMETERS	論理コマンドの転送先の静的パラメータ。
REACT_ON_ALERTS	自動応答メソッドが開始される警告の色。 YELLOW:               黄色の警告の場合にのみメソッドが開始されます。 RED:                  赤色の警告の場合にのみメソッドが開始されます。 <上記以外>:           すべての警告でメソッドが開始されます。
MTENAME	SID/SEGMENT/CONTEXT/OBJECT/ATTRIBUTE。警告が発生した場合、関連する値が引数に設定されます (下記参照)。
PARAMLIST_1	OS コマンドに転送される追加パラメータ。これらには、通常のテキスト以外に引数を含めることができます (下記参照)。
PARAMLIST_2
PARAMLIST_3
PARAMLIST_4

COMMAND パラメータは必須です。その他のパラメータはすべてオプションです。

メソッドパラメータ MTENAME および PARAMLIST_<n> の以下の引数は、実行時に関連する値によって置き換えられます。

引数	意味
SID	警告が発生したシステムのシステム ID
CONTEXT	MTE の監視コンテキスト
OBJECT	MTE の監視オブジェクト
ATTRIBUTE	MTE の監視属性
SEGMENT	MTE の監視セグメント
COLOR	警告の色 (YELLOW または RED)
SEVERITY	警告の重大度
DATE TIME	警告の日付および時刻 (システム日付およびシステム時刻)
CLIENT	警告が生成されたユーザのクライアント
USER	警告が生成されたユーザ (この情報は常に利用可能とは限りません)
REPORTER	警告の登録を担当する機能または C ソース
CLASS	メッセージクラス (SAP-SYSLOG や SAP-T100 など)
ID	メッセージのクラスおよび番号 (A04 など)
ARG1 ARG2 ARG3 ARG4	メッセージの引数
TXT	引数のないメッセージのテキスト (システム言語)
MSG	引数のある拡張メッセージ (システム言語)
MSCGL	グローバル外部行 ID

OS コマンドに転送されるパラメータは、空白で区切る必要があります。パラメータの以下の部分は空白を含む場合があるため、UNIX の場合は一重引用符 (')、Microsoft Windows の場合は二重引用符 (") で囲みます。

●      MTENAME で指定されたすべての引数

●      引数 MSG

●      引数 TXT

この方法で、MTE 名および引数 MSG と TXT のすべての部分は、それぞれ 1 つのパラメータとして識別されます。

メソッドパラメータのその他すべての引数は、独立したパラメータとして認識する必要がある場合は空白で区切ります。MTENAME および PARAMLIST_<n> の引数の間には、空白が自動的に挿入されます (以下の例も参照)。2 つの引数を 1 つのパラメータとして識別する必要がある場合は、引数の間に空白を入れないでください。

また、引数は MTENAME およびすべての PARAMLIST_* パラメータ内に一度だけ指定することができます。

前提条件

必要な OS コマンドを、外部 OS コマンドトランザクションで定義しておく必要があります。このことを行うには、以下の手順に従ってください。

...

       1.      CCMS → 設定 → 外部コマンドを選択するか、またはトランザクション SM69 を呼び出します。

       2.      照会 ← → 変更 () ボタンを使用して変更モードを選択し、登録 () を選択します。

       3.      必要な OS コマンドの詳細を入力します。追加パラメータ使用可能区分が有効であることを確認し、エントリを保存します。

■      自動応答メソッドの定義中に、OS コマンドの名称を入力する必要はなくなりましたが、(論理) コマンドの名称を入力する必要があります。

■      監視システムのアプリケーションサーバのオペレーティングシステムを使用する場合、各オペレーティングシステムに対して同じ名称だが異なるオペレーティングシステムで論理コマンドを登録します。このことを行う場合、異なるスクリプトまたは実行可能ファイルを指定することができます。

■      スクリプトまたは実行可能ファイルが、すべてのホストからユーザ <SID>adm によって呼び出すことができることを確認します。このテストは、トランザクション SM49 を使用して実行することができます。

トランザクション SM69 の入力項目 OS コマンドのパラメータで定義したオプションの静的パラメータが、最初に OS コマンドに転送されます。その他のどのパラメータが追加でコマンドに転送されるかは、対応する自動応答メソッドの設定によって異なります。

コマンドの定義の追加情報については、外部 OS コマンド: 内容を参照してください。

手順

メソッドのコピー

オリジナルのメソッド CCMS_AUTO_REACT_OP_COMMAND は変更せず、独自のメソッドのテンプレートとしてのみ使用することをお奨めします。この方法によって、必要な数の論理コマンドを自動応答として設定することができます。

...

       1.      CCMS → 設定 → 警告モニタを選択するか、またはトランザクション RZ21 を呼び出します。

       2.      メソッドグループボックスで、メソッド定義を選択し、概要照会を選択します。

       3.      メソッドCCMS_AUTO_REACT_OP_COMMAND を選択し、コピー () を選択します。

       4.      必要な名称を入力し、エントリを保存します。

メソッドパラメータの調整およびメソッドのリリース

...

       1.      登録したメソッドのコピーを選択し、データ編集 () を選択します。

       2.      監視: メソッド画面が表示されます。照会 ← → 変更 () ボタンを使用して、変更モードを選択します。

       3.      パラメータタブページを選択し、実行する論理コマンドおよびその他のメソッドパラメータを設定します (上記参照)。

       4.      リリースタブページを選択し、メソッド実行グループボックスで自動応答メソッドを選択します。

       5.      エントリを保存します。

デフォルトで、OS コマンドは警告を生成した MTE のローカルサーバで実行されます。コマンドを別のサーバで実行する必要がある場合は、メソッド実行場所グループボックスの実行タブページで実行場所を変更します。

必要なノードへのメソッドの割当

必要な MTE または MTE クラスにメソッドを割り当てる必要があります。このことを行うために、トランザクション RZ20 (有効なプロパティバリアントの場合のみ) またはトランザクション RZ21 を使用することができます (プロパティおよびメソッド割当の変更も参照)。トランザクション RZ20 を使用した割当について、以下に説明します。

...

       1.      トランザクション RZ20 を使用して警告モニタを起動するか、または CCMS → 管理/監視 → 警告モニタを選択します。

       2.      必要なモニタを一覧でダブルクリックして起動します。

       3.      必要なノードを選択し、プロパティを選択します。

       4.      監視: プロパティおよびメソッド画面が表示されます。メソッドタブページを選択し、メソッド割当ボタンを選択します。

       5.      監視: メソッド画面が表示されます。この後の手順は、分析メソッドをこのノードにのみ割り当てるか、MTE クラス全体に割り当てるかによって異なります。

分析メソッドの選択した MTE クラスへの割当

...

       1.      画面のヘッダデータで MTE クラスの名称をダブルクリックして選択し、照会 ← → 変更 () ボタンで変更モードを選択します。

       2.      自動応答メソッドグループボックスで、メソッド名を選択し、関連する項目に上記で登録したメソッドを入力します。

       3.      エントリを保存します。

分析メソッドのこの MTE のみへの割当

...

       1.      照会 ← → 変更 () ボタンで変更モードを選択し、自動応答タブページを選択します。

       2.      メソッド割当グループボックスで、メソッド名を選択し、関連する項目に上記で登録したメソッドを入力します。

       3.      エントリを保存します。

結果

この自動応答メソッドを割り当てた MTE のいずれかに対して警告がトリガされた場合、監視アーキテクチャによって対応する論理コマンドが自動的に実行されます。

例

警告をログに記録する必要があります。このことを行うには、名称が alert_<日付>_<時刻>.txt のファイルを登録する必要があります。このファイルには、以下のような警告に関する情報が含まれます。

yellow alert from 'PDR/SAP_CCMS_pdrhost_PRD_00/prdhost_PRD_00/R3Syslog
/BasisSystem' A04 'Load format of SAPLQDIS abload1 0413 invalid.'

...

       1.      メソッドCCMS_AUTO_REACT_OP_COMMAND を、独自のメソッドのテンプレートとして使用します。パラメータ MTENAME および PARAMLIST_1 は、デフォルトですでに設定されています。コマンド Z_TEST および PARAMLIST_2 にパラメータ ID を追加します。

パラメータ	パラメータ値
COMMAND	Z_TEST
PARAMETERS
REACT_ON_ALERTS
MTENAME	SID/SEGMENT/CONTEXT/OBJECT/ATTRIBUTE
PARAMLIST_1	COLOR DATE_TIME MSG
PARAMLIST_2	ID
PARAMLIST_3
PARAMLIST_4

       2.      トランザクション SM69 で、Linux オペレーティングシステムに論理コマンド Z_TEST を定義します。その中で Linux スクリプト test.sh を指定します (ユーザ <SID>adm がこのスクリプトを実行できる必要があります)。

       3.      トランザクション SM69 で、Windows NT オペレーティングシステムに論理コマンド Z_TEST を定義します。その中で Microsoft Windows スクリプト test.cmd を指定します。

両方の論理コマンドに対して追加パラメータを許可します。

調整した設定で、警告が発生した場合に以下のコマンドが実行されます。

○     Linux:

test.sh '<SID>/<SEGMENT>/<CONTEXT>/<OBJECT>/<ATTRIBUTE>' <COLOR> <DATE>_<TIME> '<MSG>' <ID>

○     Microsoft Windows:

test.cmd '<SID>/<SEGMENT>/<CONTEXT>/<OBJECT>/<ATTRIBUTE>' <COLOR>

<DATE>_<TIME> '<MSG>' <ID>

       4.      名称が alert_<日付>_<時刻>.txt のファイルを生成するスクリプトを登録します。

○     Linux スクリプト test.sh:

#!/usr/bin/sh
echo $2 alert from $1 Message $5 $4 > alert_$3.txt

○     Microsoft Windows スクリプト test.cmd:

echo %2 alert from %1 Message %5 %4 > alert_%3.txt

絶対パス指定を使用しない場合、ファイルは DIR_HOME ディレクトリに格納されます。