[IBM i]

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 以下の範囲の値をバイト数で指定します。