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

キュー・マネージャーを作成します。

目的

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

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

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

構文

構文図を読むビジュアル構文図をスキップ crtmqm -a [R]< アクセス・グループ>1-cText-dデフォルトの伝送キュー-h最大ハンドル数の制限-lc-ll-lla-lln2-LDLogPath-lf (L)LogFilePages-lp (L)LogPrimaryFiles-ls (L)LogSecondaryFiles-q-ss-sa-sax-si-mddataPath-gアプリケーション・グループ-t間隔値-u送達不能キュー-オア3グループユーザー-pPortNumber-xコミットされていないメッセージの最大数-z-sx-フスファイル・システム・サイズ-sxs-フスファイル・システム・サイズ-エラーインスタンス・タイプ-rt (R)複製タイプ-rl (R)ローカル IP-リリモート IP-ルンリモート名-RPDRポート-フスファイル・システム・サイズ QMgrName
注:
  • 1 Windows の場合 のみ
  • 2 lc、ll、lla、または lln のいずれかのみを指定します
  • 3 UNIX および Linux のみ

必要なパラメーター

QMgrName
作成するキュー・マネージャーの名前。 名前は 48 文字以内で指定します。 このパラメーターは、このコマンドの最後の項目にする必要があります。
注: キュー・マネージャー名 は、 IBM MQ アプリケーション、他の IBM MQ キュー・マネージャー、および IBM MQ 制御コマンドによって、このキュー・マネージャーを識別するために使用されます。

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

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

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

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

[Windows]-a [r] (-a [r]) アクセス・グループ
アクセス・グループ・パラメーターを使用して、 Windows の場合 セキュリティー・グループを指定します。このグループのメンバーには、すべてのキュー・マネージャー・データ・ファイルに対する全アクセス権限が付与されます。 このグループは、使用する構文に応じて、ローカル・グループかグローバル・グループのいずれかになります。
グループ名の有効な構文は次のとおりです。
  • ローカル・グループ
  • Domain name &#xa5; GlobalGroup name
  • GlobalGroup name@Domain name

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

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

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

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

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

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

制約事項: 追加のセキュリティー・アクセス・グループを指定できるのは、 Windows の場合 オペレーティング・システムの場合のみです。 他のオペレーティング・システムで追加のセキュリティー・アクセス・グループを指定すると、crtmqm コマンドでエラーが返されます。
テキスト
このキュー・マネージャーの記述テキスト。 最大 64 文字まで使用できます。デフォルトはすべてブランクです。

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

-d デフォルトの伝送キュー (-d)
伝送キューが宛先について明示的に定義されなかったときにリモート・メッセージが置かれるローカル伝送キューの名前。 デフォルトはありません。
[UNIX][Linux]-g アプリケーション・グループ
UNIX および Linuxでは、以下のアクションの実行を許可されているメンバーを含むグループの名前。
  • MQI アプリケーションの実行
  • すべての IPCC リソースの更新
  • 一部のキュー・マネージャー・ディレクトリーの内容の変更

デフォルト値は -g all (無制限のアクセスを許可) です。

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

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

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

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

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

注: コミット後に変更できないものもあるため、注意してロギングの配置を選択してください。 crtmqm のロギング・オプションのデフォルトは、mqs.ini ファイル内の属性でオーバーライドできます。

mqs.ini ファイル内にロギング属性を指定すると、それらの属性が crtmqm のロギング・コマンド行パラメーターのデフォルト値をオーバーライドします。

-lc
循環ロギングを使用します。 これは、デフォルトのロギングの方法です。
-ld ログ・パス
ログ・ファイルを格納するために使用するディレクトリー。 ログ・パスを保管するデフォルト・ディレクトリーは、 IBM MQのインストール時に定義されます。
ログ・ファイル・ディレクトリーが含まれているボリュームがファイル・セキュリティーに対応している場合は、そのログ・ファイル・ディレクトリーに対するアクセス権限が必要になります。 つまり、キュー・マネージャーを実行するユーザー ID に、そのディレクトリーとサブディレクトリーに対する読み取り/書き込み権限を与えることができます。 IBM MQをインストールするときに、ユーザー ID とユーザー ID に権限を付与します。mqmデフォルトのログ・ディレクトリーでグループ化します。 ログ・ファイルを別のディレクトリーに書き込むために LogPath パラメーターを設定する場合は、そのディレクトリーに対する読み取り/書き込み権限をそのユーザー ID に与える必要があります。 UNIX および Linux のユーザー ID と権限は、 Windows の場合 システムのユーザー ID と権限とは異なります。
[UNIX][Linux]UNIX および Linux
ディレクトリーとそのサブディレクトリーは、ユーザーが所有している必要があります。mqmグループ内mqm.

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

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

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

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

[UNIX][Linux] IBM MQ (UNIX の場合) および Linux システムでは、デフォルト・ディレクトリーは以下のとおりです。/var/mqm/log. ユーザー IDmqmおよびグループmqmログ・ファイルに対する全権限が必要です。

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

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

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

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

注: キュー・マネージャーの作成時に指定したキュー・マネージャーのログ・ファイルのサイズは変更できません。
-ll (すべて) 線形ロギング
リニア・ロギングを使用します。

[V9.0.2 2017 年 5 月][UNIX、Linux、Windows、IBM i] マルチプラットフォームでは、 IBM MQ 9.0.2以降、既存の -ル オプションを使用してキュー・マネージャーを作成する場合、以前と同様にログ・エクステントの手動管理を実行する必要があります (ログ管理= Manual)。

[V9.0.2 2017 年 5 月][UNIX、Linux、Windows、IBM i]-ラ
ログ・エクステントの自動管理 (LogManagement=Automatic) でリニア・ロギングを使用します。
[V9.0.2 2017 年 5 月][UNIX、Linux、Windows、IBM i]-lln
ログ・エクステントのアーカイブ管理 (LogManagement=Archive) でリニア・ロギングを使用します。
-lp ログ・プライマリー・ファイル
キュー・マネージャーの作成時に割り振られるログ・ファイル。
[Windows] Windows の場合 システムの場合:
  • 設定できる 1 次ログ・ファイルの最小数は 2、最大数は 254 です。
  • 1 次ログ・ファイルと 2 次ログ・ファイルの合計数が 255 を超えてはなりません。また、3 より少なくてはなりません。
[UNIX][Linux] UNIX および Linux システムの場合:
  • 設定できる 1 次ログ・ファイルの最小数は 2、最大数は 510 です。 デフォルトは 3 です。
  • 1 次ログ・ファイルと 2 次ログ・ファイルの合計数が 511 を超えてはなりません。また、3 より少なくてはなりません。

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

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

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

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

-ls 2 次ファイルのロギング
1 次ファイルが足りなくなったときに割り振られるログ・ファイル。
[Windows] Windows の場合 システムの場合:
  • 設定できる 2 次ログ・ファイルの最小数は 1、最大数は 253 です。
  • 1 次ログ・ファイルと 2 次ログ・ファイルの合計数が 255 を超えてはなりません。また、3 より少なくてはなりません。
[UNIX][Linux] UNIX および Linux システムの場合:
  • 設定できる 2 次ログ・ファイルの最小数は 2、最大数は 509 です。 デフォルトは 2 です。
  • 1 次ログ・ファイルと 2 次ログ・ファイルの合計数が 511 を超えてはなりません。また、3 より少なくてはなりません。

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

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

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

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

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

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

[UNIX][Linux] IBM MQ (UNIX の場合) および Linux システムの場合、デフォルトは以下のとおりです。/var/mqm/qmgrs. ユーザー IDmqmおよびグループmqmログ・ファイルに対する全権限が必要です。

[Linux] Linux システム上の RDQM の場合、デフォルトは以下のとおりです。/var/mqm/vols/qmgrname/qmgr/.

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

注: データ・パス パラメーターを使用して作成されたキュー・マネージャーは、 IBM WebSphere® MQ 7.0.1より前のバージョンの製品で実行されますが、 データ・パス パラメーターを削除するようにキュー・マネージャーを再構成する必要があります。 キュー・マネージャーをIBM WebSphere MQ 7.0.1 より前の構成に復元し、 データ・パス パラメーターを使用せずに実行するには、2 つのオプションがあります。キュー・マネージャー構成の編集に自信がある場合は、 接頭部 キュー・マネージャー構成パラメーターを使用してキュー・マネージャーを手動で構成できます。 あるいは、以下の手順を実行してキュー・マネージャーを編集することもできます。
  1. キュー・マネージャーを停止させます。
  2. キュー・マネージャー・データおよびログ・ディレクトリーを保存します。
  3. キュー・マネージャーを削除してください。
  4. IBM WebSphere MQIBM WebSphere MQ 7.0.1 より前のフィックス・レベルにバックアウトします。
  5. 同じ名前でキュー・マネージャーを作成します。
  6. 新規のキュー・マネージャー・データおよびログ・ディレクトリーを、保存したもので置き換えます。
-oa グループ|ユーザー
[UNIX][Linux] UNIX および Linux システムでは、グループ許可またはユーザー許可のどちらを使用するかを指定できます。 このパラメーターを設定しない場合は、グループ許可が使用されます。 許可モデルを後で変更するには、 qm.ini ファイルのサービス・スタンザで セキュリティー・ポリシー パラメーターを設定します ( サービス・スタンザの形式 を参照)。

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

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

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

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

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

[V9.0.5 2018 年 3 月][Linux]-rr インスタンス・タイプ
災害復旧複製データ・キュー・マネージャー (DR RDQM) を作成します。 キュー・マネージャーの 1 次インスタンスを作成するには -rr p を指定し、2 次インスタンスを作成するには -rr s を指定します。 その必要があります。rootまたは以下のユーザーmqmグループ化sudoこのコマンドを使用するための特権。
[V9.0.5 2018 年 3 月][Linux]-rt 複製タイプ
オプションで、DR RDQM 構成が同期レプリケーションと非同期レプリケーションのどちらを使用するかを指定します。 同期の場合は -rt s を指定し、非同期の場合は -rt a を指定します。 非同期がデフォルトです。
[V9.0.5 2018 年 3 月][Linux]-rl ローカル IP
DR RDQM の 1 次インスタンスと 2 次インスタンスの間のデータのレプリケーションに使用されるローカル IP アドレスを指定します。
[V9.0.5 2018 年 3 月][Linux]-リ リモート IP
DR RDQM の 1 次インスタンスと 2 次インスタンスの間のデータのレプリケーションに使用されるリモート IP アドレスを指定します。
[V9.0.5 2018 年 3 月][Linux]-rn リモート名
キュー・マネージャーの他のインスタンスをホストしているシステムの名前を指定します。 名前は、以下を実行した場合に返される値です。uname -nサーバー上にあります。
[V9.0.5 2018 年 3 月][Linux]-RP DRポート
DR レプリケーションに使用するポートを指定します。
[Windows]-sa
自動キュー・マネージャー始動。 Windows の場合 システムの場合のみ。

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

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

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

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

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

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

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

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

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

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

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

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

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

[Linux][V9.0.4 2017 年 10 月]-sx [-fs ファイル・システム・サイズ]
[Linux][V9.0.4 2017 年 10 月]そのキュー・マネージャーの 1 次ノードに高可用性複製データ・キュー・マネージャー (HA RDQM) を作成します。 RDQM は、 Linux でのみ使用可能な高可用性ソリューションです。 RDQM の作成について詳しくは、 HA RDQM の作成 を参照してください。 その必要があります。rootまたは以下のユーザーmqmグループ化sudoこのコマンドを使用するための特権。 ファイル・システム・サイズのデフォルト・サイズは 3 MB です。 キュー・マネージャーは自動的に開始されます。
[Linux][V9.0.4 2017 年 10 月]-sxs [-fs ファイル・システム・サイズ]
[Linux][V9.0.4 2017 年 10 月]2 次ノードに複製データ・キュー・マネージャー (RDQM) を作成します。 RDQM は、 Linux でのみ使用可能な高可用性ソリューションです。 RDQM の作成について詳しくは、 HA RDQM の作成 を参照してください。 次のユーザーでなければなりません:rootユーザーがこのコマンドを使用します。 ファイル・システム・サイズのデフォルト・サイズは 3 MB です。
間隔値
このキュー・マネージャーが制御するすべてのキューについて、トリガー時間間隔 (ミリ秒単位)。 この値は、キュー・マネージャーがトリガー生成メッセージを受け取った後の、トリガーが中断する時間を指定します。 つまり、あるメッセージがキューに到着してトリガー・メッセージが開始キューに入れられると、指定された時間間隔内に同じキューにメッセージが到着しても、別のトリガー・メッセージは生成されません。

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

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

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

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

-x コミットされていないメッセージの最大数 (X)
同期点においてコミットされないメッセージの最大数。 コミットされないメッセージは、以下の合計になります。
  • キューから取り出すことができるメッセージの数
  • キューに書き込むことができるメッセージの数
  • この作業単位内で生成されたトリガー・メッセージの数

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

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

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

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

戻りコード

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

  • 以下のコマンドは、以下の名前のデフォルト・キュー・マネージャーを作成します。Paint.queue.manager、および以下の説明Paint shopシステム・オブジェクトおよびデフォルト・オブジェクトを作成します。 これは、リニア・ロギングが使用されることも指定します。
    
    crtmqm -c "Paint shop" -ll -q Paint.queue.manager
    
  • 以下のコマンドは、以下の名前のデフォルト・キュー・マネージャーを作成します。Paint.queue.managerシステム・オブジェクトとデフォルト・オブジェクトを作成し、2 つの 1 次ログ・ファイルと 3 つの 2 次ログ・ファイルを要求します。
    
    crtmqm -c "Paint shop" -ll -lp 2 -ls 3 -q Paint.queue.manager
    
  • 以下のコマンドは、以下の名前のキュー・マネージャーを作成します。travelシステム・オブジェクトおよびデフォルト・オブジェクトを作成し、トリガー間隔を 5000 ミリ秒 (5 秒) に設定し、以下を指定します。SYSTEM.DEAD.LETTER.QUEUE送達不能キューとして使用されます。
    
    crtmqm -t 5000 -u SYSTEM.DEAD.LETTER.QUEUE travel
    
  • [UNIX][Linux]以下のコマンドは、以下の名前のキュー・マネージャーを作成します。QM1UNIX および Linux システムでは、共通の親ディレクトリーにログ・データ・フォルダーとキュー・マネージャー・データ・フォルダーがあります。 親ディレクトリーは、 複数インスタンス・キュー・マネージャーを作成するために、 高可用性ネットワーク・ストレージで共有します。 コマンドを発行する前に、ユーザーおよびグループが所有するその他のパラメーター /MQHA (オプション)/MQHA/ ログ および /MQHA/QMgrs を作成します。mqm、許可ありrwxrwxr-x.
    
    crtmqm -ld /MQHA/logs -md /MQHA/qmgrs QM1