MQ 構成のダンプ (DMPMQMCFG)
実行可能な場所: | スレッド・セーフ: |
---|---|
すべての環境 (*ALL) | はい |
MQ 構成のダンプ (DMPMQMCFG) コマンドは、キュー・マネージャーの構成オブジェクトおよび権限をダンプするために使用されます。
パラメーター
キーワード | 説明 | 選択 | 注 |
---|---|---|---|
MQMNAME | メッセージ・キュー・マネージャー名 | 文字値、*ALL | オプション、定位置 1 |
OBJ | オブジェクト名 | 文字値、*ALL | オプション、定位置 2 |
OBJTYPE | オブジェクト・タイプ | *ALL、*AUTHINFO、*CHL、*CLTCN、*COMMINFO、*LSR、*NMLIST、*PRC、*Q、*MQM、*SVC、*SUB、*TOPIC | オプショナル, 定位置 3 |
EXPTYPE | エクスポート・タイプ | *ALL、*OBJECT、*AUTHREC、*CHLAUTH | オプショナル, 定位置 4 |
EXPATTR (EXPATTR) | エクスポートの属性 | *NONDEF、*ALL | オプショナル, 定位置 5 |
WARN | 警告 | *NO、*YES | オプショナル, 定位置 6 |
OUTPUT | 出力 | *MQSC、*ONELINE、*SETMQAUT、*GRTMQMAUT | オプショナル, 定位置 7 |
CLIENT | クライアント接続 | *NO、*YES、*CHL | オプショナル, 定位置 8 |
クライアント・チャネル | MQSCチャネル定義 | 文字値、*NONE | オプショナル, 定位置 9 |
MSGSEQNUM (MSGSEQNUM) | メッセージ順序番号 | 1 から 999999999、*NORESET | オプショナル, 定位置 10 |
RPLYQ (RPLYQ) | 応答キュー | 文字値、 'SYSTEM.DEFAULT.MODEL.QUEUE' | オプショナル, 定位置 11 |
RMTMQMNAME | リモート・メッセージ・キュー・マネージャー | 文字値、*NONE | オプション、定位置 12 |
ファイル | 出力を受け取るファイル | 修飾オブジェクト名 | オプション、定位置 13 |
修飾子 1: 出力を受け取るファイル | 名前 | ||
修飾子 2: ライブラリー | 名前、 *LIBL | ||
TOMBR (TOMBR) | 出力を受け取るメンバー | 名前 | オプション、定位置 14 |
メッセージ・キュー・マネージャー名 (MQMNAME)
オブジェクト情報を表示する IBM® MQ キュー・マネージャーの名前を指定します。
- *DFT
- キュー・マネージャー名
- 既存のメッセージ・キュー・マネージャーの名前です。 最大ストリング長は 48 文字です。
オブジェクト名 (OBJ)
ダンプ対象オブジェクトの名前を指定します。 これは、48 文字の MQ オブジェクト名または総称オブジェクト名です。
- *ALL
- 指定したタイプ (OBJTYPE) のすべてのオブジェクトがダンプされます。
- generic-object-name
- オブジェクトの総称名を指定します。 総称名とは、例えば ABC* のように、文字ストリングの後にアスタリスク (*) を付けたものです。 これで、選択した文字ストリングで始まる名前を持つすべてのオブジェクトを選択できます。
必要な名前を引用符で囲んで指定することで、入力した内容を正確に選択することができます。
すべての名前を要求しない限り、総称名の大文字および小文字バージョンのすべてを単一パネルで選択することはできません。
- object-name
- 対応する名前とタイプを表示するオブジェクトの名前です。
オブジェクト・タイプ (OBJTYPE)
ダンプ対象オブジェクトのタイプを指定します。
- *ALL
- OBJ で指定された名前を持つすべての MQ オブジェクト。
- *AUTHINFO
- OBJ で指定された名前を持つすべての MQ 認証情報オブジェクト。
- *CHL
- OBJ で指定された名前を持つすべての MQ チャネル・オブジェクト。
- *CLTCN
- OBJ で指定された名前を持つすべての MQ クライアント接続オブジェクト。
- *COMMINFO
- OBJ で指定された名前を持つすべての MQ 通信情報オブジェクト。
- *LSR
- OBJ で指定された名前を持つすべての MQ リスナー・オブジェクト。
- *NMLIST
- OBJ で指定された名前を持つすべての MQ 名前リスト・オブジェクト。
- *PRC
- OBJ で指定された名前を持つすべての MQ プロセス・オブジェクト。
- *Q
- OBJ で指定された名前を持つすべての MQ キュー・オブジェクト。
- *MQM
- キュー・マネージャー・オブジェクト。
- *SVC
- OBJ で指定された名前を持つすべての MQ サービス・オブジェクト。
- *TOPIC
- OBJ で指定された名前を持つすべての MQ トピック・オブジェクト。
エクスポート・タイプ (EXPTYPE)
エクスポートのタイプを指定します。
- *ALL
- すべての MQ オブジェクト情報、権限情報、およびサブスクリプション構成情報がダンプされます。
- *OBJECT (* オブジェクト)
- MQ オブジェクト情報のみがダンプされます。
- *AUTHREC
- MQ 権限情報のみがダンプされます。
- *CHLAUTH
- MQ チャネル権限レコードのみがダンプされます。
- *SUB
- MQ 永続サブスクリプション情報のみがダンプされます。
エクスポート属性 (EXPATTR)
エクスポートする属性を指定します。
- *NONDEF
- デフォルト以外の属性値のみがダンプされます。
- *ALL
- すべての属性値がダンプされます。
警告 (WARN)
ダンプ中に警告を生成するかどうかを指定します。例えば、意図していたものより新しいキュー・マネージャーにコマンドが発行された場合や、損傷したオブジェクトが検出された場合です。
- *NO
- ダンプ中に警告メッセージは出されません。
- *YES
- ダンプ中に警告メッセージがあれば出されます。
出力 (OUTPUT)
ダンプの出力形式を指定します。
- *MQSC
- 出力形式は MQSC コマンドの形式になり、RUNMQSC コマンドまたは STRMQMMQSC コマンドへの入力として使用できます。
- *ONELINE
- 出力形式は、単一行レコードにフォーマット設定された MQSC コマンドの形式になり、行比較ツールでの使用に適しています。
- *SETMQAUT
- 出力形式は setmqaut コマンドの形式で、 Windows または UNIXでの使用に適しています。
- *GRTMQMAUT
- 出力形式は GRTMQMAUT コマンドの形式であり、 IBM i プラットフォームで CL プログラムを生成する場合に適しています。
クライアント接続 (CLIENT)
キュー・マネージャーへの接続にクライアント接続を使用するかどうかを指定します。
- *NO
- コマンドは、まずサーバー・バインディング接続を試行し、この接続に失敗した場合にクライアント接続を試行します。
- *YES
- コマンドは、デフォルトのクライアント接続プロセスを使用してクライアント接続経由での接続を試行します。 MQSERVER 環境変数を設定すると、クライアント接続チャネル・テーブルの使用がオーバーライドされます。
- *CHL
- コマンドは、CLIENTCHL パラメーターで指定された MQSC ストリングによって定義される一時チャネル定義を使用してキュー・マネージャーに接続を試行します。
MQSC チャネル定義 (CLIENTCHL)
キュー・マネージャーに接続する際に使用する一時クライアント・チャネル定義を MQSC 構文を使って指定します。
- *NONE 値
- キュー・マネージャーに接続する際に一時クライアント・チャネル定義を使用しません。
- mqsc-define-channel-string
- コマンドは、このパラメーターで指定された MQSC コマンドを使用して一時クライアント・チャネル定義の構成を試行します。 MQSC コマンドでは、クライアント接続チャネルに必要なすべての属性を定義する必要があります。例えば次のようにします。
"DEFINE CHANNEL(MY.CHL) CHLTYPE(CLNTCONN) CONNAME(MYHOST.MYCORP.COM(1414))"
メッセージ順序番号 (MSGSEQNUM)
チャネル・オブジェクトをダンプするときに、送信側チャネル・タイプ、サーバー・チャネル・タイプ、およびクラスター送信側チャネル・タイプに対する Reset Channel コマンドを生成するかどうかを指定します。
- *NORESET
- ダンプ出力に Reset Channel コマンドを含めません。
- 1 - 999999999
- Reset Channel コマンドのメッセージ・シーケンス番号をダンプに含めるように指定します。
応答キュー (RPLYQ)
構成情報の照会時に PCF 応答を受け取るために使用するキューの名前を指定します。
- SYSTEM.DEFAULT.MODEL.QUEUE
- デフォルトのモデル・キューである動的キューが生成されて応答を受け取ります。
- reply-to-queue-name
- キューへの応答の名前を指定します。
リモート・メッセージ・キュー・マネージャー (RMTMQMNAME)
オブジェクト情報を表示する対象となるリモート MQ キュー・マネージャーの名前を指定します。
- *NONE 値
- 構成情報は、MQMNAME パラメーターで指定されたキュー・マネージャーから収集されます。
- リモート・キュー・マネージャー名
- リモート・キュー・マネージャーの名前を指定します。 PCF 照会コマンドは、MQMNAME で指定されたキュー・マネージャーを介して RMTMQMNAME で指定されたキュー・マネージャーに発行されます。これはキュー・モードと呼ばれます。 \
出力を受け取るファイル (TOFILE)
ダンプされた構成データを格納するために使用されるファイルの修飾名を LIBRARY/FILE の形式で指定します。 FILE は 240 の レコード長で作成されているはずです。それ以外の場合は、構成情報が切り捨てられる可能性があります。
- *LIBL
- ライブラリー・リストでファイル名を検索します。
- *CURLIB
- 現行ライブラリーが使用されます。
- to-library-name
- 使用されるライブラリーの名前を指定します。
- to-file-name
- 構成データを格納するファイルの名前を指定します。
出力を受け取るメンバー (TOMBR)
ダンプされた構成データを格納するメンバーの名前を指定します。
- to-member-name
- 構成データを格納するメンバーの名前を指定します。
例
これらの例が機能するためには、システムがリモート MQSC 操作用に 設定されている必要があります。 リモート管理のためのキュー・マネージャーの準備 および リモート管理のためのチャネルおよび伝送キューの準備を参照してください。
DMPMQMCFG MQMNAME('MYQMGR') CLIENT(*YES) CLIENTCHL('''DEFINE CHANNEL(SYSTEM.ADMIN.SVRCONN)
CHLTYPE(CLNTCONN) CONNAME(''myhost.mycorp.com(1414)'')''')
リモート・キュー・マネージャー MYQMGR からのすべての構成情報を MQSC 形式でダンプし、 SYSTEM.ADMIN.SVRCONNDMPMQMCFG MQMNAME('LOCALQM') RMTMQMNAME('MYQMGR')
MQSC 形式のリモート・キュー・マネージャー MYQMGR からのすべての構成情報をダンプし、
最初にローカル・キュー・マネージャー LOCALQM に接続して、このローカル・キュー・マネージャーを
介して照会メッセージを送信します。