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

メンバーが次のアクションの実行を許可されるグループの名前。

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

このオプションは、 IBM MQ for AIX®、 Solaris、 HP-UX、および Linuxに適用されます。

デフォルト値は -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 および Linux のユーザー ID と権限は、 Windows システムのユーザー ID と権限とは異なります。

UNIX および 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

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

-lp LogPrimaryファイル

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

Windows システムでは、1 次ログ・ファイルの最小数は 2、最大数は 254 です。 UNIX および Linux システムでは、1 次ログ・ファイルの最小数は 2、最大数は 510 です。 デフォルトは 3 です。

Windows システムでは、1 次ログ・ファイルと 2 次ログ・ファイルの総数は 255 を超えてはならず、3 以上でなければなりません。 UNIX および Linux システムでは、1 次ログ・ファイルと 2 次ログ・ファイルの総数は、511 を超えてはならず、3 以上でなければなりません。

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

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

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

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

-ls LogSecondaryファイル

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

Windows システムでは、2 次ログ・ファイルの最小数は 1、最大数は 253 です。 UNIX および Linux システムでは、2 次ログ・ファイルの最小数は 2 で、最大数は 509 です。 デフォルトは 2 です。

Windows システムでは、1 次ログ・ファイルと 2 次ログ・ファイルの総数は 255 を超えてはならず、3 以上でなければなりません。 UNIX および Linux システムでは、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 はログ・ファイルについてすべての許可を持っている必要があります。

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

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

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

-oa グループ | user

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

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

-p PortNumber

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

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

-q

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

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

-sa

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

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

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

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

-sax

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

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

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

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

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

-si

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

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

-ss

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

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

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

-t IntervalValue

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

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

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

-u DeadLetterキュー

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

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

-x MaximumUncommittedメッセージ

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

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

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

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

-z

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

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

戻りコード

関連コマンド