Interstage Job Workload Server バッチ開発ガイド

2.2.5.2 置換えパラメタの指定形式

置換えパラメタの指定形式は以下のとおりです。

${置換えパラメタ}

• 複数指定の場合
  入力域中に複数の置換えパラメタを指定します。
• 単一指定の場合
  入力域中に1つだけ置換えパラメタを指定します。複数の置換えパラメタを指定した場合はエラーとなります。

• 置換えパラメタに指定できる文字
  • 置換えパラメタ
    • 入力文字数：1〜64バイト（${}を除く）
    • 文字種：半角英文字（大文字／小文字の区別あり）、半角数字、半角記号(“_”,“-”)
    • 先頭は英文字
  • 置換えパラメタの値
    • 入力文字数：1〜256バイト
    • 文字種：入力した値がそのままパラメタ値として渡ります。

  

  • 置換えパラメタに指定できない文字を設定した場合は、指定された文字どおりに取り扱い、置換えパラメタとして取り扱いません。
  • 置換えパラメタに予約語を指定した場合は、置換えパラメタの値を指定する必要はありません。
  • 置換えパラメタの値の入力文字数は、置換えパラメタを設定する入力域の最大長（置換えパラメタなし）に依存します。入力域の最大長については、“置換えができるパラメタの入力域と指定できるパラメタの最大数／最大長”を参照してください。

• 置換えパラメタの指定方法
  • ジョブ定義、ジョブステップ定義、およびプロシジャ呼出しステップ定義の置換えパラメタは、ジョブの投入時にパラメタとして指定します。ジョブの投入時に指定したパラメタと置換えパラメタの関係を以下に示します。

    [ジョブスケジューラから実行した場合]

    

    [コマンドから実行した場合]

    

  
  ジョブの投入時の指定では、プロシジャ定義中の置換えパラメタの指定を直接行うことはできません。プロシジャ内のジョブステップ定義の置換えパラメタは、プロシジャ定義またはプロシジャ呼出しステップ定義から指定します。

  
  プロシジャ呼出しステップ定義の置換えパラメタの値に置換えパラメタを指定することで、プロシジャ内のジョブステップ定義中の置換えパラメタをジョブの投入時のパラメタ指定で置き換えられます。

• 置換えパラメタの置換順番
  置換えパラメタの置換は以下の順に行います。

  契機	順番	置換処理
  ジョブ投入時	1	ジョブの投入時に指定した置換えパラメタを置換する。
  	2	ジョブ定義とジョブステップ定義の中で値が指定されていない置換えパラメタは空文字列（“”）に置換する。
  プロシジャ呼出し時	3	プロシジャ呼出しステップ定義で指定した置換えパラメタを置換する。
  	4	プロシジャ定義で指定した置換えパラメタを置換する。
  	5	プロシジャ内のジョブステップ定義の中で値を指定していない置換えパラメタは空文字列（“”）に置換する。

以下に置換えパラメタの指定から置き換えるまでの流れを示します。図中の数字は上記の表の順番に対応しています。