eepcerefer(滞留メッセージのファイル出力)
機能
引き出し禁止状態のサービスの入力キュー(ITQ)に滞留しているメッセージを,指定したファイルに出力して参照できるようにします。
出力対象となるのは,一つのサービスの通常キューまたは優先キューのどちらかのキューに滞留しているすべてのメッセージです。
ファイルへの出力は,TP1/EEプロセスで行います。eepcereferコマンドは,TP1/EEプロセスが出力要求を受け付けた時点で終了します。TP1/EEプロセスは,ファイル出力終了時にKFSB85407-Iメッセージを出力します。
コマンドの形式
eepcerefer -g サービスグループ名
-v サービス名
-p {p|n}
-o 出力ファイル名
〔-r〕
オプションの説明
●-g サービスグループ名
●-v サービス名
●-p {p|n}
●-o 出力ファイル名
滞留メッセージ数×(メッセージ長×5+200)+2000(単位:バイト) |
●-r
出力形式
eepcereferコマンドの出力形式を次の図に示します。
図6-8 eepcereferコマンドの出力形式
変数 | 意味 |
---|---|
aa-aa-aa | コマンドを実行したTP1/EEのバージョン |
bb-bb-bb | コマンドを実行したXTCのバージョン |
cc....cc | サービスグループ名(最大31文字) |
dddddddd | TP1/EEのランID(16進数,8けた) |
ee....ee | サービス名(最大31文字) |
f | キューの種別(1文字)
|
gg....gg | メッセージ通番(10進数,最大10けた) |
hhh | メッセージ種別
|
ll....ll | メッセージ長(10進数,最大10けた) メッセージ長が0の場合は,以降の項目は出力しません。 |
xxxxxxxx | メッセージの先頭からのロケーション(16進数,8けた) |
yyyyyyyy | メッセージの内容(16進数,最大8けた) 1行前に出力した行と同一の場合,次の文字列を出力します。
|
zzzzzzzzzzzzzzzz | メッセージの内容(ASCII文字で最大16文字) 表示できないASCII文字の場合は「.」を出力します。 |
出力メッセージ
メッセージID | 内容 | 出力先 |
---|---|---|
KFSB95301-E | コマンドの形式が不正です。 | 標準エラー出力 |
KFSB95302-E | フラグ引数が不正です。 | 標準エラー出力 |
KFSB95304-E | オプションの組み合わせが不正です。 | 標準エラー出力 |
KFSB95305-E | コマンドが失敗しました。 | 標準エラー出力 |
KFSB95306-E | 領域の確保に失敗しました。 | 標準エラー出力 |
KFSB95307-E | 内部矛盾が発生しました。 | 標準エラー出力 |
KFSB95378-I | ヘルプメッセージ | 標準出力 |
KFSB95379-I | コマンドを受け付けました。 | 標準出力 |
KFSB95380-E | コマンドを受け付けませんでした。 | 標準エラー出力 |
注意事項
eepcereferコマンドに関する注意事項を次に示します。