JP1/AJS2のコマンド実行時に使用される環境変数と,JP1/AJS2から実行されるジョブ実行時に設定される環境変数を示します。
JP1/AJS2のコマンド実行時に使用される環境変数
コマンド実行時に使用される環境変数を次の表に示します。
表1-6 コマンド実行時に使用される環境変数の一覧
環境変数名 | 内容 | 参照契機 |
---|---|---|
AJSMANAGERHOST | 操作先ホストの論理ホスト名 | ジョブネットワーク要素を操作するコマンド※1,およびajsstatusコマンドをリモート実行するとき,ユニット名指定時に論理ホスト名が省略された場合。 |
JP1_HOSTNAME | 自ホストの論理ホスト名 | JP1/AJS2が自ホストの論理ホスト名を参照する場合。 または,コマンド実行時に操作対象の論理ホストを参照する場合(コマンドのオプションとして,論理ホスト名を指定しなかった場合)。※2 |
AJSCONF | スケジューラーサービス名 | オブジェクト名指定時に,スケジューラーサービス名が省略され,かつ,-Fオプションのスケジューラーサービス名が省略された場合。 |
AJSPATH | AJSパス名 | ジョブネットワーク要素を操作するコマンド※1に,ユニット名が完全名で指定されなかった場合(ジョブグループ名として利用します)。 |
JP1_USERNAME | JP1ユーザー名 | ジョブネットワーク要素を操作するコマンド※1でユーザーのアクセス権限取得時に,OSのユーザー名と異なるJP1ユーザー名を利用する場合。 |
LANG | 言語種別 | 出力するテキストの言語種別を切り分ける場合。 Windowsの場合はホストの設定に依存するため,利用されません。 ジョブネットワーク要素を操作するコマンド※1を実行する場合,コマンドの実行対象ユニットが定義されているスケジューラサービスのAJSCHARCODEパラメーターの設定と同じ言語種別を設定してください。 |
TZ | タイムゾーン | スケジュールを計算する場合や,日時を表示する場合。※3 |
AJSAUTOJUDGE | プランニンググループの下にあるユニットの中から操作対象を自動選択する機能の指定 | 次に示すコマンドで,-Xオプションを省略した場合。※4
|
AJSDISPSUBUNITTYPE | ジョブグループ種別の表示・非表示 | ajsrestoreコマンドで,退避ボックスの中に退避したジョブネットワーク要素の一覧を標準出力ファイルに出力する場合。※5 |
AJSCONVERTUTF8 | 文字コード変換 | コマンドのリモート実行時に実行先ホストの環境変数LANGがja_JP.UTF-8またはja_JP.utf8の場合で,JP1/AJS2 - Managerの通信処理で文字コード変換を行わないとき。※6 |
JP1/AJS2から実行されるジョブ実行時に設定される環境変数
ジョブ実行時に設定される環境変数を次の表に示します。
表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/AJS2起動時の環境変数LANGの値が設定されます。 なお,Windows版JP1/AJS2は,通常,ユーザー環境変数を読み込みません。しかし,クラスタシステムをセットアップすると,MSCSの仕様によってユーザー環境変数を読み込みます。 |
LOGNAME(UNIX限定) | ジョブに指定された実行ユーザーのユーザー名が設定されます。実行ユーザーが指定されていない場合は,実行ユーザーとして,ジョブネットを登録したJP1ユーザーに対応するOSユーザーが設定されます。 |
MAIL(UNIX限定) | 「/usr/mail/実行ユーザー名(ジョブに指定された実行ユーザー,またはジョブネットを登録したJP1ユーザーに対応するOSユーザー)」が設定されます。 |
PATH(UNIX限定) | 「/bin:/usr/bin」だけを設定します。※3 |
環境変数には,JP1/AJS2で設定されるもの(表1-7の環境変数,ジョブ定義時に指定した環境変数,ジョブ定義時に環境変数ファイルとして指定したファイル内の環境変数)のほかに,ジョブ定義時に指定したコマンド文やスクリプトファイル,ローカルログインスクリプト,システムログインスクリプトにも設定できます。これらの中で同じ環境変数があった場合,次に示す優先順位に従って有効になります(優先順位がいちばん高いのは1です)。