Create Message Queue Manager (CRTMQM)
- 実行可能な場所
- すべての環境 (*ALL)
- スレッド・セーフ
- はい
メッセージ・キュー・マネージャーの作成 (CRTMQM) コマンドは、メッセージ・キュー・マネージャーの開始 (STRMQM) コマンドで開始できるローカル・キュー・マネージャーを作成します。
パラメーター
キーワード | 説明 | 選択 | 注 |
---|---|---|---|
MQMNAME | メッセージ・キュー・マネージャー名 | 文字値 | 必須、定位置 1 |
text | テキスト '記述' | 文字値、*BLANK | オプション、定位置 2 |
TRGITV | トリガー間隔 | 0-999999999、999999999 | オプショナル, 定位置 3 |
UDLMSGQ | 未配布メッセージ・キュー | 文字値、*NONE | オプショナル, 定位置 4 |
DFTTMQ | デフォルト伝送キュー | 文字値、*NONE | オプショナル, 定位置 5 |
MAXHDL | 最大ハンドル限界 | 0-999999999、256 | オプショナル, 定位置 6 |
MAXUMSG | 最大未コミット・メッセージ | 1-999999999、10000 | オプショナル, 定位置 7 |
DFTQMGR | デフォルト・キュー・マネージャー | *YES、 *NO | オプショナル, 定位置 8 |
MQMLIB | QUEUE MANAGERライブラリー | 名前、 *AUTO | オプショナル, 定位置 9 |
MQMDIRP | データ・ディレクトリー接頭部 | 文字値、*DFT | オプショナル, 定位置 10 |
ASP | ASP番号 | 1-32、 *SYSTEM、*ASPDEV | オプショナル, 定位置 11 |
ASPDEV | ASP装置 | 文字値、*ASP | オプション、定位置 12 |
THRESHOLD | ジャーナル・レシーバーしきい値 | 100000-1000000000、*DFT、*MIN、*MAX | オプション、定位置 13 |
JRNBUFSIZ | ジャーナル・バッファー・サイズ | 32000-15761440、*DFT | オプション、定位置 14 |
メッセージ・キュー・マネージャー名 (MQMNAME)
メッセージ・キュー・マネージャーの名前を指定します。
- キュー・マネージャー名
- キュー・マネージャーの名前を指定します。 名前の長さは48文字までです。 システムが 2 バイト文字セット (DBCS) を使用している場合、最大文字数が少なくなります。
テキスト '記述' (TEXT)
キュー・マネージャーの定義の概略を記述するテキストを指定します。
指定できる値は以下のとおりです。
- *BLANK
- テキストを指定しない。
- description
- 64文字以下の文字を、アポストロフィで囲んで指定します。
注 : フィールド長は 64 バイトであり、システムが 2 バイト文字セット (DBCS) を使用している場合、最大文字数が少なくなります。
トリガー間隔 (TRGITV)
TRGTYPE(*FIRST) が指定されたキューで使用されるトリガー時間間隔 (ミリ秒で表す) を指定します。
キューにメッセージが到着するとトリガー・メッセージが開始キューに書き込まれる場合は、指定されたインターバル内に同一キューに到着するすべてのメッセージによって別のトリガー・メッセージは開始キューに書き込まれません。
指定できる値は以下のとおりです。
- 999999999
- トリガー時間間隔は 999999999 ミリ秒です。
- interval-value
- 0 から 999999999 までの範囲の値をミリ秒で指定します。
未配布メッセージ・キュー (UDLMSGQ)
未配布メッセージに使用されるローカル・キューの名前を指定します。 メッセージが正しい宛先に送られない場合は、メッセージはこのキューに書き込まれます。
指定できる値は以下のとおりです。
- *NONE 値
- 未配布メッセージ・キューはありません。 この属性はブランク・ストリング に設定されます。
- undelivered-message-queue-name
- 未配布メッセージ・キューとして使用されるローカル・キューの名前を指定します。
デフォルト伝送キュー (DFTTMQ)
デフォルト伝送キューとして使用されるローカル伝送キューの名前を指定します。 リモート・キュー・マネージャーに 送信されるメッセージは、その宛先として伝送キューが定義されていない場合デフォルトの伝送キューに書き込まれます。
指定できる値は以下のとおりです。
- *NONE 値
- デフォルトの伝送キューはありません。 この属性はブランク・ストリング に設定されます。
- default-transmission-queue-name
- デフォルト伝送キューとして使用されるローカル伝送キューの名前を指定します。
最大ハンドル限度 (MAXHDL)
任意の 1 つのジョブが同時にオープンできるハンドルの最大数です。
指定できる値は以下のとおりです。
- 256
- オープン・ハンドル数のデフォルトは 256 です。
- maximum-handle-limit
- 0 以上 999999999 以下の範囲の値を指定します。
最大非コミット・メッセージ数 (MAXUMSG)
非コミット・メッセージの最大数を指定します。 具体的には、以下の数を示します。
- 検索可能なメッセージの数
- キューに書き出しできるメッセージの数
- この作業単位内で生成されたトリガー・メッセージの数
これらは、1 つの同期点でのものです。 この限界は、同期点の外で取り出したり書き込まれたりするメッセージには当てはまりません。
指定できる値は以下のとおりです。
- 10000
- デフォルト値は 10000 個のコミットされていないメッセージである。
- maximum-uncommitted-messages
- 1 から 999999999 の範囲内で値を指定する。
デフォルト・キュー・マネージャー (DFTQMGR)
作成されるキュー・マネージャーが、デフォルト・キュー・マネージャーかどうかを指定します。
指定できる値は以下のとおりです。
- *NO
- キュー・マネージャーはデフォルト・キュー・マネージャーになりません。
- *YES
- キュー・マネージャーはデフォルト・キュー・マネージャーになります。
キュー・マネージャー・ライブラリー (MQMLIB)
キュー・マネージャーが使用するライブラリーを指定します。
指定できる値は以下のとおりです。
- *AUTO
- キュー・マネージャーが使用するライブラリーは自動的に選択されます。
- ライブラリー名
- キュー・マネージャーが使用するライブラリーを指定します。
データ・ディレクトリー接頭部 (MQMDIRP)
キュー・マネージャーが使用するデータ・ディレクトリー接頭部を指定します。 キュー・マネージャーは、データ・ファイル (主に、キューに格納されるメッセージ・データ) を保管するためのディレクトリーをここに作成します。
指定できる値は以下のとおりです。
- *DFT
- デフォルトのデータ・ディレクトリー接頭部は '/QIBM/UserData/mqm' です。
- ディレクトリー接頭部
- キュー・マネージャーによって使用されるデータ・ディレクトリー接頭部を指定します。 このディレクトリー接頭部が指す場所は、ローカル・ディスク・プールのファイル・システム、またはネットワーク・ファイル・システム (NFS) のどちらでも可能です。
データ・ディレクトリー接頭部を適切に設定することにより、独立した補助ストレージ・プールにキュー・マネージャー・ディレクトリーを配置できます。 例えば MQMDIRP('/MYASPDEV/QIBM/UserData/mqm/qmgrs') と指定すると、MYASPDEV 装置にキュー・マネージャー・データが保管されます。
ASP および ASPDEV パラメーターを設定することにより、独立した補助ストレージ・プールにキュー・マネージャー・ライブラリー、ジャーナル、およびジャーナル・レシーバーを配置できます。
独立した補助ストレージ・プールをシステム間で切り替えて、キュー・マネージャーの可用性を高くすることができます。 高可用性のためのキュー・マネージャーの構成については、 IBM® MQ の資料を参照してください。
ASP 番号 (ASP)
システムがキュー・マネージャーのライブラリー、ジャーナル、およびジャーナル・レシーバーのための記憶域の割り振りに使用する補助ストレージ・プールを指定します。
このパラメーターで示される補助ストレージ・プールは、統合ファイル・システム (IFS) に格納されるキュー・マネージャー・データ・ファイル用には使用されないことに注意してください。 キュー・マネージャーのデータ・ファイルを特定の補助ストレージ・プールに割り振るには、MQMDIRP パラメーターを参照してください。
指定できる値は以下のとおりです。
- * システム
- システム補助ストレージ・プール (ASP 1) が、キュー・マネージャーのライブラリー、ジャーナル、およびジャーナル・レシーバーのための記憶域を提供します。
- *ASPDEV
- キュー・マネージャーのライブラリー、ジャーナル、およびジャーナル・レシーバーのための記憶域は、ASPDEV パラメーターで指定された 1 次または 2 次 ASP から割り振られます。
- 補助記憶域プール番号
- キュー・マネージャーのライブラリー、ジャーナル、およびジャーナル・レシーバーのための記憶域を提供するシステムまたは基本ユーザー ASP の番号を指定する値 (1 から 32 の範囲内の値) を指定します。
独立した補助ストレージ・プールをシステム間で切り替えて、キュー・マネージャーの可用性を高くすることができます。 高可用性のためのキュー・マネージャーの構成については、 IBM MQ の資料を参照してください。
ASP 装置 (ASPDEV)
キュー・マネージャーのライブラリー、ジャーナル、およびジャーナル・レシーバー用に記憶域が割り振られる補助ストレージ・プール (ASP) の装置名を指定します。
このパラメーターで示される補助ストレージ・プールの装置名は、統合ファイル・システム (IFS) に格納されるキュー・マネージャー・データ・ファイル用には使用されないことに注意してください。 キュー・マネージャーのデータ・ファイルを特定の補助ストレージ・プールに割り振るには、MQMDIRP パラメーターを参照してください。
指定できる値は以下のとおりです。
- *ASP
- キュー・マネージャーのライブラリー、ジャーナル、およびジャーナル・レシーバーのための記憶域は、ASP パラメーターで指定されたシステムまたは基本ユーザー ASP から割り振られます。
- 装置名
- 1 次または 2 次 ASP 装置の名前を指定します。 キュー・マネージャーのライブラリー、ジャーナル、およびジャーナル・レシーバーのための記憶域は、1 次または 2 次 ASP から割り振られます。 (ASP 装置をオンに変更することで) 1 次または 2 次 ASP が既にアクティブ化され、使用可能な状態でなければなりません。
独立した補助ストレージ・プールをシステム間で切り替えて、キュー・マネージャーの可用性を高くすることができます。 高可用性のためのキュー・マネージャーの構成については、 IBM MQ の資料を参照してください。
ジャーナル・レシーバーしきい値 (THRESHOLD)
キュー・マネージャーのジャーナル・レシーバーのしきい値をキロバイトで指定します。
指定できる値は以下のとおりです。
- *DFT
- デフォルトしきい値の 100000 KB を使用します。
- threshold-value
- 記憶域のキロバイト (KB) を示す値を 100000 から 1000000000 の範囲内で指定します。 各 1000 KB は 1024000 バイトの記憶スペースを指定します。 ジャーナル・レシーバー用のスペースのサイズがこの値で指定されたサイズを超えると、識別されたメッセージ・キュー (該当する場合) にメッセージが送られ、ジャーナリングが続行されます。
ジャーナル・バッファー・サイズ (JRNBUFSIZ)
ジャーナル・バッファー・サイズをバイト数で指定します。
指定できる値は以下のとおりです。
- *DFT
- デフォルト・ジャーナル・バッファー・サイズの 32000 バイトを使用します。
- ジャーナル・バッファー・サイズ
- 32000 以上 15761440 以下の範囲の値をバイト数で指定します。