2.7.2　ジョブネットを定義して実行する

(a)　PCジョブ，UNIXジョブの場合

• Advanced Shellの［実行定義］ダイアログボックスで設定する環境変数

  ADSH_AJS_SCRF：ジョブ定義スクリプトファイル名

  ADSH_AJS_ENVF：ジョブ環境ファイル名

  ADSH_AJS_LHOST：論理ホスト

  ADSH_AJS_GCHE：事前チェック

• Advanced Shellのジョブコントローラに渡す環境変数

  ユニット定義ファイルのenvパラメーターとして環境変数を定義します。

  Advanced Shellのジョブコントローラに渡す環境変数の設定項目を次の表に示します。

  表2‒26　Advanced Shellのジョブコントローラに渡す環境変数の設定項目

  項目名	説明
  入力範囲	環境変数の値として指定できる文字列（"="の後ろの文字列）のバイト数（Shift-JIS）
  設定値	定義できる文字の種類 文字列：制御文字（0x00〜0x1f，0x7f）以外の文字 記号名称：半角英数字および「@」「#」「_」 数字
  初期値	新規作成ジョブとしてカスタムジョブを起動したときに読み込む値
  省略	値を省略できないものは，Advanced Shellのジョブコントローラでエラーとなります。

  Advanced Shellのジョブコントローラに渡す環境変数の設定項目の入力範囲と設定値を次の表に示します。

  表2‒27　Advanced Shellのジョブコントローラに渡す環境変数の設定項目の入力範囲と設定値

  環境変数	入力範囲	設定値	初期値	省略
  ADSH_AJS_SCRF	PCジョブ：1〜247バイト UNIXジョブ：1〜1,023バイト	文字列	空文字列	できない
  ADSH_AJS_ENVF	PCジョブ：0〜247バイト UNIXジョブ：0〜1,023バイト	文字列	空文字列	できる
  ADSH_AJS_LHOST	0〜2バイト	チェックありの場合 -h チェックなしの場合 空文字列	空文字列	できる
  ADSH_AJS_GCHE	0〜2バイト	チェックありの場合 -c チェックなしの場合 空文字列	空文字列	できる
  AJS_BJEX_STOP	4バイト	"TERM"	"TERM"	できない

• Advanced Shellのジョブコントローラに渡すパラメーターの詳細

  フィールド「実行時パラメーター」はユニット定義ファイルのprmパラメーターとして定義し，Advanced Shellのジョブコントローラに対するパラメーターとして渡します。指定できる値は次のとおりです。

  　入力範囲：1〜1,023バイト^※

  　設定値：文字列

  　初期値：空文字列

  　省略：できる

  実行時パラメーターでは，［実行定義］ダイアログボックスの指定の空文字列と同等の定義をする場合は，ユニット定義ファイルのprmパラメーターにスペース1バイト分を定義してください。

  注※

  prmパラメーターに1,023バイトまで入力できるのは，スペースだけの文字列だけです。スペース以外の文字列を入力する場合は1,022バイトまでで指定してください。prmパラメーターにスペースだけの文字列を指定した場合，［実行定義］ダイアログボックスの［実行時パラメーター］のテキストボックスにスペースを1バイト分削除して表示します。

  重要

  ユニット定義ファイルで定義情報を削除する場合は，次の点に注意してください。

  ・envパラメーターは環境変数の値（「=」の後ろの文字列）を削除するか，envパラメーターの指定そのものを削除してください。

  ・prmパラメーターはprmの値に1バイト分のスペースを指定するか，prmパラメーターの指定を削除してください。

ユニット定義の例を次に示します。

unit=ユニット名,,実行ユーザー,;
{
        ty=cpj;
        cty="ADSHUX";
        sc="/opt/jp1as/bin/adshexec";
        env="AJS_BJEX_STOP=TERM";                               →1.
        env="ADSH_AJS_SCRF=/tmp/JP1AS/scr/samplescrfile.ash";   →2.
        prm="param1 param2";                                    →3.
        env="ADSH_AJS_ENVF=/tmp/JP1AS/env/sampleenvfile";       →4.
        env="ADSH_AJS_LHOST=-h";                                →5.
        env="ADSH_AJS_GCHE=-c";                                 →6.
        tho=0;
}

例の右側に付記した番号に対応する説明を次に示します。

1. AJS_BJEX_STOP：AJS_BJEX_STOP環境変数はシステムで使用するため，設定値にTERMを指定して必ず定義してください。

2. ADSH_AJS_SCRF：ジョブ定義スクリプトファイル名を指定します。

   ADSH_AJS_SCRF環境変数は必ず定義してください。

3. ユニット定義ファイルのprmパラメーターを指定します。

4. ADSH_AJS_ENVF：ジョブ環境ファイル名を指定します。

5. ADSH_AJS_LHOST：論理ホストで実行する場合は-hを指定し，実施しない場合は何も指定しません。

6. ADSH_AJS_GCHE：事前チェックを実施する場合は-cを指定し，実施しない場合は何も指定しません。

ユニット定義ファイルを作成したあと，JP1/AJSのajsdefineコマンドおよびJP1/AJS3 - Definition Assistantでジョブを定義できます。

(b)　GUIアプリケーション実行ジョブの場合

• Advanced Shellの［実行定義］ダイアログボックスで設定する環境変数

  ADSH_AJS_APPNAME：実行アプリケーションのパス名

  ADSH_AJS_APPARG：実行アプリケーションの引数

  ADSH_AJS_WORKF：ワークフォルダ

  ADSH_AJS_SHOWN：表示名

  ADSH_AJS_AFEXECMV：実行アプリケーション実行後の動作

  ADSH_AJS_MESOUT：メッセージの出力

• GUIアプリケーション実行プログラムに渡す環境変数

  ユニット定義ファイルのenvパラメーターとして環境変数を定義します。

  GUIアプリケーション実行プログラムに渡す環境変数の設定項目を次の表に示します。

  表2‒28　Advanced Shellのジョブコントローラに渡す環境変数の設定項目

  項目名	説明
  入力範囲	環境変数の値として指定できる文字列（"="の後ろの文字列）のバイト数（Shift-JIS）
  設定値	定義できる文字の種類 文字列：制御文字（0x00～0x1f，0x7f）以外の文字 記号名称：半角英数字および「@」「#」「_」 数字
  初期値	新規作成ジョブとしてカスタムジョブを起動したときに読み込む値
  省略	値を省略できないものは，GUIアプリケーション実行プログラムでエラーとなります。

  GUIアプリケーション実行プログラムに渡す環境変数の設定項目の入力範囲と設定値を次の表に示します。

  表2‒29　GUIアプリケーション実行プログラムに渡す環境変数の設定項目の入力範囲と設定値

  環境変数	入力範囲	設定値	初期値	省略
  ADSH_AJS_APPNAME	1～247バイト	文字列	空文字列	できない
  ADSH_AJS_APPARG	0～1,023バイト	文字列	空文字列	できる
  ADSH_AJS_WORKF	0～247バイト	文字列	空文字列	できる
  ADSH_AJS_SHOWN	0～247バイト	文字列	空文字列	できる
  ADSH_AJS_AFEXECMV	0～2バイト	チェックありの場合 -n チェックなしの場合 空文字列	空文字列	できる
  ADSH_AJS_MESOUT	0～2バイト	チェックありの場合 -m チェックなしの場合 空文字列	空文字列	できる
  ADSH_AJS_APPEXEC	7バイト	" APPEXEC "	" APPEXEC "	できない

重要

ユニット定義ファイルで定義情報を削除する場合は，envパラメーターは環境変数の値（「=」の後ろの文字列）を削除するか，envパラメーターの指定そのものを削除してください。

ユニット定義の例を次に示します。

unit=ユニット名,,実行ユーザー,;
{
        ty=cpj;
        cty="ADSHAPPEXEC";
        sc=" C:\Program Files\HITACHI\JP1AS\JP1ASE\bin\adshappexec.exe";
        env="ADSH_AJS_APPEXEC=APPEXEC";                           →1.
        env="ADSH_AJS_APPNAME=C:\ExecApp.exe";                    →2.
        env="ADSH_AJS_APPARG=param1 param2";                      →3.
        env="ADSH_AJS_WORKF=C:\work-folder";                      →4.
        env="ADSH_AJS_SHOWN=ExecApplication";                     →5.
        env="ADSH_AJS_AFEXECMV=-n";                               →6.
        env="ADSH_AJS_MESOUT=-m";                                 →7.
        tho=0;
}

例の右側に付記した番号に対応する説明を次に示します。

1. ADSH_AJS_APPEXEC環境変数はシステムで使用するため，設定値にAPPEXECを指定して必ず定義してください。

2. ADSH_AJS_APPNAME：実行アプリケーションのパス名を指定します。

   ADSH_AJS_APPNAMEは必ず定義してください。

3. ADSH_AJS_APPARG：実行アプリケーションの引数を指定します。

4. ADSH_AJS_WORKF：ワークフォルダを指定します。

5. ADSH_AJS_SHOWN：表示名を指定します。

6. ADSH_AJS_AFEXECMV：実行アプリケーション実行後の動作で終了を待たない場合は-nを指定し，実施しない場合は何も指定しません。

7. ADSH_AJS_MESOUT：標準エラー出力への出力を抑止する場合は-mを指定し，実施しない場合は何も指定しません。

ユニット定義ファイルを作成したあと，JP1/AJSのajsdefineコマンドおよびJP1/AJS3 - Definition Assistantでジョブを定義できます。