0 / 0
資料の 英語版 に戻る

DataStage のマクロ

最終更新: 2025年3月12日
DataStage のマクロ

DataStage® には、いくつかの組み込みマクロがあります。 これらのマクロを使用して、ジョブのメタデータを追跡できます。 これらのマクロは、式、ジョブ制御ルーチン、およびジョブ前サブルーチンとジョブ後サブルーチンで使用できます。

マクロを選択するには、 DataStage で式エディターを開き、マクロのリストを開きます。

使用可能なマクロについては、以下のリストを参照してください。
  • DSFlowName
  • DSHostName
  • DSJobName
  • DSJobStartDate
  • DSJobStartTime
  • DSJobStartTimestamp
  • DSJobWaveNo
  • DSProjectName
  • DSProjectDirectory
  • DSStageName
  • DSProjectId
  • DSJobRunId
  • DSJobId
  • DSJobController
DSJobController
現在のジョブを開始したジョブ名を返します。 DSJobController、親パイプラインに 'DSJobInvocationId の値があれば、値 '<parent flow name>.<parent job invocation id>を返す。 親パイプラインに呼び出しIDの値がない場合、その値は'<parent flow name>として返される。
以下のコードは、これらのマクロのサンプル値を示しています。
DSFlowName=macroTest
DSHostName=ds-px-runtime-5d5544db9c-rkn97
DSJobName=macroTest.DataStage job
DSJobStartDate=2022-11-21
DSJobStartTime=16:37:38
DSJobStartTimestamp=2022-11-21 16:37:38
DSProjectDirectory=/tmp/PXRuntime/Projects/428f037a-250b-48f0-80a7-712bc75c233d
DSProjectName=ys1dev-new
DSStageName=joincustomers
GetEnvironment(env_name) を使用して、以下の環境変数を取得することもできます。
  • アプリケーション・ジョブ ID
  • アプリケーション・ジョブの実行 ID
  • API ジョブ・ランタイム・パス
  • {{apt_project_id}}
  • ホスト名
以下のコードは、これらの環境変数のサンプル値を示しています。
APT_JOB_ID=86f85414-bd62-4483-85b0-bb0dea964096
APT_JOB_RUN_ID=225983db-a99f-436d-b8d8-a096bf60b4b9
APT_JOB_RUN_PATH=/ds-storage/PXRuntime/Projects/7cae4661-f899-45f0-b2aa-449c7b8041cf/jobs/86f85414-bd62-4483-85b0-bb0dea964096/runs/225983db-a99f-436d-b8d8-a096bf60b4b9
APT_PROJECT_ID=7cae4661-f899-45f0-b2aa-449c7b8041cf
HOSTNAME=ds-px-default-ibm-datastage-px-runtime-85bbb6c4d8-fv54k