ジョブ実行時に設定される環境変数を次の表に示します。
表1-7 ジョブ実行時に設定される環境変数の一覧
環境変数名 | 意味 |
---|---|
AJSENV | スケジュールに従ってジョブが起動されたことを識別できるようになります。 通常は,YESが設定されます。 |
AJSPRE_ST | 先行ジョブまたは先行ジョブネットの終了状態を表す文字が設定されます。 指定される文字を次に示します。 n:正常終了 w:警告終了 a:異常終了 先行ジョブや先行ジョブネットが複数ある場合は,異常のレベルの高いものが設定されます。先行ジョブや先行ジョブネットがない場合はn(正常終了)が設定されます。再実行時の開始ジョブの場合も,開始ジョブの先行ジョブやジョブネットの状態が設定されます。再実行によって先行ジョブやジョブネットの状態が正常終了や警告終了に変更されると,変更された値が設定されます。 |
AJSPRE_RC | 先行ジョブの戻り値(-2,147,483,648~2,147,483,647の値)が設定されます。先行ジョブが複数ある場合は,すべての戻り値の論理和が設定されます。先行ジョブがない場合は0が設定されます。再実行時の開始ジョブの場合は,前回実行したときの戻り値が設定されます。 |
AJSNETNAME | ルートジョブネット名(899バイト以内の文字列)が設定されます。 |
AJSJOBNAME | ジョブ名(930バイト以内の文字列)が設定されます。 |
AJSHOST | ジョブの実行を依頼したマネージャーホスト名(255バイト以内の文字列)が設定されます。 |
AJS_AJSCONF | ジョブの実行を依頼したマネージャーホストのスケジューラーサービス名(30バイト以内の文字列)が設定されます。 |
AJSEXDATE | ルートジョブネットの実行開始予定日(yyyy/mm/ddの形式)が設定されます。ジョブネットの実行が遅延したり,翌日に再実行したりした場合でも,当初の実行予定日が設定されます。 |
AJSEXECID | ジョブの実行ID(10バイト以内の文字列)が設定されます。 |
AJSEXECPID | 起動条件監視中世代の実行ID(10バイト以内の文字列)が設定されます。 なお,起動条件監視をしていない場合は値なしになります。 |
JP1_HOSTNAME | 論理ホストの場合だけ論理ホスト名が設定されます。※1 |
JP1JobName | 実行ファイル名,またはジョブ名(63バイト以内の文字列)が設定されます。QUEUEジョブまたはjpqjobsubコマンドでジョブ名を指定している場合はそのジョブ名が設定され,PCジョブ,UNIXジョブ,QUEUEジョブ,アクションジョブでジョブ名を指定していない場合は,実行ファイル名が設定されます。 実行ファイル名は,パス情報を除いたファイル名部分の先頭から63バイト分までの文字列が設定されます。 |
JP1JobID | ジョブ番号(1~999,999の値)が設定されます。キューレスジョブの場合,内部で使用するID(10バイト以内の文字列)が設定されます。 |
JP1UserName | ジョブをサブミットしたユーザー名(63バイト以内の文字列)が設定されます。 |
JP1_USERNAME | ジョブをサブミットしたユーザー名(63バイト以内の文字列)が設定されます。 |
JP1UNCName | ジョブを実行しているエージェントホスト名(255バイト以内の文字列)が設定されます。 |
JP1NBQSQueueName | ジョブの登録先であるマネージャーホスト名(255バイト以内の文字列)とキュー名(63バイト以内の文字列)が「¥¥マネージャーホスト名¥キュー名」の形式で設定されます。 実行ホストを指定した場合はキュー名の代わりにエージェントホスト名(255バイト以内の文字列)が設定されます。ただし,キューレスジョブの場合は設定されません。 |
JP1NBQSClientName(Windows限定) | ジョブを投入したクライアントコンピュータ名(15バイト以内の文字列)が設定されます。ただし,キューレスジョブの場合は設定されません。 |
JP1Priority | ジョブの実行優先順位(UNIX版では1~5の値,Windows版では32,64,128のどれかの値(64(低),32(中),128(高)))が設定されます。 |
HOME(UNIX限定) | ジョブに指定した実行ユーザーの,パスワードファイルに定義されているログインディレクトリが設定されます。実行ユーザーが指定されていない場合は,実行ユーザーとして,ジョブネットを登録したJP1ユーザーに対応するOSユーザーが設定されます。 |
SHELL(UNIX限定) | ジョブを実行するための実行シェルが設定されます。実行シェルは,次に示す優先順位に従って決定されます。ジョブの登録方法によって設定されるシェルが異なるため注意が必要です。 優先順位がいちばん高いのは1です。
|
LANG(UNIX限定) | JP1/AJS3起動時の環境変数LANGの値が設定されます。※4 なお,Windows版JP1/AJS3は,通常,ユーザー環境変数を読み込みません。しかし,クラスタをセットアップすると,MSCSの仕様によってユーザー環境変数を読み込みます。 |
LOGNAME(UNIX限定) | ジョブに指定された実行ユーザーのユーザー名が設定されます。実行ユーザーが指定されていない場合は,実行ユーザーとして,ジョブネットを登録したJP1ユーザーに対応するOSユーザーが設定されます。 |
MAIL(UNIX限定) | 「/usr/mail/実行ユーザー名(ジョブに指定された実行ユーザー,またはジョブネットを登録したJP1ユーザーに対応するOSユーザー)」が設定されます。 |
PATH(UNIX限定) | 「/bin:/usr/bin」だけを設定します。※3※4 |
環境変数には,JP1/AJS3で設定されるもの(表1-7の環境変数,ジョブ定義時に指定した環境変数,ジョブ定義時に環境変数ファイルとして指定したファイル内の環境変数)のほかに,ジョブ定義時に指定したコマンド文やスクリプトファイル,ローカルログインスクリプト,システムログインスクリプトにも設定できます。
なお,環境変数TZのように,ジョブ実行時に設定されない環境変数を設定したい場合は,次に示すどれかに設定してください。これらの中で同じ環境変数があった場合,次に示す優先順位に従って有効になります(優先順位がいちばん高いのは1です)。