addmqinf (構成情報の追加)

AIX®, Linux®, and Windows にのみ IBM® MQ 構成情報を追加します。

目的

addmqinf コマンドを使用して、 IBM MQ 構成データに情報を追加します。

例えば、 dspmqinf を使用して構成データを表示し、 addmqinf を使用して、キュー・マネージャーが作成されたシステムから、同じ複数インスタンス・キュー・マネージャーも開始される他のシステムに構成データをコピーします。

Syntax

必要なパラメーター

--v 属性=値

コマンドに指定されたスタンザに配置するスタンザの属性の名前および値。

表 1 に、 QueueManager スタンザの属性値をリストします。現在サポートされているスタンザは、キュー・マネージャー・スタンザのみです。

表 1. QueueManager スタンザの属性
`属性`	`価値`	必須またはオプション
Name	キュー・マネージャーの名前。システム上の他のキュー・マネージャー・スタンザとは別の名前を指定する必要があります。	必須
Prefix	デフォルトでこのキュー・マネージャーのデータ・ディレクトリーの保管先となるディレクトリー・パス。 Prefix を使用して、キュー・マネージャーのデータ・ディレクトリーの位置を変更できます。 Directory の値が、このパスに自動的に付加されます。	必須
Directory	キュー・マネージャーのデータ・ディレクトリーの名前。キュー・マネージャー名とは異なるため、名前を指定しなければならない場合があります ( 例を参照)。 dspmqinf によって戻された値からディレクトリー名をコピーします。キュー・マネージャー名をディレクトリー名に変換するときのルールについては、IBM MQ のファイル名についての理解で説明されています。	必須
DataPath	キュー・マネージャーのデータ・ファイルが置かれるディレクトリー・パス。 Directory の値は、このパスに自動的には付加されません。変換したキュー・マネージャー名を DataPath の一部として提供する必要があります。 AIX and Linuxで DataPath 属性を省略した場合、キュー・マネージャーのデータ・ディレクトリー・パスは `Prefix / Directory`として定義されます。	オン AIX and Linux: オプションオン Windows: 必須
EphemeralPrefix	キュー・マネージャーの一時データ (IPC ソケットなど) が保管されるディレクトリーへのパスを指定します。 EphemeralPrefix 属性が省略されると、キュー・マネージャーの一時接頭部は `Prefix` として定義されます。	オプション

オプション・パラメーター

-s StanzaType: タイプ StanzaType のスタンザが IBM MQ 構成に追加されます。; StanzaType のデフォルト値は QueueManager です。; StanzaType でサポートされる値は QueueManager のみです。

戻りコード

表 2. 戻りコードの ID と説明
戻りコード	説明
0	正常な操作です。
1	キュー・マネージャーの位置が無効です (Prefix または DataPath のいずれか)
39	コマンド行パラメーターが正しくありません。
45	スタンザはすでに存在しています。
46	必須構成属性がありません。
58	複数のインストール済み環境が矛盾して使用されていることが検出されました
69	ストレージが利用不能です。
71	予期しないエラーです。
72	キュー・マネージャー名のエラーです。
100	ログの位置が無効です。

例

addmqinf -v DataPath=/MQHA/qmgrs/QM!NAME +
  -v Prefix=/var/mqm  +
  -v Directory=QM!NAME  +
  -v Name=QM.NAME

mqs.ini に次のスタンザを作成します。

QueueManager: 
   Name=QM.NAME
   Prefix=/var/mqm
   Directory=QM!NAME  
   DataPath=/MQHA/qmgrs/QM!NAME

使用上の注意

dspmqinf を addmqinf と共に使用して、別のサーバー上に複数インスタンス・キュー・マネージャーのインスタンスを作成します。

このコマンドを使用するには、 IBM MQ 管理者であり、 mqm グループのメンバーでなければなりません。

コマンド	説明
dspmqinf (構成情報の表示)	IBM MQ 構成情報の表示
rmvmqinf (構成情報の除去)	IBM MQ 構成情報の削除