[IBM i]

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.SVRCONN
注: 同じ名前のサーバー接続チャネルが存在することを確認する必要があります。
DMPMQMCFG MQMNAME('LOCALQM') RMTMQMNAME('MYQMGR')
MQSC 形式のリモート・キュー・マネージャー MYQMGR からのすべての構成情報をダンプし、 最初にローカル・キュー・マネージャー LOCALQM に接続して、このローカル・キュー・マネージャーを 介して照会メッセージを送信します。
注: キュー・マネージャー間で応答を送受信するには、ローカル・キュー・マネージャーに MYQMGRという名前の伝送キューがあり、両方向にチャネル・ペアが定義されていることを確認する必要があります。