Cosminexus V9 アプリケーションサーバ Cosminexus Reliable Messaging

[目次][用語][索引][前へ][次へ]

8.3.15 hrmlstrs(通信状態表示)

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

(1) 形式

 
hrmlstrs {-n|-g グループID} 〔-m 通信層グループ内メッセージ通番〕
         〔-e 出力メッセージ数〕〔-S システム名〕 キュー名
 

(2) 機能

メッセージ転送中に通信層のグループの状態やグループ内のメッセージ通信状態を表示します。

(3) オプション

-n
キューに存在する通信層のグループID一覧と送信用/受信用の種別,グループの有効/無効を表示します。

-g グループID
 〜<1〜256文字の文字列>
通信状態を参照するグループのグループIDを指定します。
グループが無効の場合はグループの参照はできません。グループが無効の場合にこのオプションを指定するとエラーが発生します。

-m 通信層グループ内メッセージ通番
 〜<数字>((1〜65535))
出力するメッセージのメッセージ通番を指定します。指定するメッセージ通番の上限値は,指定したキューに定義された最大メッセージ数となります。
指定したメッセージ通番のメッセージが指定したキュー内に存在しない場合はエラーが発生します。-gオプションを指定していて,さらに指定したグループが有効の場合だけ指定できます。-gオプションを指定しない,または指定したグループが無効であった場合,このオプションを指定するとエラーが発生します。

-e 出力メッセージ数
 〜<数字>((1〜100))《1》
メッセージ情報を表示するメッセージ数を指定します。-mオプションで指定したメッセージ通番から,このオプションで指定された出力メッセージ数のメッセージ情報を表示します。指定を省略した場合,1メッセージ情報を表示します。
組み込まれているメッセージ数より大きい値を指定した場合は,組み込まれているメッセージ数までを表示します。
-gと-mオプションを両方指定したときだけ,このオプションは有効です。それ以外の場合はエラーが発生します。

-S システム名
 〜<先頭が英字の1〜3文字の大文字英字または数字>
コマンドの操作対象となるシステム名(RMSystemNameプロパティ指定値)を指定します。
指定を省略した場合は,HRM_SYSTEM_NAME環境変数に指定したシステム名が設定されます。HRM_SYSTEM_NAME環境変数にもシステム名が指定されていないときはエラーが発生します。

(4) コマンド引数

キュー名
 〜<1〜20文字の識別子>
状態を参照するキューの名前を指定します。
指定したキューが存在しない,またはローカルキュー,転送キュー以外のキューを指定した場合はエラーが発生します。

(5) 注意事項

表示されるメッセージ通番は通信層のグループ内の通番です。hrmlsmsgコマンドで表示されるmessage numberと異なります。また,通信層グループ内メッセージ有効期限に到達したメッセージは出力対象になりません。

(6) 出力形式

aa....aa
通信層のグループID(文字列)

bb....bb
グループの種別
次に示すどちらかが表示されます。
  • SEND:送信用グループ
  • RECEIVE:受信用グループ

cc....cc
グループの状態
次に示すどちらかが表示されます。
  • NOT_CLOSED:有効
  • CLOSED:無効

dd....dd
グループの総数(10進数)

ee....ee
QoS(通信品質)の種別
次に示すどちらかが表示されます。
  • EXACTLY_ONCE:配送保証および重複防止
  • IN_ORDER:順序保証

ff....ff (FF....FF)
受信待ち(未受信)シーケンス番号(受信待ちメッセージ総数)(10進数)
受信済みシーケンス番号の最大値未満のシーケンス番号で最大10メッセージが表示されます。

gg....gg (GG....GG)
スキップ済みシーケンス番号(スキップ済みメッセージ総数)(10進数)
受信待ちスキップコマンドでスキップされたシーケンス番号で最大10メッセージが表示されます。

hh....hh
通信層グループ有効期限(文字列)

ii....ii (II....II)
転送中シーケンス番号(転送中メッセージ総数)(10進数)
最大10メッセージが表示されます。

jj....jj
通信層グループ内メッセージ通番(10進数)

kk....kk
通信層グループ内シーケンス番号(10進数)

ll....ll
メッセージ状態
次に示すどちらかが表示されます。
  • NON_DELIVERED:配信待ちまたは転送待ち
  • DELIVERING:転送中
    再起動後の未送信メッセージも含みます。

mm....mm
JMSCorrelationID(文字列)
メッセージ登録時に設定されていない場合,空白が表示されます。

nn....nn
JMSXGroupID(文字列)
メッセージ登録時に設定されていない場合,空白が表示されます。

oo....oo
JMSXGroupSeq(10進数)
メッセージ登録時に設定されていない場合,空白が表示されます。

pp....pp
JMSMessageID(文字列)
メッセージ登録時に設定されていない場合,空白が表示されます。

qq....qq
通信層グループ内メッセージ有効期限(文字列)