引き継ぎ情報設定ジョブを使用するための，先行ジョブ，引き継ぎ情報設定ジョブ，および後続ユニットの定義方法について説明します。

(a)　引き継ぎ情報設定ジョブの先行ジョブ

引き継ぎ情報設定ジョブの先行ジョブは，次の条件をすべて満たしている必要があります。

• 先行ジョブが一つ以上ある
• 先行ジョブのうち，次の条件をすべて満たすものが一つだけある
  
  • PCジョブ^※1，UNIXジョブ^※1，およびカスタムジョブのどれか
  • 標準出力ファイル名に，ファイル名または「$JP1AJS2_JPQSTDOUTTEMP$」の指定がある^※2
  • 実行したときに結果を標準出力ファイルに出力する

  注※1

  キューレスジョブを除きます。

  注※2

  ジョブの標準出力ファイルをエージェントホストに残したい場合は，ファイル名を指定します。指定したファイルがマネージャーホストに転送されても，エージェントホストに残ります。

  ジョブの標準出力ファイルをエージェントホストに残す必要がない場合は，「$JP1AJS2_JPQSTDOUTTEMP$」を指定します。この場合，標準出力ファイルは，エージェントホストの一時ファイルに出力され，マネージャーホストに転送されます。追加書きを指定しても無効です。マネージャーホストに転送されたファイルのファイル名は，ajsshowコマンドの-iオプションに2バイトフォーマット指示子の「%so」を指定すると確認できます。

注意事項

• 引き継ぎ情報設定ジョブを判定ジョブの従属ジョブとして定義した場合は，判定ジョブの先行ジョブが引き継ぎ情報設定ジョブの先行ジョブとして扱われます。そのため，判定ジョブの先行ジョブに標準出力ファイル名の指定が必要です。
• ファイル受信制限の設定によって標準出力ファイルの受信処理が中止された場合，標準出力ファイルが完全に作成されません。このような場合，不完全な標準出力ファイルでも引き継ぎ情報設定ジョブで情報が切り出せるかどうか確認してください。

(b)　引き継ぎ情報設定ジョブ

引き継ぎ情報設定ジョブには，次の指定をします。

正規表現

先行ジョブが出力した標準出力ファイルから必要な情報を切り出すための，正規表現を指定します。

出力マクロ変数

正規表現に従って切り出した情報を設定する，マクロ変数名を指定します。

先行ジョブが出力した標準出力ファイルのどの行にも正規表現が一致しない場合，出力マクロ変数にはNULL文字列が設定されます。

引き継ぎ情報設定ジョブが実行終了したときの戻り値を，次の表に示します。

表2-19　引き継ぎ情報設定ジョブの戻り値

戻り値	条件
0	すべての正規表現が一致した場合
1	一致しない正規表現が一つ以上あった場合
20以上	その他のエラーが発生した場合

一致しない正規表現があっても後続ユニットの実行を継続したい場合は，引き継ぎ情報設定ジョブの異常しきい値を「1」に設定してください。

実行終了した引き継ぎ情報設定ジョブを再実行すると，出力マクロ変数には，再実行時の標準出力ファイルおよび正規表現に従って切り出した情報が再設定されます。

引き継ぎ情報設定ジョブで指定した正規表現は，使用する正規表現をJP1/Baseで拡張しているかどうかに関係なく，拡張正規表現として扱われます。拡張正規表現の詳細については，マニュアル「JP1/Base 運用ガイド」の，拡張正規表現について記載されている個所を参照してください。

拡張正規表現の指定方法を次に示します。

• 切り出したい部分を「(」と「)」で囲む。
• 「.（ピリオド）」は，改行文字以外の任意の1文字を意味する。
• 「$」は，末尾指定（後方一致）を意味する。

注意事項

• 複数組の「(」および「)」を指定した場合は，いちばん左の組での指定と一致する文字列が切り出されます。
• 「(」および「)」を指定しない場合は，拡張正規表現全体と一致する文字列が切り出されます。
• 行単位に，指定した拡張正規表現で切り出します。複数行にわたる切り出しはできません。
• 「(」に対応する「)」がないなど，文法が正しくない拡張正規表現を指定した場合，引き継ぎ情報設定ジョブは異常終了します。
• 標準出力ファイルの1行当たりの長さは，最大1,024バイトです。1,024バイトを超える行に対して切り出し処理を実行すると，引き継ぎ情報設定ジョブが異常終了します。

拡張正規表現で切り出される情報の例を，次の表に示します。

表2-20　拡張正規表現の指定例

切り出し対象の 文字列	パターン	拡張正規表現	切り出される情報
abcdefghi	一組の「(」「)」を指定	abc(...)ghi	def
	複数組の「(」「)」を指定	abc(.)(.)(.)ghi	d
	「(」「)」を指定しない	...$	ghi

(c)　引き継ぎ情報設定ジョブの後続ユニット

引き継ぎ情報設定ジョブの出力マクロ変数に指定した，マクロ変数名を指定します。

引き継ぎ情報の有効範囲は，ルートジョブネット配下です。ただし，引き継ぎ情報設定ジョブで切り出した引き継ぎ情報がマクロ変数に設定されるのは，引き継ぎ情報設定ジョブの実行後です。引き継ぎ情報設定ジョブの実行前は，マクロ変数に設定された値を参照できません。引き継ぎ情報設定ジョブが設定したマクロ変数は，ジョブの再実行時にもそのまま使用されます。

次の条件を例に，実行したジョブとマクロ変数の値について説明します。

• ジョブAおよびジョブBに，マクロ変数「?AJS2PRM?」を定義
• 引き継ぎ情報設定ジョブに，「?AJS2PRM?」に「PARAM」を指定
  

  図2-89　引き継ぎ情報設定ジョブの例

  

この図の場合で，実行したジョブとその時点でのマクロ変数の値について次の表に示します。

表2-21　実行したジョブとマクロ変数の値

実行したジョブ	マクロ変数の値
ジョブA	?AJS2PRM?
引き継ぎ情報設定ジョブ	−
ジョブB	PARAM
ジョブA（再実行）	PARAM

引き継ぎ情報設定ジョブが含まれるジョブネットの定義によって，引き継ぎ結果の参照可否が異なります。

引き継ぎ結果の確認方法については，「2.2.6(2) マクロ変数の確認」を参照してください。

引き継ぎ結果の参照可否について説明します。

(a)　関連線がない

引き継ぎ情報設定ジョブと関連線がないジョブの場合，引き継ぎ情報設定ジョブが先に実行されていれば参照できます。

図2-90　関連線がない例

この図の場合の，引き継ぎ結果の参照可否について次の表に示します。

表2-22　関連線がない場合の参照可否

ジョブ	引き継ぎ結果の参照可否
ジョブA	引き継ぎ情報設定ジョブが先に実行されていれば，参照できる。再実行時も同様。 引き継ぎ情報設定ジョブがあとで実行された場合は，参照できない。
ジョブB	引き継ぎ情報設定ジョブが先に実行されていれば，参照できる。再実行時も同様。 引き継ぎ情報設定ジョブがあとで実行された場合は，参照できない。
ジョブC	ルートジョブネット実行時は参照できない。 ジョブCの再実行時は参照できる。

(b)　ネストジョブネット

ネストジョブネット中の引き継ぎ情報設定ジョブの引き継ぎ結果は，ルートジョブネット中のジョブでも参照できます。

図2-91　ネストジョブネットの例

この図の場合の，引き継ぎ結果の参照可否について次の表に示します。

表2-23　ネストジョブネットの場合の参照可否

ジョブ	引き継ぎ結果の参照可否
ジョブA	ルートジョブネット実行時は参照できない。 ジョブAの再実行時は参照できる。
ジョブB	参照できる。
ジョブC	ルートジョブネット実行時は参照できない。 ジョブCの再実行時は参照できる。
ジョブD	参照できる。

(c)　リモートジョブネット

リモートジョブネットを含むジョブネットに引き継ぎ情報設定ジョブを定義している場合の，引き継ぎ結果の参照可否について説明します。

●ルートリモートジョブネットの場合

ルートリモートジョブネットに引き継ぎ情報設定ジョブがある場合，ルートリモートジョブネット内で引き継ぎ結果を参照できます。

図2-92　ルートリモートジョブネットの例

この図の場合の，引き継ぎ結果の参照可否について次の表に示します。

表2-24　ルートリモートジョブネットの場合の参照可否

ジョブ	引き継ぎ結果の参照可否
ジョブA	ルートジョブネット実行時は参照できない。 ジョブAの再実行時は参照できる。
ジョブB	参照できる。

●ネストリモートジョブネットの場合（ルートジョブネット中に引き継ぎ情報設定ジョブがある）

ルートジョブネット中に引き継ぎ情報設定ジョブがある場合，ルートジョブネット内のジョブだけ引き継ぎ結果を参照できます。ネストリモートジョブネット内のジョブでは参照できません。

図2-93　ネストリモートジョブネット（ルートジョブネット中に引き継ぎ情報設定ジョブがある）の例

この図の場合の，引き継ぎ結果の参照可否について次の表に示します。

表2-25　ネストリモートジョブネット（ルートジョブネット中に引き継ぎ情報設定ジョブがある）の場合の参照可否

ジョブ	引き継ぎ結果の参照可否
ジョブA	ルートジョブネット実行時は参照できない。 ジョブAの再実行時は参照できる。
ジョブB	参照できる。
ジョブC	参照できない。
ジョブD	参照できない。

●ネストリモートジョブネットの場合（ネストリモートジョブネット中に引き継ぎ情報設定ジョブがある）

ネストリモートジョブネット中に引き継ぎ情報設定ジョブがある場合，ネストリモートジョブネット内のジョブだけ引き継ぎ結果を参照できます。ルートジョブネット内のジョブでは参照できません。

図2-94　ネストリモートジョブネット（ネストリモートジョブネット中に引き継ぎ情報設定ジョブがある）の例

この図の場合の，引き継ぎ結果の参照可否について次の表に示します。

表2-26　ネストリモートジョブネット（ネストリモートジョブネット中に引き継ぎ情報設定ジョブがある）の場合の参照可否

ジョブ	引き継ぎ結果の参照可否
ジョブA	参照できない。
ジョブB	参照できない。
ジョブC	ルートジョブネット実行時は参照できない。 ジョブCの再実行時は参照できる。ただし，ネストリモートジョブネットを再実行した場合は，再実行後でも参照できない。
ジョブD	参照できる。

(d)　ジョブネットコネクタ

ジョブネットコネクタを定義しているジョブネットまたは接続先ジョブネットで定義した引き継ぎ情報設定ジョブの引き継ぎ結果は，引き継ぎ情報設定ジョブがある側のジョブネットだけ参照できます。

●ジョブネットコネクタを定義しているジョブネットに引き継ぎ情報設定ジョブがある場合

ジョブネットコネクタを定義しているジョブネットだけ引き継ぎ結果を参照できます。

図2-95　ジョブネットコネクタを定義しているジョブネットに引き継ぎ情報設定ジョブがある例

この図の場合の，引き継ぎ結果の参照可否について次の表に示します。

表2-27　ジョブネットコネクタを定義しているジョブネットに引き継ぎ情報設定ジョブがある場合の参照可否

ジョブ	引き継ぎ結果の参照可否
ジョブA	ルートジョブネット実行時は参照できない。 ジョブAの再実行時は参照できる。
ジョブB	参照できる。
ジョブC	参照できない。
ジョブD	参照できない。

●接続先のジョブネットに引き継ぎ情報設定ジョブがある場合

接続先のジョブネットだけ引き継ぎ結果を参照できます。

図2-96　ジョブネットコネクタの接続先ジョブネットに引き継ぎ情報設定ジョブがある例

この図の場合の，引き継ぎ結果の参照可否について次の表に示します。

表2-28　ジョブネットコネクタの接続先ジョブネットに引き継ぎ情報設定ジョブがある場合の参照可否

ジョブ	引き継ぎ結果の参照可否
ジョブA	参照できない。
ジョブB	参照できない。
ジョブC	ルートジョブネット実行時は参照できない。 ジョブCの再実行時は参照できる。
ジョブD	参照できる。

(e)　待ち合わせ条件

待ち合わせ条件付きユニットと，その待ち合わせ対象ユニットが別のルートジョブネット配下にある場合，引き継ぎ結果はそれぞれのルートジョブネット配下だけ参照できます。

図2-97　待ち合わせ条件を使用した例

この図の場合の，引き継ぎ結果の参照可否について次の表に示します。

表2-29　引き継ぎ情報設定ジョブAの引き継ぎ結果の参照可否

ジョブ	引き継ぎ結果の参照可否
ジョブA	ルートジョブネットA実行時は参照できない。 ジョブAの再実行時は参照できる。
ジョブB	参照できる。
ジョブC	参照できない。
ジョブD	参照できない。
ジョブE	参照できない。

表2-30　引き継ぎ情報設定ジョブBの引き継ぎ結果の参照可否

ジョブ	引き継ぎ結果の参照可否
ジョブA	参照できない。
ジョブB	参照できない。
ジョブC	ルートジョブネットB実行時は参照できない。 ジョブCの再実行時は参照できる。
ジョブD	参照できる。
ジョブE	参照できる。

引き継ぎ情報設定ジョブを使用する場合の注意事項を，次に示します。

• 引き継ぎ情報設定ジョブを，JP1/AJS3 - Managerのバージョンが09-50より前の環境にコピーして使用した場合，引き継ぎ情報設定ジョブの実行時にエラーになります。
• 引き継ぎ情報設定ジョブには，実行エージェントを指定できません。実行登録されたマネージャーホストのデフォルト実行エージェント「@SYSTEM」で実行されます。リモートジョブネット配下の引き継ぎ情報設定ジョブは，そのリモートジョブネットの転送先ホスト上のデフォルト実行エージェントで実行されます。
• 一つのルートジョブネット配下に，同じ名称のマクロ変数を指定した引き継ぎ情報設定ジョブが複数ある場合，あとから実行した引き継ぎ情報設定ジョブの引き継ぎ情報が有効です。