分散トランザクション処理機能 OpenTP1 運用と操作

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

jnlclsfg

名称

ジャーナル関係のファイルのクローズ

形式

jnlclsfg -j sys|cpd|jar 〔-s サーバ名〕〔-r リソースグループ名〕
         -g ファイルグループ名 〔-e 要素ファイル名〕〔-a〕〔-b〕

機能

指定したファイルグループを構成するオープン中の物理ファイルをクローズし,オンラインで使用しないようにします。ただし,次のファイルグループを構成する物理ファイルはクローズできません。

なお,jnlclsfgコマンドは,OpenTP1が動作中で,かつジャーナルサービスが動作中のときだけ入力できます。

オプション

●-j sys|cpd|jar

クローズするジャーナル関係のファイルを指定します。

 sys:システムジャーナルファイル
 cpd:チェックポイントダンプファイル
 jar:アーカイブジャーナルファイル

●-s サーバ名  〜〈1〜8文字の識別子〉

チェックポイントダンプファイルをクローズするとき,対象となるサーバの名称を指定します。サーバ名を指定することによって,ファイルグループ名の検索範囲を限定できます。

このオプションの指定を省略すると,すべてのサーバのチェックポイントダンプファイルでファイルグループ名と一致するもののうち,最初に見つけたものをクローズします。

-jオプションでcpd以外を指定している場合,-sオプションの指定は無視されます。

●-r リソースグループ名  〜〈1〜8文字の識別子〉

-jオプションでjarを指定している場合,クローズするファイルのリソースグループの名称を指定します。グローバルアーカイブジャーナルサービス定義の定義コマンドjnldfsv -aで指定したアーカイブジャーナルサービス定義の定義ファイル名を指定してください。

このオプションの指定を省略すると,オンライン中のアーカイブジャーナルファイルのうちから,アーカイブジャーナルサービス定義の定義コマンドjnldfsv -aの先頭に定義したファイル名が仮定されます。

-jオプションでjar以外を指定している場合,-rオプションの指定は無視されます。

●-g ファイルグループ名  〜〈1〜8文字の識別子〉

クローズするジャーナル関係のファイルのファイルグループ名を指定します。

●-e 要素ファイル名

クローズするジャーナル関係のファイルのファイルグループ中の,要素ファイルの名称を指定します。

●-a

A系の物理ファイルをクローズ対象とします。

●-b

B系の物理ファイルをクローズ対象とします。

二重化していないときに指定すると,コマンドエラーとなります。

上記の-a,-bオプションを両方とも省略した場合,次のようになります。

なお,クローズ対象となる物理ファイルがすべてクローズ済みのときは,警告メッセージ(KFCA01283-W,またはKFCA02168-W)を出力します。ただし,コマンドエラーにはなりません(コマンド終了コードは0)。

出力メッセージ

メッセージID 内容 出力先
KFCA01141-E 実行環境がジャーナルファイルレスモードのため,コマンドを実行できません 標準エラー出力
KFCA01216-I ファイルグループのクローズが成功しました メッセージログファイル
KFCA01280-E jnlclsfgコマンドの処理が失敗しました 標準エラー出力
KFCA01281-E jnlclsfgコマンドの入力形式が誤っています 標準エラー出力
KFCA01283-W jnlclsfgコマンド実行中に軽度エラーが発生しました 標準エラー出力
KFCA01285-E スワップ処理中です 標準エラー出力
KFCA01295-I ヘルプメッセージ 標準出力,
標準エラー出力
KFCA02128-E 指定したサーバ名が誤っています 標準エラー出力
KFCA02129-E 指定したファイルグループ名が誤っています 標準エラー出力
KFCA02130-E -sオプションの指定が誤っています 標準エラー出力
KFCA02131-E -gオプションの指定が誤っています 標準エラー出力
KFCA02132-E 障害が発生してjnlclsfgコマンドの処理を中止しました 標準エラー出力
KFCA02168-W 指定したファイルグループはクローズ済みです 標準エラー出力
KFCA02170-E ファイルのクローズに失敗しました 標準エラー出力
KFCA02184-E ファイルグループの数が不足しているためクローズできません 標準エラー出力

注意事項

jnlclsfgコマンドをスワップ処理中,またはほかの運用コマンドの処理中に入力すると,エラーとなることがあります。