JP1/Automatic Job Management System 2 操作ガイド
[詳細定義−[PC Job]]ダイアログボックスでは,PCジョブの詳細を定義します。
このダイアログボックスには,共通する表示項目と次のタブがあります。
- [定義]タブ
- [転送ファイル]タブ
- [属性]タブ
- <この項の構成>
- (1) 共通する表示項目
- (2) [定義]タブ
- (3) [転送ファイル]タブ
- (4) [属性]タブ
(1) 共通する表示項目
共通する表示項目を次の図に示します。
図13-85 [詳細定義−[PC Job]]ダイアログボックスの共通の表示項目
表示項目について説明します。
- [ユニット名]
- ユニット名を30バイト以内の文字列で指定します。デフォルトは「PCジョブ」です。
- [コメント]
- ユニットのコメントを80バイト以内の文字列で指定します。デフォルトは空白です。
- [実行ホスト]
- PCジョブを実行させたいJP1/AJS2 - Manager,またはJP1/AJS2 - Agentのホスト名を255バイト以内の文字列で指定します。デフォルトは空白です。
(2) [定義]タブ
[詳細定義−[PC Job]]ダイアログボックスの[定義]タブを次の図に示します。
図13-86 [詳細定義−[PC Job]]ダイアログボックスの[定義]タブ
表示項目について説明します。
- [実行ファイル名]
- 実行したいエージェントホスト上のファイル名を511バイト以内の文字列で指定します。デフォルトは空白です。
- ファイル名は,絶対パス,または相対パスで指定できます。相対パスで指定した場合,ジョブ実行時のワークパスまたは環境変数PATHで指定されたパスからの相対パスとなります。有効となる環境変数PATHは,システム環境変数です。また,マクロ変数を使用できます。実行ファイル名に空白文字が含まれる場合,「"(ダブルクォーテーションマーク)」で実行ファイル名を囲んでください。[実行ファイル名]を省略した場合,何もしないジョブを実行して,正常終了します。
- パラメーターは[実行ファイル名]に記載しないで,[パラメーター]に記載してください。
- なお,[実行先サービス]に[JP1/AJS2 Queueless Agent]を指定して,[実行ファイル名]にパラメーターを指定したジョブは起動失敗となります。
- [パラメーター]
- ジョブパラメーターを1,023バイト以内の文字列で指定します。また,マクロ変数を使用できます。デフォルトは空白です。
- [環境変数]
- ジョブ実行時は,システム環境変数が有効となります。その環境に新たな変数を付け加えてジョブを実行できます。付け加える環境変数を20,479バイト以内の文字列で指定します。また,マクロ変数を使用することもできます。デフォルトは空白です。
- 環境変数を定義する際の注意事項については,「JP1/Automatic Job Management System 2 コマンドリファレンス 付録A 環境変数および環境変数ファイルを定義する場合の注意事項」を参照してください。
- [環境変数ファイル名]
- ジョブ実行時は,システム環境変数が有効となります。その環境に新たな変数を付け加えてジョブを実行できます。付け加える環境変数として,エージェントホスト上の環境変数ファイル名を511バイト以内の文字列で指定します。ファイル名は,絶対パス,または相対パスで指定できます。相対パスで指定した場合,ジョブ実行時のワークパスからの相対パスになります。デフォルトは空白です。
- 環境変数を定義する際の注意事項については,「JP1/Automatic Job Management System 2 コマンドリファレンス 付録A 環境変数および環境変数ファイルを定義する場合の注意事項」を参照してください。
- [ワークパス]
- ジョブを実行するときのワーク(カレント)パス名を511バイト以内の文字列で指定します。ワーク(カレント)パス名はフルパスで指定します。デフォルトは空白です。
- ワークパス名を省略した場合,[実行先サービス]に[JP1/AJS2]を指定した場合は,エージェントの環境設定で設定されているエージェントプロセス実行時のワークディレクトリ名が仮定されます。
- [JP1/AJS2 Queueless Agent]を指定した場合は,JP1/AJS2用作業ファイル格納フォルダ名が仮定されます。
- 補足事項
- ワークパスは,ジョブを実行するときのカレントディレクトリに設定されます。また,ワークパスにはジョブを実行するときに必要な一時的な作業ファイルが作成されます。このファイルは,ジョブの実行中にジョブのプロセスが異常終了した場合に削除されずに残ることがありますが,JP1/AJS2が停止しているときであれば削除しても問題ありません。
- [実行優先順位]
- ジョブの実行優先順位を選択します。指定できる値は,[なし],および[1]〜[5]です。優先度が最も高いのは,[5]です。デフォルトは[なし]です。
- [なし]の場合は上位ジョブネットの定義に依存します。[なし]が指定され,最上位までのすべてのジョブネットに[なし]が指定されていた場合,[1]が仮定されます。
- 指定できる値と,値の意味を次の表に示します。
表13-20 指定できる値と実行優先順位
指定できる値 実行優先順位 1 対話処理と比較して低い 2 対話処理と比較して低い 3 対話処理と同等 4 対話処理と比較して高い 5 対話処理と比較して高い
- 補足事項
- Windowsの場合,優先順位は3段階になります。次の三つの優先順位クラスを設定してジョブのプロセスを起動します。
- 設定値が[1]または[2]の場合は,システムがアイドル状態のときに実行されます(Windowsで規定されるIDLE_PRIORITY_CLASSを設定します)。
- 設定値が[3]の場合は,一般的なプロセスとして実行されます(Windowsで規定されるNORMAL_PRIORITY_CLASSを設定します)。
- 設定値が[4]または[5]の場合は,上記の優先順位クラスを割り当てられたプロセスのスレッドより先に実行されます(Windowsで規定されるHIGH_PRIORITY_CLASSを設定します)。
- [標準入力ファイル名]
- ジョブを実行するときに使うエージェントホスト上の標準入力ファイル名を511バイト以内の文字列で指定します。ファイル名は,絶対パス,または相対パスで指定できます。相対パスで指定した場合,ジョブ実行時のワークパスからの相対パスになります。デフォルトは空白です。
- ジョブ登録時の転送ファイルやジョブ情報取得時に取得する結果ファイルで数メガバイトのファイルを転送すると,要求が失敗したり時間が掛かったりする場合があります。
- [標準出力ファイル名]
- ジョブを実行するときに使うエージェントホスト上の標準出力ファイル名を511バイト以内の文字列で指定します。ファイル名は,絶対パス,または相対パスで指定できます。相対パスで指定した場合,ジョブ実行時のワークパスからの相対パスになります。デフォルトは空白です。また,[追加書き]をチェックすると,標準出力ファイルは追加書きされます。
- ジョブ登録時の転送ファイルやジョブ情報取得時に取得する結果ファイルで数メガバイトのファイルを転送すると,要求が失敗したり時間が掛かったりする場合があります。
- 標準出力ファイル名を定義する場合の注意事項については,マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド 8.1.10 標準出力ファイル・標準エラー出力ファイルの注意事項」を参照してください。
- [標準エラー出力ファイル名]
- ジョブを実行するときに使うエージェントホスト上の標準エラー出力ファイル名を511バイト以内の文字列で指定します。ファイル名は,絶対パス,または相対パスで指定できます。相対パスで指定した場合,ジョブ実行時のワークパスからの相対パスになります。デフォルトは空白です。また,[追加書き]をチェックすると,標準エラー出力ファイルは追加書きされます。
- ジョブ登録時の転送ファイルやジョブ情報取得時に取得する結果ファイルで数メガバイトのファイルを転送すると,要求が失敗したり時間が掛かったりする場合があります。
- デフォルトの場合でも,エージェントホスト上に一時的に結果ファイルが作成され,ジョブ終了時にマネージャーホストに転送されます。このファイルはエージェントホストではジョブ終了時,マネージャーホストではジョブ情報削除時に削除されますが,実行結果詳細を参照する必要がなく,不要なファイル出力をしないように運用したい場合は,NULを割り当ててください。
- 標準エラー出力ファイル名を定義する場合の注意事項については,マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド 8.1.10 標準出力ファイル・標準エラー出力ファイルの注意事項」を参照してください。
- [終了判定]
- 終了判定の条件を選択します。
- [判定結果]
- [判定結果]で選択した終了判定の条件によって,表示項目が異なります。デフォルトは[しきい値による判定]です。[判定結果]の下には[警告しきい値]と[異常しきい値]の項目が表示されています。選択できる終了判定の条件を次に示します。
- [常に正常]
PCジョブを常に正常終了します。[警告しきい値]と[異常しきい値]の項目は,指定できません。
- [常に異常]
PCジョブを常に異常終了します。[警告しきい値]と[異常しきい値]の項目は,指定できません。
- [ファイルが存在すれば正常]
ジョブ終了時に,[ファイル名]で指定したエージェントホスト上のファイルがあれば,PCジョブを正常終了します。[判定結果]の下の項目は,[ファイル名]に変更します。任意のファイル名を511バイト以内の文字列で指定します。ファイル名は,絶対パス,または相対パスで指定できます。相対パスで指定した場合,ジョブ実行時のワークパスからの相対パスになります。デフォルトは空白です。
- [ファイルが更新されれば正常]
ジョブ開始から終了までの間に,[ファイル名]で指定したエージェント上のファイルが更新されれば,PCジョブを正常終了します。[判定結果]の下の項目は,[ファイル名]に変更します。任意のファイル名を511バイト以内の文字列で指定します。ファイル名は,絶対パス,または相対パスで指定できます。相対パスで指定した場合,ジョブ実行時のワークパスからの相対パスになります。デフォルトは空白です。
- [しきい値による判定]
正常終了と警告終了の判定基準とする値,または正常終了と異常終了の判定基準とする値を,定義します。[警告しきい値]と[異常しきい値]の指定できる値は,0〜2,147,483,647です。デフォルトは,[警告しきい値]が空白で,[異常しきい値]が0です。
デフォルトの場合は,終了コードが0以外のときに異常終了となります。[警告しきい値]を設定した場合は,終了コードが0から設定した値までを正常終了とします。終了コードが[警告しきい値]より大きい場合に警告終了となります。また,[異常しきい値]を設定した場合は0から[異常しきい値]までが正常終了となります。終了コードが-1以下または[異常しきい値]より大きい場合に異常終了となります。[警告しきい値]と[異常しきい値]の両方を指定した場合は,終了コードが0から[警告しきい値]までが正常終了,[警告しきい値]より大きく[異常しきい値]までが警告終了,-1以下または[異常しきい値]より大きい場合が異常終了となります。
- [実行時のユーザー]
- ジョブを実行するJP1/AJS2 - AgentのOSのユーザー名を63バイト以内の文字列で指定します。デフォルトは空白です。
- このユーザーは,[実行ユーザー種別]の[登録ユーザー],または[所有ユーザー]にマッピングしておく必要があります。また,この項目の指定を省略した場合,ユーザーマッピングのプライマリーユーザーで実行します。ユーザーマッピングについては,マニュアル「JP1/Base 運用ガイド」のユーザー管理機能の設定の章を参照してください。
- なお,Windowsのホストで実行するジョブの場合,有効となるOSのユーザーの情報は,指定したOSのユーザーの権限だけです。また,実行ファイル名に指定したファイルに対するアクセスは,JP1/AJS2サービスに設定されているアカウントでアクセスします。実行ファイルの中からアクセスするファイルに対しては,指定したOSユーザーでアクセスします。
- 実行ユーザーのアクセス権をローカルサーバのユーザーに限定させたい場合は,OSユーザー名の指定方法を「サーバ名¥ユーザー名」としてください。
- 注意
- ファイル名には,ネットワークドライブ名から始まるパスを指定しないでください。ネットワークドライブは,ユーザーがWindowsにログオンしたあとに再接続されますので,Windowsにログオンしていない場合には,実行ファイルのパス名を正しく認識できない場合があります。ネットワークドライブ名ではなく,「\\コンピュータ名\共有フォルダ\実行ファイル名」のようにコンピュータ名から始まるパスを指定してください。
- [標準入力ファイル名],[標準出力ファイル名],または[標準エラー出力ファイル名]に指定できるファイルは,テキスト形式のファイルだけです。
- 標準入力ファイル,標準出力ファイル,または標準エラー出力ファイルに含まれるデータ中に使用できる文字については,マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド 5.6.1(2) 使用できる文字の範囲」を参照してください。
(3) [転送ファイル]タブ
[詳細定義−[PC Job]]ダイアログボックスの[転送ファイル]タブでは,ジョブを実行するために必要なファイルをJP1/AJS2 - ManagerからJP1/AJS2 - Agentに転送するための設定をします。転送できるファイルは,テキスト形式のファイルだけです。
[詳細定義−[PC Job]]ダイアログボックスの[転送ファイル]タブを次の図に示します。
図13-87 [詳細定義−[PC Job]]ダイアログボックスの[転送ファイル]タブ
表示項目について説明します。
- [転送ファイル1〜4]
- 一つのジョブに4個の転送ファイルを指定できます。
- [転送元ファイル名]
- JP1/AJS2 - Managerにあるファイルを511バイト以内の文字列で指定します。ファイル名はフルパスで指定します。デフォルトは空白です。
- ジョブ登録時の転送ファイルやジョブ情報取得時に取得する結果ファイルで数メガバイトのファイルを転送すると,要求が失敗したり時間が掛かったりする場合があります。
- [転送先ファイル名]
- エージェントホスト上に転送されるファイル名を511バイト以内の文字列で指定します。ファイル名はフルパスで指定します。デフォルトは空白です。
- 転送先ファイル名は省略できます。
- 転送先に作成されたファイルをジョブの実行時に利用する場合,パラメーターで$JP1AJS2_JPQTEMPxx$変数を指定します。
- $JP1AJS2_JPQTEMPxx$変数のxxには,転送元ファイル名の指定があるものに対してだけ,上から順に01〜04までの番号が付加されます。
- 例えば,次のように指定したとします。
- 転送ファイル1
- [転送元ファイル名]:指定なし
- [転送先ファイル名]:指定なし
- 転送ファイル2
- [転送元ファイル名]:指定あり
- [転送先ファイル名]:指定あり
- 転送ファイル3
- [転送元ファイル名]:指定なし
- [転送先ファイル名]:指定なし
- 転送ファイル4
- [転送元ファイル名]:指定あり
- [転送先ファイル名]:指定なし
- この場合,転送ファイル2の転送先ファイル名は$JP1AJS2_JPQTEMP01$に設定され,転送ファイル4の転送先ファイル名は$JP1AJS2_JPQTEMP02$に設定されます。
- なお,$JP1AJS2_JPQTEMPxx$変数は,実行ファイル名には指定できません。指定した場合,ジョブは起動失敗となります。
- [ジョブ終了後]
- ジョブの実行終了後,転送したファイルを削除する場合に,[ファイルを削除する]チェックボックスをチェックします。デフォルトではチェックされていません。
- また,転送元ファイル名を指定して,転送先ファイル名を指定していない場合,[ファイルを削除する]チェックボックスにチェックしていると仮定して実行されます。
- 注意事項
- JP1/AJS2では,転送ファイルはマネージャーホストからエージェントホストへ転送し,結果ファイル(標準出力ファイル,標準エラー出力ファイル)はエージェントホストからマネージャーホストへと転送します。ファイルを転送すると,各ファイルは転送先ホストのJP1/AJS2サービスの文字コードに変換されます。このため,各ファイルの文字コードとJP1/AJS2の文字コードを一致させる必要があります。
- 転送ファイルの場合
PCジョブに転送ファイルを指定する場合は,マネージャーホストのJP1/AJS2サービスの文字コードと,転送元ファイルの文字コードを一致させる必要があります。また,jpqjobsubコマンドなどのサブミットジョブに転送ファイルを指定する場合は,コマンド実行プロセスの文字コードと,転送元ファイルの文字コードを一致させる必要があります。
- 結果ファイルの場合
ジョブが出力する結果ファイルの文字コードと,エージェントホストのJP1/AJS2サービスの文字コードを一致させる必要があります。
- 例えば,マネージャーホストのJP1/AJS2サービスを日本語シフトJISで起動し,エージェントホストのJP1/AJS2サービスを日本語EUCで起動した場合,マネージャーホスト上の転送元ファイル(日本語シフトJIS)をエージェントホストに転送すると,転送先ファイルは日本語EUCで作成されます。
- JP1/AJS2の文字コードの設定については,マニュアル「JP1/Automatic Job Management System 2 セットアップガイド 13.4.1(1) 文字コード種別の変更」を参照してください。
- また,転送ファイルに含まれるデータ中に使用できる文字については,マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド 5.6.1(2) 使用できる文字の範囲」を参照してください。
- 注意
- ファイル名には,ネットワークドライブ名から始まるパスを指定しないでください。ネットワークドライブは,ユーザーがWindowsにログオンしたあとに再接続されますので,Windowsにログオンしていない場合には,実行ファイルのパス名を正しく認識できない場合があります。ネットワークドライブ名ではなく,「\\コンピュータ名\共有フォルダ\実行ファイル名」のようにコンピュータ名から始まるパスを指定してください。
(4) [属性]タブ
[詳細定義−[PC Job]]ダイアログボックスの[属性]タブを次の図に示します。
図13-88 [詳細定義−[PC Job]]ダイアログボックスの[属性]タブ
表示項目について説明します。
- [保留]
- ユニットの状態をあらかじめ保留状態にするかどうかを指定します。指定できる種類は,[しない]と[する]です。デフォルトは[しない]です。
- [種別]
- ユニットの種別をリカバリーにするかどうかを指定します。指定できる種類は,[通常]と[リカバリ]です。デフォルトは[通常]です。
- [実行先サービス]
- 実行先のサービスを選択します。指定できる種類は,[JP1/AJS2]と[JP1/AJS2 Queueless Agent]です。デフォルトは[JP1/AJS2]です。なお,この項目は接続先JP1/AJS2 - Managerのバージョンが07-00以降の場合に表示されます。
- [打ち切り時間指定]
- ジョブの実行を打ち切る時間を指定するかどうかを選択します。指定できる種類は,[しない]と[する]です。デフォルトは[しない]です。
- [打ち切り時間]
- [打ち切り時間指定]で[する]を選択した場合,打ち切り時間を分で指定します。指定できる値は,1〜1,440です。デフォルトは空白です。
- [終了遅延監視]
- 実行所要時間によるジョブの終了遅延監視をするかどうかを指定します。ジョブの終了遅延を監視する場合は[実行所要時間]をチェックします。デフォルトではチェックされていません。
- また,[実行所要時間]をチェックした場合は,ジョブの実行所要時間を1〜1,440の範囲内で指定します(単位:分)。
- この項目はJP1/AJS2 - Viewのバージョンが08-50以降の場合に表示されます。なお,実行所要時間によるジョブの終了遅延監視の注意事項については,マニュアル「JP1/Automatic Job Management System 2 設計・運用ガイド 8.1.22 ジョブ実行所要時間による終了遅延監視機能に関する注意事項」を参照してください。
- [所有者]
- ユニットの所有者を31バイト以内の文字列で指定します。デフォルトは,ログインしているJP1ユーザー名です。
- [JP1資源グループ]
- JP1資源グループ名を63バイト以内の文字列で指定します。指定できる文字は,英数字,および「_(アンダーバー)」です。デフォルトは,上位ユニットのJP1資源グループ名です。空白の場合は,アクセス権限の対象になりません。
- [実行ユーザー種別]
- 実行ユーザーの種類を選択します。デフォルトは[登録ユーザー]です。選択できる種類を次に示します。
- [登録ユーザー]
ジョブを登録したJP1ユーザーでユーザーマッピングします。変換されたOSのユーザーのアカウントでジョブを実行します。
- [所有ユーザー]
ジョブを所有しているJP1ユーザーでユーザーマッピングします。変換されたユーザーのアカウントでジョブを実行します。
- ここで指定したユーザーからOSのユーザーに変換されるように,ジョブ実行ホストでユーザーマッピングする必要があります。
Copyright (C) 2006, 2010, Hitachi, Ltd.
Copyright (C) 2006, 2010, Hitachi Software Engineering Co., Ltd.