jnlrput
名称
アンロードジャーナルファイル,またはグローバルアーカイブアンロードジャーナルファイルのレコード出力
形式
jnlrput 〔-t〔開始〕〔,終了〕〕〔-e〕〔-f〕〔-l〕〔-c キー〕
〔-u トランザクショングローバル識別子
〔,トランザクションブランチ識別子〕〕
〔-o ジャーナル取得モード〔ジャーナル取得モード〕…〕
〔-j レコード種別〔レコード種別〕…〕〔-q _trn〕〔-q _rpc〕
〔-d 任意抽出条件〕〔-x〕〔ファイル名〔△ファイル名〕…〕
機能
指定したアンロードジャーナルファイル,またはグローバルアーカイブアンロードジャーナルファイル内のユーザジャーナルレコードの情報,トランザクションブランチのCPU使用時間情報,およびレスポンス統計情報を標準出力に出力します。
オプション
●-t 〔開始〕〔,終了〕
レコードデータ情報の出力範囲をジャーナル出力時刻で指定します。
開始には,出力を開始する時刻を指定します。終了には,出力を終了する時刻を指定します。
開始は,1970年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。
開始,または終了のどちらか一方を必ず指定してください。開始の指定を省略すると,アンロードジャーナルファイルの先頭から指定した終了時刻までが出力範囲になります。終了の指定を省略すると,指定した開始時刻からアンロードジャーナルファイルの最後までが出力範囲になります。
開始,および終了は,「hhmmss〔MMDD〔YYYY〕〕」の形式で指定します。
-tオプションの指定を省略すると,指定したファイル内のすべてのジャーナルを出力します。
●-e
コミット決着済みのユーザジャーナルレコード(UJ)だけを出力します。
-eオプションの指定を省略すると,すべてのユーザジャーナルレコード(UJ)を出力します。
●-f
最初のファイルから,コミット決着済みのユーザジャーナルレコードを出力します。このとき,ジャーナルファイルの先頭ブロック番号が1から昇順に連番かどうかをチェックします。エラーがあれば処理を終了します。
-fオプションは,-eオプションを指定したときだけ有効です。
-fオプションの指定を省略すると,前回のレコード出力処理からの引き継ぎがあるものとして,引き継ぎファイルの最終ブロック番号+1から昇順に連番であることがチェックされます。エラーがあれば処理を終了します。
●-l
最後のファイルから,コミット決着済みのユーザジャーナルレコードを出力します。その後,引き継ぎファイルを削除します。
-lオプションは,-eオプションを指定したときだけ有効です。
-lオプションの指定を省略すると,次回のレコード出力処理への引き継ぎがあるものとして,引き継ぎファイルを作成します。
●-c キー ~((001~999))《001》
引き継ぎファイルの名称の一部を指定します。実際は,OpenTP1が「jnlrput***」という名称でファイルを作成し,***にはこのオプションで指定した値が設定されて,引き継ぎファイルの名称となります。
●-u トランザクショングローバル識別子〔,トランザクションブランチ識別子〕
~〈33けたの英数字,特殊文字,および16進数字〉
出力するユーザジャーナルレコードをトランザクション識別子で指定します。トランザクション識別子は「トランザクショングローバル識別子,トランザクションブランチ識別子」の形式で指定します。
-uオプションの指定を省略すると,すべてのトランザクション識別子を出力します。
●-o ジャーナル取得モード
ジャーナルの取得モードを指定します。複数のジャーナルの取得モードを指定できます。
-oオプションの指定を省略すると,すべてのジャーナル取得モードのジャーナルを出力します。
●-j レコード種別
出力する内容をレコード種別で指定します。
レコード種別の指定値と内容を次に示します。
レコード種別 | 指定値 | 内容 | 備考 |
---|---|---|---|
SJ | s | システム統計情報※ | 統計用ジャーナル |
AJ | a | 送信完了情報 | |
IJ | i | 入力キュー登録メッセージ | |
OJ | o | 出力キュー登録メッセージ | |
MJ | m | メッセージジャーナル | |
GJ | g | receive情報 | |
UJ | u | ユーザ任意の情報 | ユーザジャーナル |
-jオプションの指定を省略すると,ユーザジャーナル(UJ)だけを出力します。
●-q _trn
指定したファイル内のトランザクションブランチのCPU使用時間情報を出力します。
-qオプションの指定は,-jオプションにs(システム統計情報)を指定したときだけ有効です。
●-q _rpc
指定したファイル内のレスポンス統計情報を出力します。
-qオプションの指定は,-jオプションにs(システム統計情報)を指定したときだけ有効です。
●-d 任意抽出条件
ユーザジャーナルレコード(UJ)を抽出する条件を指定します。
比較データとジャーナルレコードを比較して,比較記号で指定した条件を満たすジャーナルレコードを抽出します。抽出条件は255けた以内で指定します。
抽出条件の記述形式を次に示します。
比較位置,〔比較記号〕,〔比較形式〕,比較データ
〔,比較位置,〔比較記号〕,〔比較形式〕,比較データ〕
●-x
トランザクション外のユーザジャーナルレコード(UJ)だけを出力します。
-xオプションの指定を省略すると,すべてのユーザジャーナルレコード(UJ)を出力します。
コマンド引数
●ファイル名 ~〈パス名〉
アンロードジャーナルファイル,またはグローバルアーカイブアンロードジャーナルファイルの名称を指定します。
マルチノード機能を使用している場合は,jnlsortコマンドでソート,およびマージ(ノードの抽出,ジャーナルサーバランIDの特定)した結果のファイル名を指定してください。
-eオプション指定時は,複数のファイルを指定できます。複数のファイルを指定するときは,ファイル名とファイル名との間を空白で区切ります。指定できるファイル数は256個までです。
このコマンド引数の指定を省略すると,標準入力と見なされます。
指定できるオプションとコマンド引数の組み合わせを次に示します。
出力形式
UJを出力した場合のジャーナルレコード全体の出力形式を次に示します。
各情報の詳細な出力形式を次に示します。
出力メッセージ
メッセージID | 内容 | 出力先 |
---|---|---|
KFCA02600-E | アンロードジャーナルファイルのアクセスでエラーが発生しました | 標準エラー出力 |
KFCA02601-E | アンロードジャーナルファイルが不正です | 標準エラー出力 |
KFCA02602-E | ジャーナルブロックが不正です | 標準エラー出力 |
KFCA02603-E | ジャーナルレコードが不正です | 標準エラー出力 |
KFCA02604-E | メモリが確保できません | 標準エラー出力 |
KFCA02605-E | 引き継ぎファイルのアクセスでエラーが発生しました | 標準エラー出力 |
KFCA02606-E | 引き継ぎファイルが不正です | 標準エラー出力 |
KFCA02607-E | 引き継ぎファイルとアンロードジャーナルファイルの関係が不正です | 標準エラー出力 |
KFCA02622-W | 出力する対象レコードが存在しません | 標準エラー出力 |
KFCA02680-I | ヘルプメッセージ | 標準出力,標準エラー出力 |
KFCA02681-E | jnlrputコマンドのパラメタ不正,または制限値オーバです | 標準エラー出力 |
KFCA02682-E | jnlrputコマンドのオプションの組み合わせが不当です | 標準エラー出力 |
KFCA02683-E | jnlrputコマンドのオプションの指定に誤りがあります | 標準エラー出力 |
KFCA02684-E | jnlrputコマンドのファイル名の指定に誤りがあります | 標準エラー出力 |
KFCA02685-E | jnlrputコマンドで抽出対象レコードが不正です | 標準エラー出力 |
注意事項
使用例
jnlrput -j s -q _trn /tp1/jnl/sysjnl001
jnlrput -e -f -l /tp1/jnl/sysjnl001 /tp1/jnl/sysjnl002 /tp1/jnl/sysjnl003
<1回目>
jnlrput -e -f /tp1/jnl/sysjnl001 /tp1/jnl/sysjnl002
<2回目>
jnlrput -e /tp1/jnl/sysjnl003
<3回目>
jnlrput -e -l /tp1/jnl/sysjnl004
jnlrput -t 00000001012003,23595912312003 -j s /tp1/jnl/sysjnl001