JP1/Automatic Job Management System 2 コマンドリファレンス

ajsrestore

形式

 
ajsrestore
     [-F サービス名]
     [-b 退避情報ディレクトリ名]
     [-d 回復先ジョブネットワーク要素名]
     [{-i|-e|-f}]
     [-t]
     [-S]
     -n 退避ボックス名
     [退避ファイル名...]
 

機能

退避ボックスに退避したジョブネットワーク要素を，ユニット定義情報ディレクトリに回復します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

• JP1_AJS_Admin権限
• JP1_AJS_Manager権限
• JP1_AJS_Editor権限

このコマンドは，Administrators権限（Windowsの場合），またはスーパーユーザー権限（UNIXの場合）を持つユーザーが使用することをお勧めします。

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1～30（単位：バイト）です。

-b 退避情報ディレクトリ名

環境設定時に指定した退避情報ディレクトリ^※と異なるディレクトリを使用する場合に，ディレクトリ名をフルパスで指定します。

指定できる文字数は，1～255（単位：バイト）です。

省略した場合，環境設定時に指定した退避情報ディレクトリ名^※が仮定されます。

注※

Windowsの場合は，［マネージャー環境設定］ダイアログボックスの［スケジューラーファイルの構成2］タブの［退避情報ディレクトリ名］に指定したフォルダ名。

UNIXの場合は，スケジューラーサービス環境設定ファイル（Schedule.conf）のAJSBKUROOTパラメーターに指定したディレクトリ名。

-d 回復先ジョブネットワーク要素名

退避したジョブネットワーク要素を回復する際に，回復先で使用するジョブグループ名，またはジョブネット名を指定します。

指定できる文字数は，1～899（単位：バイト）です。

-i

回復先に，これから回復するジョブネットワーク要素と同一名称のジョブネットワーク要素がある場合に，メッセージおよび了解を求めるプロンプトを表示します。

-e

回復先に，これから回復するジョブネットワーク要素と同一名称のジョブネットワーク要素がある場合に，エラーとします。情報は更新されません。

-f

回復先に，これから回復するジョブネットワーク要素と同一名称のジョブネットワーク要素がある場合でも，強制的に更新します。

-t

退避ボックスに退避したジョブネットワーク要素名の一覧を標準出力ファイルに出力します。

出力形式は，環境変数AJSDISPSUBUNITTYPEの設定によって切り替えることができます。

• ジョブグループ種別を出力する場合
  環境変数AJSDISPSUBUNITTYPEにYESを指定します。
  

  注

  ジョブグループ種別が表示されるのは，退避ジョブネットワーク要素種別がジョブグループの場合だけです。

• ジョブグループ種別を出力しない場合
  次のどちらかを選択します。
  
  • 環境変数AJSDISPSUBUNITTYPEにNOを指定する。
  • 環境変数AJSDISPSUBUNITTYPEに値を設定しない。

なお，環境変数AJSDISPSUBUNITTYPEの詳細については，「環境変数一覧」の表1-6を参照してください。

-S

ジョブネットがサスペンド状態の場合，実行登録済みのジョブネットであっても，そのジョブネットにジョブネットワーク要素を更新できるようにします。

ただし，ジョブネットがサスペンド状態でも，次の場合は定義の更新は行えません。

• ルートジョブネットの定義を更新する場合
• ルートジョブネットの定義を含むジョブグループの定義を更新する場合
• 実行中のジョブネットの場合

-n 退避ボックス名

退避ボックス名を指定します。

指定できる文字数は，1～50（単位：バイト）です。

退避ボックスの名称は，OSのファイルシステムに依存します。OSがUNIXの場合，退避ボックス名の大文字・小文字は区別されます。OSがWindowsの場合，退避ボックス名の大文字・小文字は区別されません。

退避ファイル名

退避ボックスの中にある，回復したいファイル名を指定します。

指定できる値は，0001～1024です。

退避ファイル名は複数指定できます。

省略すると，退避ボックスの中のすべての退避ファイルが回復されます。

注意事項

• 次の場合はジョブネットワーク要素を回復できません。
  
  • 退避ボックス，および退避ファイルの両方に参照権限がない場合。
  • 回復先のジョブネットワーク要素に更新権限がない場合。
  • 回復先にジョブネットワーク要素がない場合。
  • ジョブネットの中にジョブグループを回復するなど，ありえない階層構造になる場合。
  • そのネスト数が許容最大数（30個）を超えるジョブグループや，ジョブネットの場合。
  • 回復先にホストリンクジョブネットを指定している場合。
• 回復先に，これから回復するジョブネットワーク要素と同一名称のジョブネットワーク要素がある場合，そのジョブネットワーク要素をあらかじめ削除したあと，回復することをお勧めします。
• 実行登録済みのルートジョブネットや，そのルートジョブネットを含むジョブグループおよびプランニンググループを回復する場合は，回復する前に，ajsleaveコマンドで実行登録を解除しておいてください（実行登録された状態では，回復できません）。
  ただし，ルートジョブネット，そのルートジョブネットを含むジョブグループ，およびリモートジョブネット以外のユニットの場合，操作対象のジョブネットをサスペンド状態にしておき，このコマンドに-Sオプションを指定すれば，ジョブネットの実行登録を解除しなくても，回復できます（操作対象のユニットが実行中の場合，-Sオプションを指定しても回復できません。実行登録済みのホストリンクジョブネットは回復できません）。
  
• ホストリンクジョブネットを回復できるのは，実行登録されていないジョブネット（リモートジョブネットを除く）下だけです。リモートジョブネット下には回復できません。
• ジョブネット下にホストリンクジョブネットが含まれる場合，そのジョブネットをリモートジョブネット下や，上位にリモートジョブネットが存在するジョブネット下には回復できません。
• ホストリンクジョブネットにはユニットを回復できません。
• ホストリンクジョブネットが実行登録されている場合は，-iおよび-fオプションを指定しても，回復できません。
• 回復先ユニットに指定したジョブネットがサスペンド状態変更処理中の場合，このコマンドは異常終了します。
• ジョブネットの中にプランニンググループを回復できません。
• プランニンググループの中にはジョブネット，リモートジョブネット以外のユニットを回復できません。

戻り値

0	正常終了。
4～124で4の倍数値	異常終了。

補足事項

• 退避ファイル名を省略した場合，退避ファイルを作成した順で回復されます。
• 回復したジョブネットワーク要素の，JP1/AJS2 - Viewの［ジョブネットエディタ］ウィンドウでの表示位置は自動的に決まります。ただし，同一名称のジョブネットワーク要素は，回復前と同じ位置になります。

使用例1

退避ボックス（BOX1）に退避したすべての退避ファイルをジョブグループ（/資材部/出庫管理）に回復します。回復先に，これから回復するジョブネットワーク要素と同一名称のジョブネットワーク要素がありますが，強制的に回復します。

 
ajsrestore -f -d /資材部/出庫管理 -n BOX1
 

使用例2

退避ボックス（BOX1）に退避したユニット一覧を出力します。

 
ajsrestore -t -n BOX1
 

出力例

 
0001:/資材部:テンプレート:g
0002:/資材部/出庫管理:出庫伝票作成:n

使用例3

退避ボックス（BOX1）に退避したユニット一覧を出力します。

 
ajsrestore -t -n BOX1
 

出力例

 
0001:/資材部:テンプレート:g
0002:/資材部/出庫管理/出庫伝票作成:ジョブネット実行待ち:nc

[目次][前へ][次へ]

Copyright (C) 2006, 2010, Hitachi, Ltd.
Copyright (C) 2006, 2010, Hitachi Software Engineering Co., Ltd.