8.3.18 hrmmkque(受信用共用キューの作成)

<この項の構成>
(1) 形式
(2) 機能
(3) オプション
(4) コマンド引数
(5) 注意事項

(1) 形式

hrmmkque -t shr_receive 〔-l 最大メッセージ長〕
       〔-n 最大メッセージ数〕 〔-c キャッシュメッセージ数〕
       〔-r RDエリア名〕 〔-x 表示名〕
       〔-S システム名〕 キュー名

(2) 機能

指定されたキュー属性で,受信用共用キューを作成します。

(3) オプション

-t shr_receive
作成するキューの種類を指定します。受信用共用キューが指定されます。
-l 最大メッセージ長
 ~<数字>((1000~1048576))《33000》(単位:バイト)
キューに格納するメッセージの最大長(ペイロードの最大長)を指定します。
-n 最大メッセージ数
 ~<数字>((1~65535))《1024》
キューに格納するメッセージの最大数を指定します。
-c キャッシュメッセージ数
 ~<数字>((0~65535))《最大メッセージ数》
キャッシュに格納するメッセージの数を指定します。
指定を省略した場合,-nオプションに指定する最大メッセージ数が設定されます。0を指定する場合,キャッシュにメッセージは格納されません。
このオプションに大きな値を指定する場合,メモリを消費しますがメッセージ受信の性能が向上します。小さい値を指定する場合,メモリの消費は抑えられますが,DBアクセス回数が増えることによってメッセージ受信の性能が低下します。
-r RDエリア名
 ~<1~30文字の識別子および空白>
次に示す管理情報テーブルを格納するRDエリアの名前を指定します。
  • 共用キュー受信用メッセージ情報テーブル
  • 共用キュー受信用ライト管理テーブル
  • 共用キュー受信用リード管理テーブル
このオプションを指定する場合,これらの管理情報テーブルを格納するRDエリアをあらかじめ用意してください。また,これらの管理情報テーブルは,受信用共用キューごとに同じRDエリアに格納する必要があります。HiRDBのRDエリアの作成については,マニュアル「HiRDB コマンドリファレンス」を参照してください。
このオプションを省略する場合,格納するRDエリアをHiRDBが決定します。HiRDBが決定するRDエリアについては,マニュアル「HiRDB SQLリファレンス」を参照してください。
注意
  • RDエリア名に空白を含む場合は,次のように指定してください。
    Windowsの場合
    引用符(")で囲んでください。
    UNIXの場合
    アポストロフィ(’)で囲み,さらにその外側を引用符(")で囲んでください。
  • RDエリア名は大文字と小文字が区別されます。
-x 表示名
 ~<1~64文字の英数字および_(アンダースコア)>
キューの表示名を指定します。表示名とは,アプリケーションがJNDIネーミングサービスからキューを取得するときの,キューの論理名のことです。
指定を省略した場合はコマンド引数で指定したキュー名と同じ名称を指定したものとみなされます。
指定した表示名と同じ名称を持つキューがすでに存在している場合,エラーとなります。詳細は「(5) 注意事項」を参照してください。
-S システム名
 ~<先頭が英字の1~3文字の大文字英字または数字>
コマンドの操作対象となるシステム名(RMSystemNameプロパティ指定値)を指定します。
指定を省略した場合は,HRM_SYSTEM_NAME環境変数に指定したシステム名が設定されます。HRM_SYSTEM_NAME環境変数にもシステム名が指定されていないときはエラーが発生します。

(4) コマンド引数

キュー名
 ~<1~20文字の識別子>
作成するキューの名前を指定します。
既存のキューの名前を指定した場合はエラーが発生します。
TP1/EEとシステム間連携をする場合は1~19文字のキュー名を指定してください。キュー名が20文字の場合はTP1/EEとシステム間連携ができません。

(5) 注意事項