jnledit

〈このページの構成〉

名称
形式
機能
オプション
コマンド引数
出力形式
出力メッセージ
注意事項
使用例

名称

アンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルの編集出力

形式

jnledit 〔-e 編集種別〕〔-t〔開始〕〔,終了〕〕
        〔-j レコード種別〔レコード種別〕…〕〔-s サーバ名〕
        〔-v サービス名〕
        〔-u トランザクショングローバル識別子
                               〔,トランザクションブランチ識別子〕〕
        〔-o ジャーナル取得モード〔ジャーナル取得モード〕…〕
        〔-m 論理端末名称〔，論理端末名称〕…〕
        〔-w けた〕〔-l 行〕〔-c〕
        〔ファイル名〔△ファイル名〕…〕

ページの先頭へ

機能

指定したアンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイル内の情報を編集し，標準出力へ出力します。

ページの先頭へ

オプション

●-e　編集種別　　〜《f》

編集種別を指定します。

　r：レコード単位で編集します。

　b：ブロック単位で編集します。

　f：ファイル情報一覧を出力します。

●-t　〔開始〕〔，終了〕

編集範囲を指定します。開始には，編集出力を開始する時刻を指定します。終了には，編集出力を終了する時刻を指定します。

-eオプションでrを指定した場合は，ジャーナルレコードを出力する時刻で指定します。-eオプションでbを指定した場合は，ジャーナルブロックを出力する時刻を指定します。

開始は，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	ユーザ任意の情報	ユーザジャーナル

-jオプションの指定を省略すると，すべてのジャーナルレコード種別が編集対象になります。

●-s　サーバ名　　〜〈1〜8文字の英数字〉

編集する内容をサーバ名で指定します。

このオプションは，レコード種別がcの場合に有効になります。指定されたサーバ名に一致するCJが編集対象ですが，そのCJにトランザクション識別子が設定されていれば，その情報を基に同じトランザクション識別子を持つ別の種別のレコードもさらに編集対象となります。トランザクション識別子で別のレコードも編集出力したい場合には，-jオプションで，対象とするレコード種別をあわせて指定します。

-sオプションの指定を省略すると，すべてのサーバが編集対象になります。

●-v　サービス名　　〜〈1〜31文字の英数字〉

編集する内容をサービス名で指定します。

このオプションは，レコード種別がcの場合に有効になります。指定されたサービス名に一致するCJが編集対象ですが，そのCJにトランザクション識別子が設定されていれば，その情報を基に同じトランザクション識別子を持つ別の種別のレコードもさらに編集対象となります。トランザクション識別子で別のレコードも編集出力したい場合には，-jオプションで，対象とするレコード種別をあわせて指定します。

-vオプションの指定を省略すると，すべてのサービスが編集対象になります。

●-u　トランザクショングローバル識別子〔，トランザクションブランチ識別子〕

〜〈33けたの英数字，特殊文字，および16進数字〉

編集する内容をトランザクション識別子で指定します。トランザクション識別子は「トランザクショングローバル識別子，トランザクションブランチ識別子」の形式で指定します。

-uオプションの指定を省略すると，すべてのトランザクション識別子を編集出力します。

●-o　ジャーナル取得モード

ジャーナルの取得モードを指定します。複数のジャーナル取得モードを指定できます。

c: トランザクションテストモードでコミット属性のジャーナル，またはMCFのトランザクション外テストモードのジャーナルを編集出力します。
r: トランザクションテストモードでロールバック属性のジャーナルを編集出力します。
s: オンラインテストモード以外のジャーナルを編集出力します。

-oオプションの指定を省略すると，すべてのジャーナル取得モードのジャーナルを編集出力します。

●-m　論理端末名称　　〜〈16けた以内の英数字〉

編集出力する論理端末名を指定します。このオプションは，レコード種別がa，g，i，m，oの場合に有効になります。

-mオプションを省略すると，すべての論理端末を編集出力します。

●-w　けた　　〜〈符号なし整数〉((80〜132))《80》

1行の出力けた数を指定します。

●-l　行　　〜〈符号なし整数〉((12〜256))《24》

1ページの出力行数を指定します。

●-c

16進数，および文字形式で編集します。

-cオプションの指定を省略すると，16進数だけで編集します。

ページの先頭へ

コマンド引数

●ファイル名　　〜〈パス名〉

アンロードジャーナルファイル，またはグローバルアーカイブアンロードジャーナルファイルの名称を指定します。

-eオプションでfを指定した場合だけ，複数のファイル名を指定できます。複数のファイル名を指定するときは，ファイル名とファイル名との間を空白で区切ります。指定できるファイル数は256個までです。

このコマンド引数の指定を省略すると，標準入力と見なされます。

指定できるオプションとコマンド引数の組み合わせを次に示します。

[図データ]

（凡例）

○：指定できます。

△：指定できますが，編集対象とならない場合があります。レコード種別やジャーナルの内容によっては，ジャーナルに該当情報を持たないものがあります。

×：指定できません。

−：無効です。

ページの先頭へ

出力形式

●-cオプションを指定した場合

[図データ]

注※1: レコード種別がAJ，IJ，OJ，MJ，GJの場合は，ジャーナル取得時刻（MCFジャーナルバッファに書き出した時刻）を表示します。
注※2: トランザクションを開始するCJの場合に表示します。

1：指定したレコードの数だけ繰り返し表示されます。
aa...aa：指定したファイルの名称（59文字以内）
bbb：ファイル種別
- sys…システムジャーナルファイル
- jar…グローバルアーカイブアンロードジャーナルファイル
cc...cc：ファイルの作成日時
dddddddd：ブロック番号（16進数字8けた）
eeeeeeee：レコード番号（16進数字8けた）
ff...ff：レコード単位に編集したときの日時

年−月−日時：分：秒. マイクロ秒（マイクロ秒は0〜999999の10進数）の形式で出力します。ただし，TP1/Server Base 06-01より前のバージョンのジャーナルを編集した場合，マイクロ秒の値は0が出力されます。
gg：レコード種別（英字2文字）
h：レコードタイプ（英数字1文字）
ii...ii：ジャーナル取得モード（英字13文字以内）
jj...jj：トランザクショングローバル識別子（英数字と特殊文字で8文字と16進数字8けた）
kk...kk：トランザクションブランチ識別子（英数字と特殊文字で8文字と16進数字8けた）
ll...ll：ジャーナルレコードの16進数表示部

直前の行とデータが同じ場合は，「<<same data>>」を表示します。

ジャーナルレコードが管理情報だけの場合は，タイトルだけ出力します。
oo...oo：ジャーナルレコードのASCII文字表示部

変換不能文字は「.」で表示します。
pppp：ジャーナルレコード先頭からのオフセット（16進数字4けた）

表示できるけた数は4けたです。したがって，ジャーナルレコード長が0xFFFFを超える場合は，16進数字の下4けただけを表示します。
mm...mm：MCFレコードの作成日時

メッセージ制御機能でジャーナルレコードを作成した日時を出力します。

年−月−日時：分：秒. マイクロ秒（マイクロ秒は0〜999999の10進数）の形式で出力します。
nn...nn：トランザクションブランチ開始日時

年−月−日時：分：秒. マイクロ秒（マイクロ秒は0〜999999の10進数）の形式で出力します。
vv−rr：バージョン番号−リビジョン番号
yyyy：ページ

●「jnledit -e f」の場合

[図データ]

注※1: ファイル種別がjarの場合は，先頭ブロック番号，および先頭レコード番号に'0x********'を表示します。
注※2: 各世代最終情報が無効，または設定されていない場合は，各世代最終情報の各項目に'*...*'を表示します。

1：指定したファイルの数だけ表示されます。
2：指定したファイルがグローバルアーカイブアンロードジャーナルファイルの場合に表示されます。
3：指定したファイルが，jnlunlfgコマンドに-tオプションを指定して取得したファイルの場合に表示されます。
aa...aa：指定したファイルの名称（59文字以内）
bb...bb：ファイルの作成日時
ccc：ジャーナルファイル種別
- sys…システムジャーナルファイル
- jar…グローバルアーカイブアンロードジャーナルファイル
dd...dd：ノード識別子
eeeeeeee：ジャーナルサーバのランID（16進数字8けた。先頭に0xを表示）
ff....ff：使用開始日時
gggggggg：先頭世代番号（16進数字8けた。先頭に0xを表示）
hhhhhhhh：最終世代番号（16進数字8けた。先頭に0xを表示）
iiiiiiii：先頭ブロック番号（16進数字8けた。先頭に0xを表示）
jjjjjjjj：先頭レコード番号（16進数字8けた。先頭に0xを表示）
kkkkkkkk：リソース名称（英数字8文字以内）
llllllll：ファイルの世代番号（16進数字8けた。先頭に0xを表示）
mmmmmmmm：ブロック番号（16進数字8けた。先頭に0xを表示）
nn...nn：サーバ側のジャーナルデータ取得日時
oo...oo：jnlunlfgコマンドの-tオプションで指定した開始日時（省略時は'*...*'を表示）
pp...pp：jnlunlfgコマンドの-tオプションで指定した終了日時（省略時は'*...*'を表示）
vv−rr：バージョン番号−リビジョン番号
yyyy：ページ

ページの先頭へ

出力メッセージ

メッセージID	内容	出力先
KFCA02600-E	アンロードジャーナルファイルのアクセスでエラーが発生しました	標準エラー出力
KFCA02601-E	アンロードジャーナルファイルが不正です	標準エラー出力
KFCA02602-E	ジャーナルブロックが不正です	標準エラー出力
KFCA02603-E	ジャーナルレコードが不正です	標準エラー出力
KFCA02604-E	メモリが確保できません	標準エラー出力
KFCA02640-I	ヘルプメッセージ	標準出力，標準エラー出力
KFCA02641-E	jnleditコマンドのパラメタ不正，または制限値オーバです	標準エラー出力
KFCA02642-E	jnleditコマンドのオプションの組み合わせが不当です	標準エラー出力
KFCA02643-E	jnleditコマンドのオプションの指定に誤りがあります	標準エラー出力
KFCA02644-E	jnleditコマンドのファイル名の指定に誤りがあります	標準エラー出力

ページの先頭へ

注意事項

編集範囲を指定する場合，開始時刻，または終了時刻と一致するジャーナルレコードがないときは，開始時刻と終了時刻の間にあるジャーナルレコードが編集対象になります。
編集対象のジャーナルレコードがない場合，ファイル名，ファイル種別，作成日を出力します。
開始時刻が終了時刻より遅くなるように編集範囲を指定するときは，必ず「月」「日」，または「月」「日」「年（西暦）」を指定して，終了時刻が開始時刻よりあとになるようにしてください。省略するとエラーになります。日付を省略すると，jnleditコマンドを入力した年月日と見なすため，編集範囲が該当する年月日以外の日付の場合は，必ず「月」「日」，または「月」「日」「年（西暦）」を指定してください。
ファイル名の指定を省略すると，標準入力からの入力となります。そのため，入力ファイルをパイプ，リダイレクションなどで指定してください。
16進数字は，（8けた×4ブロック）の倍数，文字は（4文字×4ブロック）の倍数で，合計が-wオプションで指定したけた数に入る値で編集します。
UJをレコードまたはブロック単位に編集した場合，UJ内のユーザデータは，次の境界値で調整し出力されます。
- 32bit版の場合：4バイト境界
- 64bit版の場合：8バイト境界
そのため，UJ内のユーザデータがこの境界になっていない場合，編集結果の終端に無効なデータが付いて出力されます。編集データに出力されるUJ内のユーザデータのデータ長は，ユーザ指定値より8バイト多くなります。また，UJ内のユーザデータは，編集データの先頭8バイト目以降に出力されます。
UJ以外のジャーナルファイルをレコードまたはブロック単位に編集した場合，データは，次の境界値で調整し出力されます。
- 32bit版の場合：4バイト境界
- 64bit版の場合：8バイト境界
そのため，レコードのサイズがこの境界になっていない場合，編集結果の終端に無効なデータが付いて出力されます。
このコマンドで入力できる文字数はご使用のOSによって変わります。入力文字数が上限値を超えるとエラーになります。
指定したファイル数が256個以下の場合でも，1プロセスでオープンできるファイルの最大数を超えるとエラーになります。
次のオプションを使用して編集する内容を指定すると，該当する情報をレコード内に持ち，条件に一致するジャーナルだけが編集出力されます。

-jオプションで指定するジャーナルレコード種別やジャーナルデータの内容によっては，該当する情報そのものをレコード内に持たないジャーナルもあります。それらのジャーナルは編集出力の対象にはなりません。
- -s サーバ名
- -v サービス名
- -u トランザクション識別子
- -m 論理端末名称

ページの先頭へ

使用例

アンロードジャーナルファイルの先頭から，1993年5月29日17時30分0.999999秒までの情報を，16進数，および文字形式で，レコード単位に編集して出力する場合

アンロードジャーナルファイル：sysjnl001

jnledit -e r -t ,17300005291993 -c /tp1/jnl/sysjnl001

ページの先頭へ

jnledit

名称

形式

機能

オプション

●-e 編集種別 〜《f》

●-t 〔開始〕〔，終了〕

●-j レコード種別

●-s サーバ名 〜〈1〜8文字の英数字〉

●-v サービス名 〜〈1〜31文字の英数字〉

●-u トランザクショングローバル識別子〔，トランザクションブランチ識別子〕

●-o ジャーナル取得モード

●-m 論理端末名称 〜〈16けた以内の英数字〉

●-w けた 〜〈符号なし整数〉((80〜132))《80》

●-l 行 〜〈符号なし整数〉((12〜256))《24》

●-c

コマンド引数

●ファイル名 〜〈パス名〉

出力形式

出力メッセージ

注意事項

使用例

●-e　編集種別　　〜《f》

●-t　〔開始〕〔，終了〕

●-j　レコード種別

●-s　サーバ名　　〜〈1〜8文字の英数字〉

●-v　サービス名　　〜〈1〜31文字の英数字〉

●-u　トランザクショングローバル識別子〔，トランザクションブランチ識別子〕

●-o　ジャーナル取得モード

●-m　論理端末名称　　〜〈16けた以内の英数字〉

●-w　けた　　〜〈符号なし整数〉((80〜132))《80》

●-l　行　　〜〈符号なし整数〉((12〜256))《24》

●ファイル名　　〜〈パス名〉