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オプションを両方とも省略した場合,次のようになります。
-
二重化していない場合は,-aオプションを指定した場合と同様に,A系の物理ファイルをクローズ対象とします。
-
二重化している場合は,-a,-bオプションを同時に指定した場合と同様に,A系,B系両方の物理ファイルをクローズ対象とします。
-
片系運転不可の二重化の運用では,-j cpdの指定に,-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コマンドをスワップ処理中,またはほかの運用コマンドの処理中に入力すると,エラーとなることがあります。