lsresponse コマンド

目的

1 つ以上の応答に関する情報をリストします。

構文

lsresponse [-a] [ -C | -l | -t | -d | -D delimiter ] [-A] [-q] [-U] [-x ] [ -b ] [-h] [-TV] [response1[,response2,...] :ノード名]

説明

すべての応答名のリストを取得するには、応答名を指定せずに lsresponse コマンドを単独で実行します。 すべての応答名のリストが返されます。 この場合のデフォルトの形式は表形式です。

応答名の後にノード名を指定すると、そのノードに定義されている応答だけが表示されます。 コロン (:) の後にノード名を指定して、ノード上のすべての応答をリストします。 このノード名は、CT_MANAGEMENT_SCOPE 環境変数によって決められている管理有効範囲内のノードです。 管理有効範囲は、応答をリストするノードのリストを決定します。 Local 有効範囲の場合には、ローカル・ノードの応答のみがリストされます。 それ以外の場合には、ドメイン内のすべてのノードの応答がリストされます。

すべての応答名に関するすべての情報を表示するには、 lsresponse コマンドで -A フラグを指定します。 -A フラグを使用すると、応答名が指定されていない場合に、応答に関するすべての情報がリストされます。 すべての応答に関するすべての情報が表示される場合には、長形式がデフォルト・フォーマットです。

複数の応答を指定した場合、応答情報はその応答が入力された順序でリストされます。

システムにクラスター・システム・マネージメント (CSM) がインストールされている場合は、CSM 定義のノード・グループをノード名の値として使用して、複数のノードを参照できます。 CSM ノード・グループの処理と CSM nodegrp コマンドの使用については、「CSM: Administration Guide」および「CSM: Command and Technical Reference」を参照してください。

フラグ

-a

このコマンドをクラスター内のすべてのノードに適用することを指定します。 クラスター有効範囲は、 CT_MANAGEMENT_SCOPE 環境変数によって決定されます。 この環境変数が設定されていない場合、 コマンドにとって有効な有効範囲になるまで、 最初に管理ドメイン有効範囲 (存在する場合) を選択し、 次にピア・ドメイン有効範囲 (存在する場合) を選択し、 次にローカル有効範囲を選択します。 コマンドは、最初に見つかった有効な有効範囲に対して、1 回実行されます。 例えば、管理ドメインとピア・ドメインの両方が存在する場合、CT_MANAGEMENT_SCOPE が設定されていない lsresponse -a は管理ドメインをリストします。 この場合、ピア・ドメインをリストするには、CT_MANAGEMENT_SCOPE を 2 に設定します。

-A

応答のすべての属性を表示します。

-b

イベント・バッチ処理をサポートする応答のみを表示します。

-C

応答とそのアクションの 1 つを作成するために使用できる mkresponse コマンドを表示します。 複数の応答を指定した場合、それぞれの mkresponse コマンドが別々の行に表示されます。 このフラグは、応答が指定されていない場合には無視されます。 このフラグを設定すると、-l フラグが無効になります。

-d

区切り文字により書式設定された出力を指定します。 デフォルトの区切り文字はコロン (:) です。 デフォルトの区切り文字を変更する場合は、 –D フラグを使用します。

--D デリミタ

指定した区切り文字により書式設定された出力を指定します。 このフラグを使用して、デフォルトのコロン (:) 以外を指定します。 例えば、表示されるデータにコロンが含まれている場合、このフラグを使用して、1 つ以上の文字の別の区切り文字を指定します。

-l

応答情報を別々の行に表示します (長形式)。

-q

response が存在しない場合にエラーを返しません。

-t

応答情報を別々の列に表示します (テーブル形式)。

-U

リソースがロックされるかどうかを指定します。

-x

ヘッダー印刷を抑制します。

-h

コマンドの使用ステートメント (使用法) を標準出力に書き込みます。

-T

コマンドのトレース・メッセージを標準エラーに書き込みます。 これは、ソフトウェア保守部門専用の機能です。

-V

コマンドの詳細メッセージを標準出力に書き込みます。

パラメーター

response1[,response2,...]

このパラメーターには、応答名または応答名を示すサブストリングを指定できます。 複数の応答名を指定できます。 サブストリングである場合には、そのサブストリングが含まれている 定義済みの応答名がリストされます。

ノード名

応答が定義されているノードを指定します。 node_name を指定しないと、ローカル・ノードが使用されます。 node_name は、CT_MANAGEMENT_SCOPE 環境変数が決定する範囲内のノードです。

セキュリティー

ユーザーが lsresponseを実行するには、 IBM.EventResponse リソース・クラスの読み取り権限が必要です。 権限は、相手のシステムのアクセス制御リスト (ACL) ファイルに指定します。 ACL ファイルおよびその変更方法について詳しくは、「Administering RSCT」ガイドを参照してください。

終了状況

0

コマンドは正常に実行されました。

1

RMC 内でエラーが発生しました。

2

コマンド・ライン・インターフェース・スクリプトでエラーが発生しました。

3

コマンド・ラインに指定されたフラグが正しくありません。

4

コマンド・ラインに指定されたパラメーターが正しくありません。

5

コマンド・ライン入力の間違いが原因のエラーが発生しました。

環境変数

CT_CONTACT

Resource Monitoring and Control (RMC) デーモンとのセッションが発生するシステムを決定します。 CT_CONTACT をホスト名または IP アドレスに設定すると、コマンドは指定されたホストの RMC デーモンにアクセスします。 CT_CONTACT を設定しないと、コマンドは、そのコマンドが実行されているローカル・システムの RMC デーモンにアクセスします。 RMC デーモン・セッションのターゲットおよび管理有効範囲によって、処理されるリソース・クラスまたはリソースが決定されます。

CT_IP_AUTHENT

CT_IP_AUTHENT 環境変数が存在する場合、RMC デーモンは、IP ベース・ネットワーク認証を使用して、CT_CONTACT 環境変数が設定されている IP アドレスで指定されたシステム上の RMC デーモンにアクセスします。 CT_IP_AUTHENT は、CT_CONTACT が IP アドレスに設定されている場合にのみ意味を持ちます。ドメイン・ネーム・システム (DNS) サービスには依存しません。

CT_MANAGEMENT_SCOPE

イベント応答リソース・マネージャー (ERRM) のリソースの処理で、RMC デーモンとのセッションに使用する管理有効範囲を指定します。 管理有効範囲は、リソースを処理できる、可能なターゲット・ノードのセットを決定します。 有効な値は以下のとおりです。

0

local 有効範囲を指定します。

1

local 有効範囲を指定します。

2

peer domain (ピア・ドメイン) 有効範囲を指定します。

3

management domain (管理ドメイン) 有効範囲を指定します。

この環境変数が設定されていない 場合は、local 有効範囲が使用されます。

実行の特性

このコマンドはAIX®用のReliable Scalable Cluster Technology(RSCT)ファイルセットの一部です。

標準出力

-h フラグを指定すると、このコマンドの使用状況ステートメントが標準出力に書き込まれます。 詳細メッセージはすべて、標準出力に書き込まれます。

標準エラー

トレース・メッセージはすべて、標準エラーに書き込まれます。

例

1. すべての応答をリストするには、次のコマンドを実行します。

   lsresponse 

   出力は次のようになります。

   ResponseName
   "E-mail root anytime"
   "E-mail root first shift"
   "Critical notifications"  
   "Generate SNMP trap" 
   

2. どのリソースがロックされているのかを確認するには、次のコマンドを実行します。

   lsresponse -U

   出力は次のようになります。

   ResponseName                   Node      Locked 
   "Broadcast event on-shift"     "nodeA"   "No"   
   "E-mail root off-shift"        "nodeA"   "No"  
   "E-mail root anytime"          "nodeA"   "No"  
   "Log event anytime"            "nodeA"   "No"
   "Informational notifications"  "nodeA"   "No"
   "Warning notifications"        "nodeA"   "No"  
   "Critical notifications"       "nodeA"   "No"
   "Generate SNMP trap"           "nodeA"   "No"

3. 応答「Critical notifications」に関する一般情報をリストするには、次のコマンドを実行します。

   lsresponse "Critical notifications"

   出力は次のようになります。

   ResponseName     = "Critical notifications"
   Node             = "nodeA"
   Action           = "Log Critical Event"
   DaysOfWeek       = 1+2+7
   TimeOfDay        = 0000-2400
   ActionScript     = "/opt/rsct/bin/logevent /tmp/criticalEvents"                                       
   ReturnCode       = 0
   CheckReturnCode  = "y"
   EventType        = "b"
   StandardOut      = "y"
   EnvironmentVars  = '"Env1=5","Env=10"'
   UndefRes         = "n"
   
   ResponseName     = "Critical notifications"
   Node             = "nodeA"
   Action           = "E-mail root"
   DaysOfWeek       = 6+2,6+2,6+5
   TimeOfDay        = 1700-2400,0000-0800,0000-2400
   ActionScript     = "/opt/rsct/bin/notifyevent root"
   ReturnCode       = 0
   CheckReturnCode  = "y"
   EventType        = "b"
   StandardOut      = "y"
   EnvironmentVars  = ""
   UndefRes         = "n"
   
   

4. 応答「Critical notifications」を作成するコマンドを、そのアクションの 1 つと共に表示するには、次のコマンドを実行します。

   lsresponse -C "Critical notifications"

   出力は次のようになります。

   mkresponse -n "Log Critical Event" -d 1+2+7 -t 0000-2400 \
   -s "usr/sbin/rsct/bin/logevent /tmp/criticalEvents"  \
   -e b -r 0 "Critical notifications"

5. 名前にストリング E-mail が含まれているすべての応答をリストするには、次のコマンドを実行します。

   lsresponse "E-mail"

   出力は次のようになります。

   ResponseName = "E-mail root anytime"
   Action       = "E-mail root"
   ⋮
   ResponseName = "E-mail root first shift"
   Action       = "E-mail root"

場所

/opt/rsct/bin/lsresponse