jnlchgfg
形式
jnlchgfg -j sys|jar 〔-r リソースグループ名〕 -g ファイルグループ名 〔-d サービス定義名〕 〔-S〕
機能
指定したファイルグループを強制的にアンロード済み状態にします。ただし,現用ファイルグループのステータス変更はできません。
また,アーカイブジャーナルファイルのアーカイブ待ち状態を強制的にアーカイブ済み状態にできます。
オプション
●-j sys|jar
ステータスを変更するジャーナル関係のファイルを指定します。
sys:システムジャーナルファイル
jar:アーカイブジャーナルファイル
●-r リソースグループ名 〜〈1〜8文字の識別子〉
対象とするリソースグループの名称を指定します。
-jオプションでsysを指定している場合,システムジャーナルサービス定義の定義ファイル名を指定します。
jオプションでjarを指定している場合,ステータスを変更するアーカイブジャーナルサービス定義の定義ファイル名を指定します。
このオプションの指定を省略すると,-jオプションでsysを指定している場合は,$DCCONFPATH/jnlのジャーナルサービス定義で指定したソースグループ名が仮定されます。jオプションでjarを指定している場合は,$DCCONFPATH/jarのグローバルアーカイブジャーナルサービス定義の定義コマンドjnldfsv -aの先頭に定義したアーカイブジャーナルサービス定義の定義ファイル名が仮定されます。
●-g ファイルグループ名 〜〈1〜8文字の識別子〉
ステータスを変更するシステムジャーナルファイルのファイルグループ名を指定します。
●-d サービス定義名 〜〈パス名〉または〈ファイル名〉
ステータスを変更するファイルグループを定義しているシステムジャーナルサービス定義ファイル名を,次のどちらかで指定します。
-
/(ルート)で始まる完全パス名で指定
-
定義ファイル名だけで指定
定義ファイル名だけで指定する場合,$DCCONFPATHに定義ファイルが格納されているディレクトリを設定しておく必要があります。
このオプションの指定を省略すると,-rオプションの指定に従います。
●-S
アーカイブ待ち状態をアーカイブ済み状態に変更します。
システムジャーナルサービス定義でjnl_arc_check_level=2を指定した場合は,アーカイブジャーナルファイルをアンロードおよびアーカイブしないと,そのファイルグループは再使用できません。アーカイブジャーナルサービスに異常が発生して,アーカイブできなくなった場合にこのオプションを指定すると,強制的にアーカイブ済み状態になるのでシステムを続行できます。
ただし,強制的にアーカイブ済み状態にしたファイルグループがその後,スワップ先のファイルグループになった場合は,アーカイブジャーナルサービスが正常に戻ってもそのファイルグループをアーカイブすることはできません。
出力メッセージ
メッセージID |
内容 |
出力先 |
---|---|---|
KFCA01141-E |
実行環境がジャーナルファイルレスモードのため,コマンドを実行できません |
標準エラー出力 |
注意事項
-
jnlchgfgコマンドは,ジャーナルサービス開始中に実行してはなりません。ジャーナルサービス開始中とは,正常開始時はKFCA01100-IからKFCA01102-Iまで,再開始時はKFCA01101-IからKFCA01102-Iまでのことです。実行した場合,システムジャーナルファイルの状態がOpenTP1に反映されないことがあります。この場合,ジャーナルサービス開始,再開始処理完了後にjnlclsfgコマンドで該当するファイルグループをクローズし,その後,jnlopnfgコマンドでオープンすると,システムジャーナルファイルの状態が反映されます。
-
jnlchgfgコマンドは,定義ファイルを参照して実行されます。そのため,ジャーナルを取得したオンライン時とjnlchgfgコマンド実行時の定義ファイルが一致していないと,ステータスをきちんと変更できません。
-
ジャーナルを取得したオンライン時とjnlchgfgコマンド実行時の定義ファイルが異なる場合,-d,-rオプションを指定します。バックアップ先のディレクトリが$DCCONFPATHでないときは-dオプションを指定し,ファイル名が変更されたときは-rオプションを指定してください。ただし,この場合でもシステムジャーナルサービス定義,またはアーカイブジャーナルサービス定義は,ジャーナルを取得したオンライン時の定義がバックアップされている必要があります。
-
OpenTP1停止直後には,jnlchgfgコマンドを入力しないでください。コマンドが中断するおそれがあります。