crtmqm (キュー・マネージャーの作成)

目的

crtmqm コマンドは、キュー・マネージャーを作成し、デフォルトおよびシステム・オブジェクトを定義するために使用します。 crtmqm コマンドによって作成されるオブジェクトは、 システム・オブジェクトとデフォルト・オブジェクトにリストされています。 キュー・マネージャーが作成されている場合は、strmqm コマンドを使用して開始します。

キュー・マネージャーは、crtmqm コマンドを発行したインストール済み環境に自動的に関連付けられます。 関連付けられたインストール済み環境を変更するには、setmqm コマンドを使用します。

Windows インストーラーは、インストールを実行するユーザーを mqm グループに自動的に追加しないことに注意してください。 詳しくは、 UNIX、 Linux® および Windows システム上の IBM® MQ を管理する権限を参照してください。

必要なパラメーター

QMgrName

作成するキュー・マネージャーの名前。 名前の長さは48文字までです。 このパラメーターは、このコマンドの最後の項目にする必要があります。

注: QMgrName は、 IBM MQ アプリケーション、他の IBM MQ キュー・マネージャー、および IBM MQ 制御コマンドがこのキュー・マネージャーを識別するために使用します。

このマシン上に同じ名前を持つキュー・マネージャーは 存在することができません。 このキュー・マネージャーが他のキュー・マネージャーに 接続する場合は、キュー・マネージャーのグループ内でキュー・マネージャー名が一意であることを確認する必要があります。

QMgrName は、キュー・マネージャーのディスクで作成されたディレクトリーの命名にも使用されます。 ファイル・システムの制限により、作成されるディレクトリーの名前は、 crtmqm コマンドで提供される QMgrName と同じでない場合があります。

これらの場合、作成されるディレクトリーは、提供された QMgrName に基づいていますが、変更されたり、キュー・マネージャー名に.000や.001などの接尾部が追加されたりすることがあります。

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

-a [r] アクセス・グループ

アクセス・グループ・パラメーターを使用して、 Windows セキュリティー・グループを指定します。このグループのメンバーには、すべてのキュー・マネージャー・データ・ファイルに対する全アクセス権限が付与されます。 このグループは、使用する構文に応じて、ローカル・グループかグローバル・グループのいずれかになります。

グループ名の有効な構文は次のとおりです。

• LocalGroup
• Domain name¥GlobalGroup name
• GlobalGroup name @ ドメイン名

-a [r] オプションを指定して crtmqm コマンドを実行する前に、追加のアクセス・グループを定義する必要があります。

-aの代わりに-arを使用してグループを指定すると、ローカルmqmグループにはキュー・マネージャー・データ・ファイルへのアクセス権限が付与されません。 キュー・マネージャー・データ・ファイルをホストするファイル・システムが、ローカルに定義されたグループのアクセス制御項目をサポートしていない場合は、このオプションを使用してください。

このグループは通常はグローバル・セキュリティー・グループです。グローバル・セキュリティー・グループは、複数インスタンス・キュー・マネージャーに、キュー・マネージャーの共有データ・フォルダーと共有ログ・フォルダーに対するアクセス権を付与するために使用されます。 このような追加のセキュリティー・アクセス・グループを使用すれば、キュー・マネージャーのデータ・ファイルとログ・ファイルが含まれているフォルダーや共有フォルダーに対する読み取り/書き込み権限を設定できます。

キュー・マネージャーのデータとログが含まれているフォルダーに対する権限を設定するために、追加のセキュリティー・アクセス・グループを、mqm という名前のローカル・グループを使用する代わりに使用することもできます。 ローカル・グループ mqm とは異なり、追加のセキュリティー・アクセス・グループをローカル・グループまたはグローバル・グループにすることができます。 複数インスタンス・キュー・マネージャーが使用するデータ・ファイルとログ・ファイルが含まれている共有フォルダーに対する権限を設定する場合は、グローバル・グループを使用する必要があります。

Windows オペレーティング・システムは、キュー・マネージャーのデータ・ファイルとログ・ファイルに対する読み取り/書き込みアクセス権を検査します。 検査の対象になるのは、キュー・マネージャーのプロセスを実行しているユーザー ID の権限です。 検査対象になるユーザー ID は、キュー・マネージャーをサービスとして開始したか、それとも対話式に開始したかによって異なります。 キュー・マネージャーをサービスとして開始した場合、Windows システムによって検査されるユーザー ID は、「IBM MQ の準備」ウィザードで構成したユーザー ID です。 キュー・マネージャーを対話式に開始した場合、 Windows システムによって検査されるユーザー ID は、 strmqm コマンドを実行したユーザー ID です。

キュー・マネージャーを開始するには、ユーザー ID がローカル mqm グループのメンバーでなければなりません。 そのユーザー ID が追加のセキュリティー・アクセス・グループのメンバーになっていれば、キュー・マネージャーで、そのグループに基づいて権限が与えられているファイルを読み書きすることが可能になります。

制約事項: 追加のセキュリティー・アクセス・グループは、 Windows オペレーティング・システムでのみ指定できます。 他のオペレーティング・システムで追加のセキュリティー・アクセス・グループを指定すると、crtmqm コマンドでエラーが返されます。

-c テキスト

このキュー・マネージャーの記述テキスト。 最大 64 文字まで使用できます。デフォルトはすべてブランクです。

特殊文字を組み込む場合は、記述を単一引用符で囲みます。 システムで 2 バイト文字セット (DBCS) を使用している場合には、文字の最大数は少なくなります。

-d DefaultTransmissionキュー

伝送キューが宛先について明示的に定義されなかったときにリモート・メッセージが置かれるローカル伝送キューの名前。 デフォルトはありません。

-g ApplicationGroup

UNIX and Linuxでは、以下のアクションの実行を許可されているメンバーを含むグループの名前。

• MQI アプリケーションの実行
• すべての IPCC リソースの更新
• 一部のキュー・マネージャー・ディレクトリーの内容の変更

デフォルト値は-g allで、これは無制限のアクセスを許可します。

-g ApplicationGroup 値は、キュー・マネージャー構成ファイル qm.iniに記録されます。

mqmユーザー ID およびコマンドを実行するユーザーは、指定されたアプリケーション・グループに属している必要があります。 制限モードの操作について詳しくは、 制限モードを参照してください。

-h MaximumHandle制限

アプリケーションで同時にオープンできるハンドルの最大数。

1 から 999999999 の範囲の値を指定します。 デフォルト値は 256 です。

次の一連のパラメーターの説明は、ロギングに関連しています。これについては、 リカバリーのためのログの使用で説明されています。

-lc

循環ロギングを使用します。 これは、デフォルトのロギングの方法です。

-ld LogPath

ログ・ファイルを格納するために使用するディレクトリー。 ログ・パスを保管するデフォルト・ディレクトリーは、 IBM MQのインストール時に定義されます。

ログ・ファイル・ディレクトリーが含まれているボリュームがファイル・セキュリティーに対応している場合は、そのログ・ファイル・ディレクトリーに対するアクセス権限が必要になります。 つまり、キュー・マネージャーを実行するユーザー ID に、そのディレクトリーとサブディレクトリーに対する読み取り/書き込み権限を与えることができます。 IBM MQをインストールするときに、デフォルトのログ・ディレクトリーでユーザー ID とmqmグループに権限を付与します。 ログ・ファイルを別のディレクトリーに書き込むために LogPath パラメーターを設定する場合は、そのディレクトリーに対する読み取り/書き込み権限をそのユーザー ID に与える必要があります。 UNIX and Linux のユーザー ID と権限は、 Windows システムのユーザー ID と権限とは異なります。

UNIX and Linux

ディレクトリーとそのサブディレクトリーは、グループmqm内のユーザーmqmによって所有されている必要があります。

キュー・マネージャーの複数のインスタンスでログ・ファイルを共有する場合は、それぞれのインスタンスで同じセキュリティー ID (sid) を使用する必要があります。 キュー・マネージャーのインスタンスを実行する異なるサーバー上で、ユーザーmqmを同じsidに設定しておく必要があります。 グループmqmの場合も同様です。

Windows

そのディレクトリーにアクセスするのがキュー・マネージャーの 1 つのインスタンスだけの場合は、そのディレクトリーに対する読み取り/書き込み権限を以下のグループとユーザーに与える必要があります。

• ローカル・グループmqm
• ローカル・グループAdministrators
• SYSTEM ユーザー ID

キュー・マネージャーの複数の異なるインスタンスに共有ログ・ディレクトリーに対するアクセス権限を付与するには、そのキュー・マネージャーがグローバル・ユーザーを使用してそのログ・ディレクトリーにアクセスする必要があります。 そのグローバル・ユーザーが含まれているグローバル・グループに、そのログ・ディレクトリーに対する読み取り/書き込みアクセス権限を付与してください。 グローバル・グループは、-aパラメーターで指定された追加のセキュリティー・アクセス・グループです。

IBM MQ for Windows システムでは、デフォルトのディレクトリーは C:\ProgramData\IBM\MQ\log です ( C: がデータ・ドライブであると想定しています)。 ボリュームがファイル・セキュリティーをサポートする場合、SYSTEM ID、管理者、および mqm グループに、ディレクトリーに対する読み取り/書き込み権限を付与する必要があります。

IBM MQ for UNIX および Linux システムでは、デフォルト・ディレクトリーは /var/mqm/logです。 ユーザー ID mqm およびグループ mqm はログ・ファイルについてすべての許可を持っている必要があります。

これらのファイルの位置を変更する場合は、それらの権限を取得する必要があります。 この権限が自動的に設定される場合、ログ・ファイルはそのデフォルトの場所に置かれます。

-lf LogFileページ

ログ・データは、ログ・ファイルと呼ばれる一連のファイルに保持されます。 ログ・ファイル・サイズは、4 KB ページ単位で指定します。

IBM MQ for UNIX および Linux システムでは、ログ・ファイル・ページのデフォルト数は 4096 で、ログ・ファイル・サイズは 16 MB です。 ログ・ファイルの最小ページ数は 64 であり、最大ページ数は 65535 です。

IBM MQ for Windows システムでは、デフォルトのログ・ファイル・ページ数は 4096 で、ログ・ファイル・サイズは 16 MB です。 ログ・ファイルの最小ページ数は 32 であり、最大ページ数は 65535 です。

注: キュー・マネージャーの作成時に指定したキュー・マネージャーのログ・ファイルのサイズは変更できません。

-ll LinearLogging

リニア・ロギングを使用します。

Multiplatforms の場合、 IBM MQ 9.0.2以降、既存の -ll オプションを使用してキュー・マネージャーを作成する場合は、以前と同様にログ・エクステントを手動で管理する必要があります (LogManagement= Manual)。

-ラ

ログ・エクステントの自動管理 (LogManagement= 自動) でリニア・ロギングを使用します。

-lln

ログ・エクステントのアーカイブ管理 (LogManagement= アーカイブ) でリニア・ロギングを使用します。

-lp LogPrimaryファイル

キュー・マネージャーの作成時に割り振られるログ・ファイル。

Windows システムの場合:

• 設定できる 1 次ログ・ファイルの最小数は 2、最大数は 254 です。
• 1 次ログ・ファイルと 2 次ログ・ファイルの合計数が 255 を超えてはなりません。また、3 より少なくてはなりません。

UNIX and Linux システムの場合:

• 設定できる 1 次ログ・ファイルの最小数は 2、最大数は 510 です。 デフォルトは 3 です。
• 1 次ログ・ファイルと 2 次ログ・ファイルの合計数が 511 を超えてはなりません。また、3 より少なくてはなりません。

オペレーティング・システムの制限により、最大ログ・サイズがさらに減少することもあります。

この値は、キュー・マネージャーの作成時または開始時に調べられます。 キュー・マネージャーが作成された後に、この値を変更することができます。 ただし、この変更された値は、キュー・マネージャーが再始動されるまで有効にならないので、効果はただちに現れません。

1 次ログ・ファイルについて詳しくは、 ログの内容を参照してください。

1 次ログ・ファイルのサイズを計算するには、 ログのサイズの計算を参照してください。

-ls LogSecondaryファイル

1 次ファイルが足りなくなったときに割り振られるログ・ファイル。

Windows システムの場合:

• 設定できる 2 次ログ・ファイルの最小数は 1、最大数は 253 です。
• 1 次ログ・ファイルと 2 次ログ・ファイルの合計数が 255 を超えてはなりません。また、3 より少なくてはなりません。

UNIX and Linux システムの場合:

• 設定できる 2 次ログ・ファイルの最小数は 2、最大数は 509 です。 デフォルトは 2 です。
• 1 次ログ・ファイルと 2 次ログ・ファイルの合計数が 511 を超えてはなりません。また、3 より少なくてはなりません。

オペレーティング・システムの制限により、最大ログ・サイズがさらに減少することもあります。

この値は、キュー・マネージャーの始動時に検査されます。 この値は変更することができます。ただし、変更された値は、キュー・マネージャーが再始動されるまでは有効にはなりません。有効になった場合でも効果がただちに現れるとは限りません。

2 次ログ・ファイルの使用について詳しくは、 ログの内容を参照してください。

2 次ログ・ファイルのサイズを計算するには、 ログのサイズの計算を参照してください。

-md DataPath

キュー・マネージャーのデータ・ファイルを保持するために使用されるディレクトリー。

IBM MQ for Windows システムでは、デフォルトは C:\ProgramData\IBM\MQ\qmgrs です ( C: がデータ・ドライブであることを想定しています)。 ボリュームがファイル・セキュリティーをサポートする場合、SYSTEM ID、管理者、および mqm グループに、ディレクトリーに対する読み取り/書き込み権限を付与する必要があります。

IBM MQ for UNIX および Linux システムでは、デフォルトは /var/mqm/qmgrsです。 ユーザー ID mqm およびグループ mqm はログ・ファイルについてすべての許可を持っている必要があります。

Linux システム上の RDQM の場合、デフォルトは /var/mqm/vols/qmgrname/qmgr/です。

DataPathパラメーターは、複数インスタンス・キュー・マネージャーの構成を支援するために提供されています。 例えば、UNIX and Linuxシステムの場合: /var/mqmディレクトリーがローカル・ファイル・システムにある場合、DataPathパラメーターとLogPathパラメーターを使用して、複数のキュー・マネージャーからアクセス可能な共有ファイル・システムを指定します。

注: DataPath パラメーターを使用して作成されたキュー・マネージャーは、 IBM WebSphere® MQ 7.0.1より前のバージョンの製品で実行されますが、 DataPath パラメーターを削除するようにキュー・マネージャーを再構成する必要があります。 キュー・マネージャーをIBM WebSphere MQ 7.0.1 より前の構成に復元し、 DataPath パラメーターを使用せずに実行する方法は 2 つあります。キュー・マネージャー構成の編集に自信がある場合は、 Prefix キュー・マネージャー構成パラメーターを使用してキュー・マネージャーを手動で構成できます。 あるいは、以下の手順を実行してキュー・マネージャーを編集することもできます。

1. キュー・マネージャーを停止させます。
2. キュー・マネージャー・データおよびログ・ディレクトリーを保存します。
3. キュー・マネージャーを削除してください。
4. IBM WebSphere MQ をIBM WebSphere MQ 7.0.1 より前のフィックス・レベルにバックアウトします。
5. 同じ名前でキュー・マネージャーを作成します。
6. 新規のキュー・マネージャー・データおよびログ・ディレクトリーを、保存したもので置き換えます。

-oa グループ|user

UNIX and Linux システムでは、グループ許可またはユーザー許可のどちらを使用するかを指定できます。 このパラメーターを設定しない場合は、グループ許可が使用されます。 許可モデルを後で変更するには、 qm.ini ファイルのサービス・スタンザに SecurityPolicy パラメーターを設定します ( qm.ini ファイルのサービス・スタンザを参照)。

詳しくは、 オブジェクト権限マネージャー (OAM)を参照してください。

-p PortNumber

指定したポートの管理対象 TCP リスナーを作成します。

指定したポートを使用する TCP リスナー・オブジェクトを作成するには、1 から 65535 までの範囲の有効なポート値を指定してください。 新しいリスナーは SYSTEM.LISTENER.TCP.1 という名前になります。 このリスナーはキュー・マネージャーの制御下に置かれ、キュー・マネージャーとともに開始され、停止します。

-q

このキュー・マネージャーをデフォルトのキュー・マネージャーにします。 新しいキュー・マネージャーが、既存のデフォルトのキュー・マネージャーと置き換わります。

誤ってこのフラグを使用し、既存のキュー・マネージャーをデフォルトのキュー・マネージャーとして戻す場合は、 既存のキュー・マネージャーをデフォルトのキュー・マネージャーにするの説明に従って、デフォルトのキュー・マネージャーを変更してください。

-rr InstanceType

災害復旧複製データ・キュー・マネージャー (DR RDQM) を作成します。 -rr p を指定してキュー・マネージャーの 1 次インスタンスを作成するか、 -rr s を指定して 2 次インスタンスを作成します。 このコマンドを使用するには、rootであるか、sudo特権を持つmqmグループのユーザーでなければなりません。

-rt ReplicationType

オプションで、DR RDQM 構成が同期レプリケーションと非同期レプリケーションのどちらを使用するかを指定します。 同期の場合は -rt s を指定し、非同期の場合は -rt a を指定します。 非同期がデフォルトです。

-rl LocalIP

DR RDQM の 1 次インスタンスと 2 次インスタンスの間のデータのレプリケーションに使用されるローカル IP アドレスを指定します。

-ri RemoteIP

DR RDQM の 1 次インスタンスと 2 次インスタンスの間のデータのレプリケーションに使用されるリモート IP アドレスを指定します。

-rn RemoteName

キュー・マネージャーの他のインスタンスをホストしているシステムの名前を指定します。 この名前は、そのサーバーで uname -n を実行した時に返される値です。

-rp DRポート

DR レプリケーションに使用するポートを指定します。

-sa

自動キュー・マネージャー始動。 Windows システムの場合のみ。

キュー・マネージャーは、 IBM MQ サービスの開始時に自動的に開始するように構成されます。

IBM MQ Explorerからキュー・マネージャーを作成する場合は、これがデフォルト・オプションです。

IBM WebSphere MQ 7 より前のリリースで作成されたキュー・マネージャーは、既存の始動タイプを保持します。

-sax

複数インスタンスを許可する自動キュー・マネージャー始動。 Windows システムの場合のみ。

キュー・マネージャーは、 IBM MQ サービスの開始時に自動的に開始するように構成されます。

キュー・マネージャーのインスタンスがまだ実行されていなければ、キュー・マネージャーが開始され、そのインスタンスがアクティブになり、スタンバイ・インスタンスがどの場所でも許可されます。 スタンバイを許可するキュー・マネージャー・インスタンスが別のサーバーで既にアクティブになっている場合、新しいインスタンスがスタンバイ・インスタンスになります。

1 台のサーバーで実行可能なキュー・マネージャーのインスタンスは 1 つだけです。

IBM WebSphere MQ 7.0.1 より前のバージョンの製品で作成されたキュー・マネージャーは、既存の始動タイプを保持します。

-si

対話式 (手動) キュー・マネージャー始動。

キュー・マネージャーは、strmqm コマンドを使用して手動で要求するときにのみ始動するように構成されます。 キュー・マネージャーは、ユーザーがログオンしているときにその (対話式) ユーザーの下で実行されます。 対話式始動で構成されたキュー・マネージャーは、キュー・マネージャーを開始したユーザーがログオフすると終了します。

-ss

サービス (手動) キュー・マネージャー始動。

キュー・マネージャーは、strmqm コマンドを使用して手動で要求されたときにのみ始動するように構成されます。 キュー・マネージャーは、 IBM MQ サービスの開始時にサービスの子プロセスとして実行されます。 サービス始動で構成されたキュー・マネージャーは、対話式ユーザーがログオフした後も継続して実行されます。

コマンド行からキュー・マネージャーを作成した場合は、これがデフォルト・オプションです。

-sx [-fs FilesystemSize]

そのキュー・マネージャーの 1 次ノードに高可用性複製データ・キュー・マネージャー (HA RDQM) を作成します。 RDQM は、 Linux でのみ使用可能な高可用性ソリューションです。 RDQM の作成について詳しくは、 HA RDQM の作成 を参照してください。 このコマンドを使用するには、root であるか、または sudo 特権を持つ mqm グループのユーザーでなければなりません。 ファイル・システム・サイズのデフォルト・サイズは 3 MB です。 キュー・マネージャーは自動的に開始されます。

-sxs [-fs FilesystemSize]

2 次ノードに複製データ・キュー・マネージャー (RDQM) を作成します。 RDQM は、 Linux でのみ使用可能な高可用性ソリューションです。 RDQM の作成について詳しくは、 HA RDQM の作成 を参照してください。 このコマンドを使用するには、root ユーザーでなければなりません。 ファイル・システム・サイズのデフォルト・サイズは 3 MB です。

-t IntervalValue

このキュー・マネージャーが制御するすべてのキューについて、トリガー時間間隔 (ミリ秒単位)。 この値は、キュー・マネージャーがトリガー生成メッセージを受け取った後の、トリガーが中断する時間を指定します。 つまり、あるメッセージがキューに到着してトリガー・メッセージが開始キューに入れられると、指定された時間間隔内に同じキューにメッセージが到着しても、別のトリガー・メッセージは生成されません。

このトリガー時間間隔を使用すれば、アプリケーションは、同じキューの別のトリガー条件を取り扱うよう警告されるまでに、トリガー条件を取り扱うための十分な時間の余裕が与えられます。 生じるすべてのトリガー・イベントをユーザー側で見たいという場合もあります。その場合には、このフィールドに小さな値かまたはゼロを設定してください。

0 から 999999999 の範囲の値を指定します。 デフォルトは、999999999 ミリ秒 (11 日より長い期間) です。 効果的にデフォルトが使用されるようにすると、トリガー操作は最初のトリガー・メッセージの後、使用不可になります。 しかし、アプリケーションは、キューを変更するコマンドを使用して、トリガー属性をリセットしてキューを保守することによって、トリガー操作を再び使用可能にすることができます。

-u DeadLetterキュー

送達不能 (未配布メッセージ) キューとして使用されるローカル・キューの名前。 メッセージが正しい宛先に送られない場合は、メッセージはこのキューに書き込まれます。

デフォルトでは、送達不能キューは指定されません。

-x MaximumUncommittedメッセージ

同期点においてコミットされないメッセージの最大数。 コミットされないメッセージは、以下の合計になります。

• キューから取り出すことができるメッセージの数
• キューに書き込むことができるメッセージの数
• この作業単位内で生成されたトリガー・メッセージの数

この制限は、同期点以外で取り出したり書き込まれたりするメッセージには適用されません。

1 から 999999999 の範囲の値を指定します。 デフォルト値は 10000 個のコミットされていないメッセージである。

-z

エラー・メッセージを抑制します。

このフラグは、不要なエラー・メッセージを抑止するために IBM MQ 内で使用されます。 コマンド行を使用する際は、このフラグを使用しないでください。 このフラグを使用すると、情報が失われる可能性があります。

戻りコード

戻りコード	説明
0	キュー・マネージャーが作成されました。
8	キュー・マネージャーは存在しています。
39	無効なパラメーターが指定されました。
49	キュー・マネージャーが停止中です。
58	複数のインストール済み環境が矛盾して使用されていることが検出されました
69	ストレージが使用不可です。
70	キュー・スペースが使用不可です。
71	予期しないエラーです。
72	キュー・マネージャー名のエラーです。
74	IBM MQ サービスは開始されません。
100	ログの位置が無効です。
111	キュー・マネージャーが作成されました。 ただし、プロダクト構成ファイル内のデフォルト・キュー・マネージャー定義の処理中に問題がありました。 デフォルト・キュー・マネージャーの指定が誤りである可能性があります。
115	ログ・サイズが無効です。
119	許可が拒否されました ( Windows のみ)