4.2.6 UNIX/PCジョブ定義情報の記述方法
UNIX/PCジョブ定義情報の記述方法を説明します。
UNIX/PCジョブ定義情報の形式,およびパラメーターを次に示します。
- 形式
[te="コマンドテキスト";]
[sc="スクリプトファイル名";]
[prm="パラメーター";]
[wkp="作業用パス名";]
[ev="環境変数ファイル名";]
[env="環境変数";]...
[si="標準入力ファイル名";]
[so="標準出力ファイル名";]
[se="標準エラー出力ファイル名";]
[soa={new|add};]
[sea={new|add};]
[etm=n;]
[fd=実行所要時間;]
[pr=n;]
[ex="実行エージェント名";]
[un="実行ユーザー名";]
[jd={nm|ab|cod|mdf|exf};]
[wth=n;]
[tho=n;]
[jdf="終了判定ファイル名";]
[ts1="転送元ファイル名1";]
[td1="転送先ファイル名1";]
[top1={sav|del};]
[ts2="転送元ファイル名2";]
[td2="転送先ファイル名2";]
[top2={sav|del};]
[ts3="転送元ファイル名3";]
[td3="転送先ファイル名3";]
[top3={sav|del};]
[ts4="転送元ファイル名4";]
[td4="転送先ファイル名4";]
[top4={sav|del};]
[ha={y|n};]
[eu={ent|def};]
[jty={q|n};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]
- パラメーター
- te="コマンドテキスト";
- コマンドテキストを定義します。
- 指定できる文字数は,1~1,023(単位:バイト)です。
- コマンドテキスト中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- コマンドテキストには,マクロ変数を指定できます。マクロ変数で指定する場合,指定できる文字数は,「マクロ変数名:引き継ぎ情報名」の形式で,1~1,023(単位:バイト)です。マクロ変数名は,「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は,A~Z(大文字の英字),0~9(アラビア数字),「.(ピリオド)」です。
- sc="スクリプトファイル名";
- UNIXジョブの場合,ジョブを実行するエージェントホスト上のスクリプトファイル名を定義します。PCジョブの場合,エージェントホスト上の実行ファイル名を定義します。
- 指定できる文字数は,1~511(単位:バイト)です。ファイル名は,絶対パスおよび相対パスで指定できます。相対パスで指定した場合,ジョブ実行時の作業用パスからの相対パスになります。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- ファイル名には,マクロ変数を指定できます。マクロ変数で指定する場合,指定できる文字数は,「マクロ変数名:引き継ぎ情報名」の形式で,1~511(単位:バイト)です。マクロ変数名は,「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は,A~Z(大文字の英字),0~9(アラビア数字),「.(ピリオド)」です。
- prm="パラメーター";
- 実行ファイルに対するパラメーターを定義します。
- 指定できる文字数は,1~1,023(単位:バイト)です。
- パラメーター中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- パラメーターには,マクロ変数を指定できます。マクロ変数で指定する場合,指定できる文字数は,「マクロ変数名:引き継ぎ情報名」の形式で,1~1,023(単位:バイト)です。マクロ変数名は,「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は,A~Z(大文字の英字),0~9(アラビア数字),「.(ピリオド)」です。
- wkp="作業用パス名";
- 作業用パス名をフルパス名で定義します。
- 指定できる文字数は,1~511(単位:バイト)です。
- 作業用パス名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- ev="環境変数ファイル名";
- エージェントホスト上の環境変数ファイル名を定義します。
- 指定できる文字数は,1~511(単位:バイト)です。ファイル名は,絶対パスおよび相対パスで指定できます。相対パスで指定した場合,ジョブ実行時の作業用パスからの相対パスになります。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- env="環境変数";
- 環境変数を「環境変数名=値」の形式で定義します。
- 指定できる文字数は,1~20,479(単位:バイト)です。
- 環境変数中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- 環境変数には,マクロ変数を指定できます。マクロ変数で指定する場合,指定できる文字数は,「マクロ変数名:引き継ぎ情報名」の形式で,1~20,479(単位:バイト)です。マクロ変数名は,「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は,A~Z(大文字の英字),0~9(アラビア数字),「.(ピリオド)」です。
- si="標準入力ファイル名";
- ジョブを実行するエージェントホスト上の標準入力ファイル名を定義します。
- 指定できる文字数は,1~511(単位:バイト)です。ファイル名は,絶対パスおよび相対パスで指定できます。相対パスで指定した場合,ジョブ実行時の作業用パスからの相対パスになります。
- 「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- so="標準出力ファイル名";
- ジョブを実行するエージェントホスト上の標準出力ファイル名を定義します。
- 指定できる文字数は,1~511(単位:バイト)です。ファイル名は,絶対パスおよび相対パスで指定できます。相対パスで指定した場合,ジョブ実行時の作業用パスからの相対パスになります。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,「$JP1AJS2_JPQSTDOUTTEMP$」を指定すると,標準出力ファイルが一時ファイルに出力されます。
- また,キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- se="標準エラー出力ファイル名";
- ジョブを実行するエージェントホスト上の標準エラー出力ファイル名を定義します。
- 指定できる文字数は,1~511(単位:バイト)です。ファイル名は,絶対パスおよび相対パスで指定できます。相対パスで指定した場合,ジョブ実行時の作業用パスからの相対パスになります。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- soa={new|add};
- 標準出力ファイル名の追加書きオプションを定義します。省略した場合,newが仮定されます。soパラメーターで標準出力ファイル名を指定しなかった場合,このパラメーターは無効になります。
- new:ファイルを新規に作成します。
- add:既存のファイルに情報を追加します。
- sea={new|add};
- 標準エラー出力ファイル名の追加書きオプションを定義します。省略した場合,newが仮定されます。seパラメーターで標準エラー出力ファイル名を指定しなかった場合,このパラメーターは無効になります。
- new:ファイルを新規に作成します。
- add:既存のファイルに情報を追加します。
- etm=n;
- 実行打ち切り時間を,実行開始時刻からの相対分で定義します。
- 指定できる値は,1~1,440(単位:分)です。
- fd=実行所要時間;
- 終了遅延監視するジョブの実行所要時間を定義します。
- 指定できる値は,10進数の値で1~1,440(単位:分)です。
- pr=n;
- ジョブの実行優先順位を定義します。
- 指定できる値は,1~5です。実行優先順位がいちばん低いのが1,いちばん高いのが5です。省略した場合,上位ジョブネットの定義に依存します。このパラメーターを省略し,かつ,最上位までのすべての上位ジョブネットに対してpr,またはniパラメーターを指定しなかった場合,ジョブの実行優先順位として1が仮定されます。
- ex="実行エージェント名";
- ジョブを実行する実行エージェント名または実行エージェントグループ名を定義します。
- 指定できる文字数は,1~255(単位:バイト)です。
- 実行エージェント名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- un="実行ユーザー名";
- エージェントホストでジョブを実行する場合の,ジョブを実行するOSユーザー名を定義します。
- 指定できる文字数は,1~63(単位:バイト)です。ユーザー名中に空白文字は指定できません。
- ユーザー名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- jd={nm|ab|cod|mdf|exf};
- 終了判定種別を定義します。省略した場合,codが仮定されます。
- nm:すべて正常終了とします。
- ab:すべて異常終了とします。
- cod:終了コードが指定値以下の場合は,正常終了とします。
- mdf:ジョブの実行開始から実行終了までの間にファイルが更新されている場合は,正常終了とします。
- exf:ジョブの実行終了時にファイルが作成されている場合は,正常終了とします。
- wth=n;
- 警告終了のしきい値を定義します。
- 指定できる値は,0~2,147,483,647です。
- tho=n;
- 異常終了のしきい値を定義します。
- 指定できる値は,0~2,147,483,647です。省略した場合,0が仮定されます。
- jdf="終了判定ファイル名";
- ジョブを実行するエージェントホスト上の終了判定ファイル名を定義します。
- 指定できる文字数は,1~511(単位:バイト)です。ファイル名は,絶対パスおよび相対パスで指定できます。相対パスで指定した場合,ジョブ実行時の作業用パスからの相対パスになります。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- ts1="転送元ファイル名1";
- 転送元ファイル名をフルパス名で定義します。
- 指定できる文字数は,1~511(単位:バイト)です。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- td1="転送先ファイル名1";
- エージェントホストに転送する転送先ファイル名を定義します。
- 指定できる文字数は,1~511(単位:バイト)です。省略した場合,$JP1AJS2_JPQTEMPxx$変数が仮定されます(xxは,転送ファイルの番号で,01~04の値)。sc,prmパラメーターにこの変数を指定すると,転送先ファイル名を意識しないでジョブを実行できます。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- top1={sav|del};
- 転送先ファイルの自動削除オプションを定義します。
- sav:ファイルを保存します。
- del:ファイルを削除します。
- 転送元ファイル名および転送先ファイル名を指定し,このパラメーターを省略した場合,savが仮定されます。
- 転送元ファイル名を指定し,転送先ファイル名およびこのパラメーターを省略した場合,delが仮定されます。
- ts2="転送元ファイル名2";
- 転送元ファイル名をフルパス名で定義します。
- 指定できる文字数は,1~511(単位:バイト)です。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- td2="転送先ファイル名2";
- エージェントホストに転送する転送先ファイル名を定義します。
- 指定できる文字数は,1~511(単位:バイト)です。省略した場合,$JP1AJS2_JPQTEMPxx$変数が仮定されます(xxは,転送ファイルの番号で,01~04の値)。sc,prmパラメーターにこの変数を指定すると,転送先ファイル名を意識しないでジョブを実行できます。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- top2={sav|del};
- 転送先ファイルの自動削除オプションを定義します。
- sav:ファイルを保存します。
- del:ファイルを削除します。
- 転送元ファイル名および転送先ファイル名を指定し,このパラメーターを省略した場合,savが仮定されます。
- 転送元ファイル名を指定し,転送先ファイル名およびこのパラメーターを省略した場合,delが仮定されます。
- ts3="転送元ファイル名3";
- 転送元ファイル名をフルパス名で定義します。
- 指定できる文字数は,1~511(単位:バイト)です。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- td3="転送先ファイル名3";
- エージェントホストに転送する転送先ファイル名を定義します。
- 指定できる文字数は,1~511(単位:バイト)です。省略した場合,$JP1AJS2_JPQTEMPxx$変数が仮定されます(xxは,転送ファイルの番号で,01~04の値)。sc,prmパラメーターにこの変数を指定すると,転送先ファイル名を意識しないでジョブを実行できます。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- top3={sav|del};
- 転送先ファイルの自動削除オプションを定義します。
- sav:ファイルを保存します。
- del:ファイルを削除します。
- 転送元ファイル名および転送先ファイル名を指定し,このパラメーターを省略した場合,savが仮定されます。
- 転送元ファイル名を指定し,転送先ファイル名およびこのパラメーターを省略した場合,delが仮定されます。
- ts4="転送元ファイル名4";
- 転送元ファイル名をフルパス名で定義します。
- 指定できる文字数は,1~511(単位:バイト)です。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- td4="転送先ファイル名4";
- エージェントホストに転送する転送先ファイル名を定義します。
- 指定できる文字数は,1~511(単位:バイト)です。省略した場合,$JP1AJS2_JPQTEMPxx$変数が仮定されます(xxは,転送ファイルの番号で,01~04の値)。sc,prmパラメーターにこの変数を指定すると,転送先ファイル名を意識しないでジョブを実行できます。
- ファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- キューイング属性あり(jty=q)の場合は,マクロ変数を指定できます。
- top4={sav|del};
- 転送先ファイルの自動削除オプションを定義します。
- sav:ファイルを保存します。
- del:ファイルを削除します。
- 転送元ファイル名および転送先ファイル名を指定し,このパラメーターを省略した場合,savが仮定されます。
- 転送元ファイル名を指定し,転送先ファイル名およびこのパラメーターを省略した場合,delが仮定されます。
- ha={y|n};
- ジョブの実行を保留するかを定義します。省略した場合,nが仮定されます。
- eu={ent|def};
- ジョブ実行時のJP1ユーザーを定義します。省略した場合,entが仮定されます。
- ent:ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。
- def:ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。
- jty={q|n};
- キューイング属性の種別を定義します。省略した場合,qが仮定されます。
- q:キューイング属性あり。
- n:キューイング属性なし。
- mm={and|or};
- 指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。
- 省略した場合はandが仮定されます。
- and:すべての待ち合わせ対象ユニットが終了したら実行を開始する。
- or:待ち合わせ対象ユニットが一つでも終了したら実行を開始する。
- このパラメーターは,JP1/AJS3のデータベース構成が互換用ISAM構成の場合,指定できません。
- nmg={y|n};
- 指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。
- 省略した場合はnが仮定されます。
- このパラメーターは,JP1/AJS3のデータベース構成が互換用ISAM構成の場合,指定できません。
- eun=待ち合わせ対象ユニット名;
- 待ち合わせ対象ユニットとするユニットを,完全名で指定します。
- 待ち合わせ対象ユニットを複数指定する場合,このパラメーターを複数回指定します。最大で32個指定できます。
- 待ち合わせ対象ユニット名に指定できる文字数は1~930(単位:バイト)です。
- このパラメーターは,JP1/AJS3のデータベース構成が互換用ISAM構成の場合,指定できません。