MQAサービス定義

TP1/Message Queueの定義のうち,MQAサービス定義について説明します。

概要

MQAサービス定義は,OpenTP1のシステムサービス定義の一つです。

MQAサービス定義の定義ファイルは,OSのテキストエディタを使用して,テキストファイルとして作成します。MQAサービス定義の定義ファイル名(完全パス名)を次に示します。

$DCCONFPATH/mqa

機能

キューを管理するための実行環境を定義します。

種類

MQAサービス定義の種類について,次の表に示します。

表4-3 MQAサービス定義の種類

形式オプション定義内容指定値
set watch_timeなし最大応答待ち時間<符号なし整数>
((0~65535))(単位:秒)
set mqa_channel_inf_file_name_aなしMQTサーバ用チャネル管理情報格納A系ファイルパス名<1~80バイトの文字列>または<1~63バイトの文字列>
set mqa_channel_inf_file_name_bなしMQTサーバ用チャネル管理情報格納B系ファイルパス名<1~80バイトの文字列>または<1~63バイトの文字列>
set mqa_channel_inf_fileなしMQTサーバ用チャネル管理情報格納ファイル入出力形式《normal》|tp1file
set mqa_max_quenumなしオンライン中に使用するキューの最大数<符号なし整数>
((2~20480))
《4096》
set mqa_max_grpnumなしオンライン中に使用するキューファイルグループの最大数<符号なし整数>
((1~4095))
《16》
set mqa_max_msg_recnumなし1メッセージの最大レコード数<符号なし整数>
((1~65535))
《32》
set mqa_max_filnumなしオンライン中に使用するキューファイルの最大数<符号なし整数>
((1~4095))《16》
set mqa_ioproc_numなし入出力プロセス起動数<符号なし整数>
((1~64))《1》
set mqa_expiryなしメッセージ保持時間機能を使用するかどうかY|《N》
set mqa_maxque_expiryなしメッセージ保持時間対象サーチキュー数<符号なし整数>
((1~20480))《3》
set mqa_maxmsg_expiryなしメッセージ保持時間対象削除メッセージ数<符号なし整数>
((1~65535))《3》
set mqa_quefil_infなしキュー/キューファイルのしきい値,および回復値に達した場合に,メッセージを出力するかどうかY|《N》
set mqa_mqr_confなしクラスタ機能使用の要否Y|《N》
set mqa_local_ccsidなしキューマネジャの文字セット識別子<符号なし整数>
((1~65535))《850》
set mqa_jnl_confなしジャーナルへのメッセージデータ取得の要否Y|《N》
set mqa_mqc_confなしMQCサーバ機能の要否Y|《N》
set mqa_mqc_clientnumなしオンライン中に同時に処理できるクライアントの最大数<符号なし整数>
((1~256))《16》
set mqa_mqc_trnnumなしオンライン中に同時に処理できるトランザクションの最大数<符号なし整数>
((0~256))《0》
set mqa_mqo_confなしMessage Queue - Operation - Agentの要否Y|《N》
set mqa_mqo_queuefile_alarm_levelなしキューファイル登録メッセージサイズしきい値<符号なし整数>
((10~100))《80》
(単位:%)
set mqa_mqo_queuefile_recover_levelなしキューファイル登録メッセージサイズ回復値<符号なし整数>
((10~100))《70》
(単位:%)
set mqa_mqo_queue_alarm_levelなしキュー登録メッセージ数しきい値<符号なし整数>
((10~100))《80》
(単位:%)
set mqa_mqo_queue_recover_levelなしキュー登録メッセージ数回復値<符号なし整数>
((10~100))《70》
(単位:%)
set mqa_msg_stay_timeなしメッセージ滞留時間<符号なし整数>
((0~2147483647))《0》
(単位:秒)
set max_socket_descriptorsなしソケット用ファイル記述子の最大数<符号なし整数>
Linux以外の場合((32~2032))《514》
Linuxの場合((32~1008))《64》
set mqa_pool_attriなしMQAサービス専用共用メモリをメモリプールに固定するかどうか《free》|fixed
set mqa_extend_rmshm_sizeなしMQAサービス専用共用メモリの拡張領域サイズ<符号なし整数>
((0~2000000000))《0》
(単位:バイト)
set mqa_getwait_timeoutなしMQGMO_WAIT指定時のMQGET命令の待ち合わせ最大時間精度《low》|high
set mqa_filerr_continueなし入出力エラーが発生した場合にオンラインを継続させるかどうか《Y》|N
set mqa_prf_trace_levelなし性能検証用トレース情報取得レベル<16進数字>
((00000000~00000001))《00000000》
mqaquegrp
(キューファイルグループの構成定義)
指定数:1以上
-gキューファイルグループ名<1~31文字の識別子>
-bバックアップキューファイル名<1~59文字の文字列>
-n入出力バッファ数<符号なし整数>
((0~1048560))《640》
-mメッセージエントリ確保率<符号なし整数>
((0~100))《0》
-kキューファイルグループ監視の要否Y|《N》
-uキューファイルグループ登録メッセージサイズしきい値<符号なし整数>
((10~100))《80》
(単位:%)
-lキューファイルグループ登録メッセージサイズ回復値<符号なし整数>
((10~100))《70》
(単位:%)
-sMQAサービス専用共用メモリ確保要求者識別子<16進数字>
((00~ff))
なしキューファイル名<1~59文字の文字列>
mqaqueatl
(モデルキューの属性定義)
指定数:0以上
-qキュー記述子<1~64文字の文字列>
-g取り出し許可《allowed》|inhibited
-p登録許可《allowed》|inhibited
-y省略時のメッセージ優先度<符号なし整数>
((0~9))《0》
-e省略時のメッセージ永続性《persistent》|
notpersistent
-aプロセス名<1~48文字のMQ文字列>
-d最大メッセージ登録数<符号なし整数>
((0~2147483647))《128》
-l最大メッセージ長<符号なし整数>
((0~128000000))《4096000》
-s共用性shareble|《notshareble》
-o省略時の取り出しオプション《exclusive》|shared
-mメッセージ配布順序priority|《fifo》
-rキュー保持時間<符号なし整数>
((0~65535))《8》
(単位:時間)
-k定義タイプ《permanent》|temporary
-u使用種別《normal》|transmission
-iイニシエーションキュー名<1~48文字のMQ文字列>
-cトリガ制御off|《on》
-tトリガタイプ《every》|first|
depth|none
-bトリガのためのメッセージ優先度の下限値<符号なし整数>
((0~9))《0》
-nトリガのためのメッセージ登録数の下限値<符号なし整数>
((1~65535))《1》
-fトリガデータ<1~64文字の文字列>
-j配布リストのサポートsupport|《nosupport》
-wデフォルトのバインディング《fixed》|not_fixed
-vメッセージ滞留時間監視の要否《off》|on
なしモデルキューの定義名<1~48文字のMQ文字列>
なしキューファイル名<1~59文字の文字列>
mqaremque
(リモートキューのローカル定義)
指定数:0以上
-qキュー記述子<1~64文字の文字列>
-p登録許可《allowed》|inhibited
-y省略時のメッセージ優先度<符号なし整数>
((0~9))《0》
-e省略時のメッセージ永続性《persistent》|notpersistent
-rリモートキュー名<1~48文字のMQ文字列>
-wデフォルトのバインディング《fixed》|not_fixed
-cクラスタ内共用クラスタ名称<1~48文字のMQ文字列>
-mリモートキューマネジャ名<1~48文字のMQ文字列>
-x転送キュー名<1~48文字のMQ文字列>
なしリモートキューのローカル定義名<1~48文字のMQ文字列>
mqaalsque
(別名キューの属性定義)
指定数:0以上
-qキュー記述子<1~64文字の文字列>
-g取り出し許可《allowed》|inhibited
-p登録許可《allowed》|inhibited
-y省略時のメッセージ優先度<符号なし整数>
((0~9))《0》
-e省略時のメッセージ永続性《persistent》|notpersistent
-wデフォルトのバインディング《fixed》|not_fixed
-cクラスタ内共用クラスタ名称<1~48文字のMQ文字列>
なし別名キュー名<1~48文字のMQ文字列>
なしベースキュー名<1~48文字のMQ文字列>
mqaprcdef
(プロセス定義)
指定数:0以上
-pプロセス記述子<1~64文字の文字列>
-tアプリケーションタイプ<符号なし整数>
((15,または65536~999999999))《15》
-iアプリケーション記述子<1~256文字の文字列>
-e環境データ<1~128文字の文字列>
-uユーザデータ<1~128文字の文字列>
なしプロセス名<1~48文字のMQ文字列>
mqaquemgr
(キューマネジャ定義)
指定数:1
-nキューマネジャ名<1~48文字のMQ文字列>
-qキューマネジャ記述子<1~64文字の文字列>
-tトリガ間隔<符号なし整数>
((0~999999999))《999999999》
(単位:ミリ秒)
-dデッドレターキュー名<1~48文字のMQ文字列>
-p最大メッセージ優先度<符号なし整数>
((0~9))《9》
-x省略時の転送キュー名<1~48文字のMQ文字列>
-h最大ハンドル数<符号なし整数>
((1~65535))《10》
-l最大メッセージ長<符号なし整数>
((1~128000000))《4096000》
-sトランザクション有効性《sync》|nosync
-j配布リストのサポートsupport|《nosupport》
mqamqtnam
(MQTデーモン構成定義)
指定数:0以上
-b総バッチメッセージ数<符号なし整数>
((1~2549745))《255》
なしMQTサーバ名またはMQCリスナサーバ名<_(アンダスコア)で始まる2~8文字の識別子>
なしプロトコル名称<1~14文字の識別子>
なしMCA数<符号なし整数>((1~255))
注※
これらの定義コマンドの指定数(mqaquegrp定義コマンドの場合,キューグループ内のキューの数)の合計は,TP1/Message Queueの動的キューの数と合わせて,20480以内にしてください。

 

注意
  • 各定義コマンドの指定数は,MQAサーバを開始するために必要な値を表します。
  • MQAサービス定義に指定できるMQCリスナサーバの構成定義(mqamqtnam定義コマンド)の数は一つだけです。複数を指定した場合は,MQAサービス開始時にKFCA31183-Eメッセージを出力して異常終了します。