fteListMonitors(リソースモニターのリスト 'MFT)
コマンド行を使用して Managed File Transfer ネットワーク内の既存のリソース・モニターをすべてリストするには、 fteListMonitors コマンドを使用します。
目的
fteListMonitors コマンドは、既存のリソース・モニターをリストします。 エージェント名およびリソース・モニター名を指定すれば、このコマンドの出力をフィルターに掛けることができます。
このコマンドは、coordination.properties ファイルを使用して、調整キュー・マネージャーに接続します。 詳しくは、 MFT coordination.properties ファイルを参照してください。
-ox パラメーターを使用して、リソース・モニターを XML ファイルにエクスポートできます。 このXMLファイルの使用方法については、「fteCreateMonitor（MFTリソースモニタの作成）」を参照してください。
デフォルト・セットとは異なる構成オプションのセットを使用する場合にのみ、このコマンドにオプションの-pパラメーターを指定してください。 詳しくは、 構成オプションを参照してください。
リソース・モニター名
リソース・モニター名に、ファイル名として無効な文字が含まれることがあります。 IBM® MQ 9.1以降、リソース・モニター名に以下のいずれかの文字が含まれている場合、 fteListMonitors -od コマンドはその文字を同等の ASCII 文字に変換します。
- "\" (バック・スラッシュ) = %5C
- "/" (スラッシュ) =%2F
- ":" (コロン) =%3A
- "<" (より小) = %3C
- ">" (より大) = %3E
- "''" (二重引用符) = %22
- "|" (Pipe)=%7C
例えば、
SRC.TEST \(TESTING-TEST\)SRC.TEST %5C(TESTING-TEST%5C)さらに、IBM MQ 9.1以降、fteListMonitors
-ma <agent name> -mn <monitor name> コマンドの使用時に特殊文字を指定する際にエスケープ文字を使用する必要がなくなりました。
例えば、前のリリースでは次のようにコマンドを使用していました。
fteListMonitors -ma SRC -mn "TEST \(TESTING-TEST\)"fteListMonitors -ma SRC -mn "TEST (TESTING-TEST)"Syntax
パラメーター
- -p configuration_options
- オプション。 このパラメーターは、転送を取り消すために使用する構成オプションのセットを決定します。 慣例として、このパラメーターの入力には、デフォルト調整キュー・マネージャー以外の名前を使用します。 これで、コマンドは、デフォルト以外の調整キュー・マネージャーと関連付けられたプロパティー・ファイルのセットを使用します。
- -ma monitoring_agent_name
- オプション。 入力データとして提供したパターンを使用して、エージェント名でリソース・モニターをフィルタリングします。 アスタリスク (*) 文字は、ゼロ以上の文字と一致するワイルドカードとして解釈されます。 -ma パラメーターを指定しない場合、デフォルトの調整キュー・マネージャーのすべてのエージェントに関連付けられたすべてのリソース・モニターがデフォルトでリストされます。
- -mn モニター名
- オプション。 入力データとして提供したパターンを使用して、モニター名でリソース・モニターをフィルタリングします。 アスタリスク (*) 文字は、ゼロ以上の文字と一致するワイルドカードとして解釈されます。 -mn パラメーターを指定しない場合、デフォルトの調整キュー・マネージャーのすべてのエージェントに関連付けられたすべてのリソース・モニターがデフォルトでリストされます。
- -mquserid ユーザー ID
- オプション。 調整キュー・マネージャーで認証するユーザー ID を指定します。
- -mqpassword パスワード
- オプション。 調整キュー・マネージャーで認証するパスワードを指定します。 -mquseridパラメーターも指定する必要があります。 -mquseridを指定し、-mqpasswordを指定しない場合は、関連するパスワードを入力するように求められます。 パスワードは表示されません。
- -v
- オプション。 リソース・モニター状況の追加情報を含む詳細出力を生成します。ここには、リソース・モニターが開始されているか、または停止されているか、モニターされているディレクトリー・リソース・パス、およびトリガー条件などが含まれます。
- -ox xml_filename
- オプション。 このパラメーターは、-ma パラメーターおよび -mn パラメーターと組み合わせて指定する必要があります。 リソース・モニターを XML ファイルにエクスポートします。その XML ファイルを fteCreateMonitor コマンドと -ix パラメーターで使用できます。
- -od directory_name
- オプション。 複数のリソース・モニター定義を指定のディレクトリーにエクスポートします。 各リソース・モニター定義は、agent name.monitor name.xml という形式の名前で別々の XML ファイルに保存されます。 XML ファイルを保管する有効なターゲット・ディレクトリーを指定する必要があります。そうしないと、エラー・メッセージが表示されます。 このパラメーターを -ox パラメーターと組み合わせて使用することはできません。
- - ? または -h
- オプション。 コマンド構文を表示します。
例: リソース・モニターのリストを表示する
この例では、モニター・エージェント (およびリソース・モニターに関連付けられたファイル転送のソース・エージェント) AGENT1 に関連付けられたすべてのリソース・モニターがリストされます。
fteListMonitors -ma AGENT1 C:¥Users¥Administrator>fteListMonitors -ma AGENT1 5724-H72 Copyright IBM Corp. 2008年、2025年。 All Rights Reserved Agent Name: Monitor Name: Resource Type: AGENT1 MONITOR1 Directory
以下の例では、コマンドに -v パラメーターが含まれています。このパラメーターは、リソース・モニターの状況に関する追加情報を含む詳細出力を生成します。
fteListMonitors -ma AGENT1 -vこの場合、コマンドからの出力は次のようになります。
C:¥Users¥Administrator>fteListMonitors -ma AGENT1 -v
5724-H72 Copyright IBM Corp. 2008年、2025年。 All Rights Reserved
Monitor Information:
Name: MONITOR1
Agent: AGENT1
Status: Stopped
Resource Type: Directory
Resource: C:¥src
Poll interval: 2 seconds
Batch size: 1
Condition: Match
Pattern: * (wildcard)
例: 1 つのリソース・モニターを XML ファイルにエクスポートする
この例では、AGENT1 上の単一のリソース・モニター MONITOR1 が、-ox パラメーターを使用して XML ファイル名を指定することにより、XML ファイル filename1.xml にエクスポートされます。
fteListMonitors -ma AGENT1 -mn MONITOR1 -ox filename1.xml 例: 指定のディレクトリーに 1 つのリソース・モニターをエクスポートする
この例では、AGENT1 上の単一のリソース・モニター MONITOR1 が、-od パラメーターで指定されたディレクトリーにエクスポートされます。 XML ファイル名の形式の違いを除き、この例は -ox パラメーターの使用に似ています。
fteListMonitors -ma AGENT1 -mn MONITOR1 -od /usr/mft/resmonbackup 例: 指定のディレクトリーにある XML ファイルにリソース・モニターのバッチをエクスポートする
以下のすべての例で、リソース・モニターは、-od パラメーターで指定されたディレクトリーにエクスポートされます。 各リソース・モニター定義が別々の XML ファイルに保存され、それぞれのファイル名が agent name.monitor name.xml という形式になります。
この例では、すべてのリソース・モニターを指定のディレクトリーにエクスポートします。
fteListMonitors -od /usr/mft/resmonbackupこの例では、AGENT1 にあるすべてのリソース・モニターを指定のディレクトリーにエクスポートします。
fteListMonitors -ma AGENT1 -od /usr/mft/resmonbackupワイルドカード・マッチングを使用して、エクスポートするリソース・モニターを定義できます。アスタリスク文字 (*) を使用して、エージェント名とモニター名のいずれかまたは両方と突き合わせるパターンを指定できます。
この例では、AGENT1 にある MON* というパターンに合致する名前のすべてのリソース・モニターを指定のディレクトリーにエクスポートします。
fteListMonitors -ma AGENT1 -mn MON* -od /usr/mft/resmonbackupこの例では、AGEN* というパターンに合致する名前のエージェントにあるすべてのリソース・モニターを指定のディレクトリーにエクスポートします。
fteListMonitors -ma AGEN* -od /usr/mft/resmonbackupこの例では、AGENT* というパターンに合致する名前のエージェントにある MON* というパターンに合致する名前のすべてのリソース・モニターを指定のディレクトリーにエクスポートします。
fteListMonitors -ma AGENT* -mn MON* -od /usr/mft/resmonbackup戻りコード
- 0
- コマンドは正常に完了しました。
- 1
- コマンドは失敗しました。