jnlcopy
形式
jnlcopy 〔-t〔開始〕〔,終了〕〔-j レコード種別〔レコード種別〕…〕 〔-o ジャーナル取得モード〔ジャーナル取得モード〕…〕 〔アンロードジャーナルファイル名 〔△アンロードジャーナルファイル名〕…〕〕
機能
指定したアンロードジャーナルファイル内の情報を,標準出力に出力します。
マルチノード機能を使用している場合,jnlcopyコマンドは使用できません。
オプション
●-t 〔開始〕〔,終了〕
複写範囲をジャーナルブロック出力時刻で指定します。
開始には,複写を開始する時刻を指定します。終了には,複写を終了する時刻を指定します。
開始は,1970年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。
開始,または終了のどちらか一方を必ず指定してください。開始の指定を省略すると,アンロードジャーナルファイルの先頭から指定した終了時刻までが複写範囲になります。終了の指定を省略すると,指定した開始時刻からアンロードジャーナルファイルの最後までが複写範囲になります。
開始,および終了は,「hhmmss〔MMDD〔YYYY〕〕」の形式で指定します。
- hh:時(00≦hh≦23)
-
指定を省略できません。
- mm:分(00≦mm≦59)
-
指定を省略できません。
- ss:秒(00≦ss≦59)
-
指定を省略できません。
- MM:月(01≦MM≦12)
-
指定を省略できます。※
- DD:日(01≦DD≦31)
-
指定を省略できます。※
- YYYY:年(1970からの西暦を4けたで指定します)
-
指定を省略できます。※
- 注※
-
開始,または終了の「年」の指定を省略した場合は,当年の指定月日時刻と見なされます。「年,月,日」の指定を省略した場合,当年当月当日の指定時刻と見なされます。「月,日」,「月」,または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は,「年」,「月」,「日」のすべてを省略してください。
-tオプションの指定を省略すると,指定したファイル内のすべての情報を編集出力します。
●-j レコード種別
複写する内容をジャーナルレコード種別で指定します。
複数のレコード種別を指定できます。
レコード種別の指定値と内容を次に示します。
レコード種別 |
指定値 |
内容 |
備考 |
---|---|---|---|
PJ |
p |
トランザクションのコミット処理開始情報 |
同期点ジャーナル |
HJ |
h |
トランザクションの仮同期点情報 |
|
BJ |
b |
トランザクションのロールバック情報 |
|
TJ |
t |
トランザクションの同期点処理終了情報 |
|
DJ |
d |
ヒューリスティック決定情報 |
|
FJ |
f |
DAMファイルの更新情報 |
回復用ジャーナル |
CJ |
c |
回復対象テーブルの更新情報 |
|
XJ |
x |
システムサービス固有回復情報 |
|
SJ |
s |
システム統計情報 |
統計用ジャーナル |
AJ |
a |
送信完了情報 |
|
IJ |
i |
入力キュー登録メッセージ |
|
OJ |
o |
出力キュー登録メッセージ |
|
MJ |
m |
メッセージジャーナル |
|
GJ |
g |
receive情報 |
|
UJ |
u |
ユーザ任意の情報 |
ユーザジャーナル |
-tオプションを指定し,-jオプションの指定を省略すると,指定した範囲内のすべてのジャーナルレコードが複写されます。
-tオプションの指定を省略し,-jオプションを指定すると,指定したレコード種別と同じジャーナルレコード種別のアンロードジャーナルファイルがすべて複写されます。
-t,および-jオプションの指定を省略すると,アンロードジャーナルファイル内のすべての情報が出力されます。
●-o ジャーナル取得モード
ジャーナルの取得モードを指定します。複数のジャーナル取得モードを指定できます。
- c
-
トランザクションテストモードでコミット属性のジャーナル,またはMCFのトランザクション外テストモードのジャーナルを複写します。
- r
-
トランザクションテストモードでロールバック属性のジャーナルを複写します。
- s
-
オンラインテストモード以外のジャーナルを複写します。
このオプションの指定を省略すると,すべてのジャーナル取得モードのジャーナルが複写されます。
コマンド引数
●アンロードジャーナルファイル名 〜〈パス名〉
アンロードジャーナルファイルの名称を指定します。
複数のアンロードジャーナルファイルを指定するときは,アンロードジャーナルファイル名とアンロードジャーナルファイル名との間を空白で区切ります。指定できるファイル数は256個までです。
このコマンド引数の指定を省略すると,標準入力と見なされます。
出力メッセージ
メッセージID |
内容 |
出力先 |
---|---|---|
KFCA02600-E |
アンロードジャーナルファイルのアクセスでエラーが発生しました |
標準エラー出力 |
KFCA02601-E |
アンロードジャーナルファイルが不正です |
標準エラー出力 |
KFCA02602-E |
ジャーナルブロックが不正です |
標準エラー出力 |
KFCA02603-E |
ジャーナルレコードが不正です |
標準エラー出力 |
KFCA02604-E |
メモリが確保できません |
標準エラー出力 |
KFCA02620-W |
対象レコードが存在しません |
標準エラー出力 |
KFCA02630-I |
ヘルプメッセージ |
標準エラー出力 |
KFCA02631-E |
jnlcopyコマンドのパラメタ不正,または制限値オーバです |
標準エラー出力 |
KFCA02632-E |
jnlcopyコマンドのオプションの組み合わせが不当です |
標準エラー出力 |
KFCA02633-E |
jnlcopyコマンドのオプションの指定に誤りがあります |
標準エラー出力 |
KFCA02634-E |
jnlcopyコマンドのファイル名の指定に誤りがあります |
標準エラー出力 |
注意事項
-
複写範囲を指定する場合,開始時刻,または終了時刻と一致するジャーナルレコードがないときは,開始時刻と終了時刻の間にあるジャーナルレコードが複写対象になります。
-
複写対象のジャーナルレコードがない場合,エラーメッセージを出力して処理を終了します。
-
開始時刻が終了時刻より遅くなるように複写範囲を指定するときは,必ず「月」「日」,または「月」「日」「年(西暦)」を指定して,終了時刻が開始時刻よりあとになるようにしてください。省略するとエラーになります。日付を省略すると,jnlcopyコマンドを入力した年月日と見なすため,複写範囲が該当する年月日以外の日付の場合は,必ず「月」「日」,または「月」「日」「年(西暦)」を指定してください。
-
複数のアンロードジャーナルファイルを指定する場合は,それらのファイルが,同一オンライン中に出力されたアンロードジャーナルファイルで,世代番号が連続していなければなりません。
-
アンロードジャーナルファイル名の指定を省略すると,標準入力からの入力となります。そのため,入力ファイルをパイプ,リダイレクションなどで指定してください。
-
jnlcopyコマンドの出力情報は,ほかの運用コマンドの入力情報となります。そのため,jnlcopyコマンドでは,ファイル,ブロック,レコードの各管理情報も出力します。
-
このコマンドで入力できる文字数はご使用のOSによって変わります。入力文字数が上限値を超えるとエラーになります。
-
指定したファイル数が256個以下の場合でも,1プロセスでオープンできるファイルの最大数を超えるとエラーになります。
使用例
アンロードジャーナルファイルの先頭から,1993年5月29日17時30分0.999999秒までの情報を出力する場合
アンロードジャーナルファイル:sysjnl001,sysjnl002
jnlcopy -t ,17300005291993 /tp1/jnl/sysjnl001 /tp1/jnl/sysjnl002