ジョブフローの環境変数

(1) 環境変数を使用できる項目

環境変数は、実行系ジョブステップのユーザJOBおよびDataMagicで使用できます。起動コマンドの引数や、シェルスクリプトなどのユーザプログラム内に環境変数を指定することで、前ジョブステップで生成した値またはイベント通知ユーティリティで指定したメッセージを用いた処理が実行できます。

環境変数は、ユーザJOBおよびDataMagicのプロパティ画面の、次の項目で指定できます。

ユーザJOB

ユーザジョブ設定

(ユーザジョブ設定で指定したシェルスクリプト内でも指定可)

DataMagic

• コマンドライン

• パラメータファイル

• その他のパラメータ指定

(2) 環境変数を用いたジョブフローの実行例1

抽出ファイルをバックアップ（ジョブステップID:JS003）し、抽出ファイルのデータを加工（ジョブステップID:JS004）する例を次に示します。なお、本設定例はHULFT-DataMagic Ver.1を使用した設定例となります。

図2.57 抽出ファイルの操作

A

: ファイルを蓄積待ちします。

環境変数「$JF_JOBFLOWID」(ジョブフローID)、「$JF_SDATE」(ジョブフロー開始日)、「$JF_STIME」(ジョブフロー開始時刻)が生成されます。

B

: Aで蓄積したファイルを抽出します。

環境変数「$JF_JS002_AC00001_SELECTFILENM」(抽出ファイル名)が生成されます。

C

: 次のシェルスクリプトを実行して、ジョブフローID、ジョブフロー開始日、およびジョブフロー開始時刻をファイルに標準出力します。また、Bで抽出したファイルのバックアップを実行します。

環境変数「$JS_BF_ENDCODE」(前実行ジョブステップの完了コード)が生成されます。

#! /usr/bin/sh
echo $JF_JOBFLOWID $JF_SDATE $JF_STIME >> /usr/local/log/user.log
if [ $JS_BF_ENDCODE -eq 0 ]
then
cp $JF_JS002_AC00001_SELECTFILENM $JF_JS002_AC00001_SELECTFILENM.bak
echo $JF_JS002_AC00001_SELECTFILENM is backuped. >> /usr/local/log/user.log
fi

なお、ゴシック部分は環境変数、斜体部分は蓄積識別名です。蓄積識別名は、実行環境によって入る値が異なります。

環境変数に入る値の例を次に示します。

表2.4 環境変数に入る値の例

変換する項目	変数名	変換値
ジョブフローID	$JF_JOBFLOWID	JF001
ジョブフロー開始日	$JF_SDATE	20091001
ジョブフロー開始時刻	$JF_STIME	120000
前実行ジョブステップの完了コード	$JS_BF_ENDCODE	0

D

: 次のコマンドを実行して、抽出ファイルのデータを加工します。

HULFT-DataMagicのコマンドについては以下のマニュアルを参照してください。

HULFT-DataMagic Ver.1の場合

HULFT-DataMagic 運用マニュアル

HULFT-DataMagic Ver.2以降の場合

HULFT-DataMagic リファレンスマニュアル

utled -f /usr/local/datamagic/prm.dat -r -infile $JF_JS002_AC00001_SELECTFILENM

なお、ゴシック部分は環境変数、斜体部分は蓄積識別名です。蓄積識別名は、実行環境によって入る値が異なります。

環境変数に入る値の例を次に示します。

表2.5 環境変数に入る値の例

変換する項目	変数名	変換値
抽出ファイル名	$JF_JS002_AC00001_SELECTFILENM	/usr/local/hub/jobwk/accmfile01.dat

E

: 処理を終了します。

(3) 環境変数を用いたジョブフローの実行例2

単一のジョブフローIDを使用して任意のファイルのデータ加工を行う例を次に示します。なお、本設定例はHULFT-DataMagic Ver.1を使用した設定例となります。

図2.58 指定されたファイルの操作

A

: イベント通知ユーティリティからの通知を待ちます。

以下のパラメータを指定してユーティリティを実行し、ジョブフローを起動します。

utjfevnt –i SMPLJFID –msg0 "data20110301.dat" -msg1 "/usr/local/datadir" -msg2 "/tmp/backupdir" -msg3 "prm01.dat"

指定するパラメータは以下のとおりです。

表2.6 パラメータの意味

パラメータ	環境変数	設定値	説明
-msg0	$JF_MESSAGE0	data20110301.dat	対象ファイル名
-msg1	$JF_MESSAGE1	/usr/local/datadir	対象ファイルがあるディレクトリ
-msg2	$JF_MESSAGE2	/tmp/backupdir	バックアップディレクトリ
-msg3	$JF_MESSAGE3	prm01.dat	パラメータファイル名

B

: 次のシェルスクリプトを実行して、対象ファイルをバックアップします。

#! /usr/bin/sh
echo datafile : ${JF_MESSAGE1}/$JF_MESSAGE0 >> /usr/local/log/user.log
echo parameterfile : $JF_MESSAGE3 >> /usr/local/log/user.log
echo backupfile : ${JF_MESSAGE2}/${JF_MESSAGE0}.bkup >> /usr/local/log/user.log
cp ${JF_MESSAGE1}/$JF_MESSAGE0 ${JF_MESSAGE2}/${JF_MESSAGE0}.bkup

なお、ゴシック部分は環境変数です。

C

: 以下のコマンドを実行して、対象ファイルのデータを加工します。

HULFT-DataMagicのコマンドについては以下のマニュアルを参照してください。

HULFT-DataMagic Ver.1の場合

HULFT-DataMagic 運用マニュアル

HULFT-DataMagic Ver.2以降の場合

HULFT-DataMagic リファレンスマニュアル

utled -f /usr/local/datamagic/$JF_MESSAGE3 -r -infile ${JF_MESSAGE1}/$JF_MESSAGE0

なお、ゴシック部分は環境変数です。

D

: 処理を終了します。