8.3.27　hrmstopque（キューの抑止）

(1)　形式

永続版リソースアダプタの場合

hrmstopque -y {ap_send｜ap_receive｜trs_send｜trs_receive｜ap_all｜all}
          〔-S　システム名〕 キュー名

非永続版リソースアダプタの場合

hrmstopque -y {ap_send｜ap_receive｜ap_all｜all}
          〔-S　システム名〕 キュー名

ページの先頭へ

(2)　機能

キューのメッセージの送受信を抑止します。

非永続版リソースアダプタの場合，ローカルキューの抑止だけができます。

ページの先頭へ

(3)　オプション

• 永続版リソースアダプタの場合

-y {ap_send｜ap_receive｜trs_send｜trs_receive｜ap_all｜all}

抑止形態を指定します。

• ap_send：メッセージの送信抑止

• ap_receive：メッセージの受信抑止

• trs_send：キュー間転送メッセージの送信抑止

• trs_receive：キュー間転送メッセージの受信抑止

• ap_all：メッセージの送受信抑止

• all：指定するキューの種類に応じて，抑止できる形態をすべて抑止

• 非永続版リソースアダプタの場合

-y {ap_send｜ap_receive｜ap_all｜all}

抑止形態を指定します。

• ap_send：メッセージの送信抑止

• ap_receive：メッセージの受信抑止

• ap_all：メッセージの送受信抑止

• all：ap_allと同じ意味になります

キューの種類によって，指定できる抑止形態が異なります。キューと抑止形態との対応を次の表に示します。

表8‒4　キューと抑止できる形態

抑止形態	ローカルキュー		転送キュー	送信用共用キュー	受信用共用キュー※1	デッドメッセージキュー
	永続版	非永続版
ap_send	○	○	○	×	○	×
ap_receive	○	○	×	×	○	○
trs_send	×	×	○	×	×	×
trs_receive	○	×	×	×	×	×
ap_all	○	○	×	×	○	×
all	○	○※2	○	×	○	○

-S システム名

　〜＜先頭が英字の1〜3文字の大文字英字または数字＞

コマンドの操作対象となるシステム名（RMSystemNameプロパティ指定値）を指定します。

指定を省略した場合は，HRM_SYSTEM_NAME環境変数に指定したシステム名が設定されます。HRM_SYSTEM_NAME環境変数にもシステム名が指定されていないときはエラーが発生します。

ページの先頭へ

(4)　コマンド引数

キュー名

　〜＜1〜20文字の識別子＞

メッセージを抑止するキューの名前を指定します。

• 永続版リソースアダプタの場合

  指定したキューが存在しない，または送信用共用キューを指定した場合はエラーが発生します。

• 非永続版リソースアダプタの場合

  指定したキューが存在しない場合はエラーが発生します。

ページの先頭へ

(5)　注意事項

• Reliable Messagingの実行状態でこのコマンドを実行した場合，該当のキューに対してのメッセージ送信または受信のトランザクションがすでに存在していたとき，そのトランザクションは有効となります。

• 永続版リソースアダプタの場合

  デッドメッセージキューへのメッセージの移動は抑止されません。

• 非永続版リソースアダプタの場合

  Reliable Messagingを再起動したときは，抑止状態は引き継がれません。再起動後は抑止が解除されます。

ページの先頭へ