casout コマンドまたは cassub コマンドで /jrestart パラメーターを使用してジョブを再開する際、パラメーターの指定でステップ、プロシージャ、条件、MF_UCC11 の値などを識別または変更できます。
Notes:
- スラッシュ (/) の代わりにダッシュ文字 (-) を使用できます。
- ほとんどのパラメーターは、大文字と小文字が区別されます。たとえば、ステップ名およびプロックステップ名は大文字で指定する必要があります。
ジョブを再開するステップまたはプロックステップを識別
指定したステップからジョブを再開するには、次の形式を使用します。オプションでプロックステップも指定できます。
casout /r<Servername>
/jrestart:<job-number>#f<step-name(instance-number)>[:
<proc-step-name>]
たとえば、ステップ 20 からジョブ 1051 を再開するには次のようにします。
casout /rTST /jrestart:1051#fSTEP20
ジョブの最初のステップからジョブを再開するには、ステップを指定する代わりに $FIRST を使用します。たとえば、ジョブ番号 1006 を最初のステップから再開します。
casout /rTST /jrestart:1006#f$FIRST
注: UNIX プラットフォームでは、$FIRST を強化された再開モードで使用できるように指定する場合、バックスラッシュ (
\) を
casout、
cassub、および
mfbsijcl コマンド ラインに使用して $ 文字をエスケープしていることを確認してください。次に例を示します。
casout /rTST /jrestart:1006#f\$FIRST
重複するステップ名を含むジョブで再開するステップを識別
ジョブに重複するステップ名が含まれている場合、
#f パラメーターと
<step-name> および
<proc-step-name> (オプション) を次の形式で使用して開始するステップを指定できます。
casout /r<Servername>
/jrestart:<job-number>#f<step-name(instance-number)>[:
<proc-step-name(instance-number)>]
たとえば、3 番目の STEP2 のステップ内の最初の PSTEP からジョブを再開するには、次のように入力します。
casout /rTST /jrestart:1006#fSTEP2(3):PSTEP(1)
再開時に MF_UCC11 環境変数の値を変更
再開時に
MF_UCC11 の値を変更するには、
#m パラメーターを使用します。次に例を示します。
casout /rTST /jrestart:1006#fSTEP2(3):PSTEP(1)#mY
#m の有効な値は次のとおりです。
- Y
- MF_UCC11 の処理をオンにする (MF_UCC11=Y と同じ)
- N
- MF_UCC11 の処理をオフにする (MF_UCC11=N と同じ)
- M
- MF_UCC11 の処理を MOD に設定する (MF_UCC11=M と同じ)
この環境変数の詳細については、「ジョブの再起動機能の有効化」および「MF_UCC11」を参照してください。
終了するステップを識別
再開したジョブを終了するステップを識別するには、
#t パラメーターを次の形式で使用します。
casout /r<Servername>
/jrestart:<job-number>#f<step-name(instance-number)>[:
<proc-step-name(instance-number)>]#t<step-name(instance-number)>[:
<proc-step-name(instance-number)>]
たとえば、3 番目の STEP2 のステップ内の最初の PSTEP からジョブ 1006 を再開し、最初の STEP4 のステップ内の 2 番目の PSTEP までで実行を終了するには、次のように入力します。
casout /rTST /jrestart:1006#fSTEP2(3):PSTEP(1)#tSTEP4(1):PSTEP(2)
終了ステップは実行に含まれます。
前回実行時の条件コードおよび異常終了コードを使用して再開
異常終了および条件コード回復 (ACR) を使用すると、ジョブを再開するときに
#k パラメーターを使用して前回実行時のステップの COND コードおよび ABEND コードを使用できます。
#k パラメーターには 2 つのフィールドがあります。1 つ目は前回の ABEND コードを使用するかどうかを示し、2 つ目は前回の COND コードを使用するかどうかを示します。
#k<abend-field><condition-field>
両方のフィールドの許容される値は次のとおりです。
- Y
- 前回のコードを使用します。
- N
- 前回のコードを使用しません。
- R
- RC=0 にリセットします。
- D
- これがデフォルト値です。これは Y と同じです。
デフォルト値は Y です。
たとえば、前回の実行で異常終了したステップを RC=0 にリセットし、それ以外のステップについては前回実行時の COND コードを維持するには、次のように入力します。
casout /rTST /jrestart:1006#fSTEP2(3):PSTEP(1)#tSTEP4(1):PSTEP(2)#kRY
ステップ固有の条件コードを使用して再開
#c パラメーターを ACR オプションの補足として使用するか単独で使用して、個々の COND コードを指定したり、前回のすべての COND コードを使用するように指定したりできます。これらのオプションを使用すると、ジョブを再実行したり、以降の条件の評価で使用するステップの
COND コードを変更したりできます。
#c パラメーターは、ステップ名、プロシージャ名、およびステップのインスタンス番号 (オプション) と使用する値を識別します。
#c{<step-name(instance-number)>[:
<proc-step-name(instance-number)>] | $ALL}:value}[...] value は 1 から 255 (ジョブの最大ステップ数) までの任意の数値です。
たとえば、3 番目の STEP20 にある 2 番目の PSTEP10 の COND コードを値 1 に設定するには、次のように入力します。
#cSTEP20(3):PSTEP10(2):1
次に、#c パラメーターを casout /jrestart および他のオプションとともに使用した例を示します。
casout /rTST /jrestart:1006#fSTEP2(3):PSTEP(1)
#tSTEP4(1):PSTEP(2)#c$ALL:5#cSTEP20(1):4
#cSTEP20(3):10
すべてのステップの COND コードを 5 に設定してから、最初の STEP20 の値を 4 に設定し、3 番目の STEP20 の値を 10 に設定しています。
注: ACR が設定されておらず、ステップ固有の条件コードも設定されていない場合は、最後に実行されたステップ条件コードがロードされます。ただし、ステップ COND チェックは、再開ステップで起動するステップに対してのみ実行されます。再開ステップ以前のステップは実行されていないとみなされるため、FALSE
と評価されます。ただし、IF/THEN/ELSE テストでは、前回実行したステップの結果が使用されます。これは既存の Micro Focus 再開処理と同等です。
条件コードの組み合わせを使用した再開
前回の実行 (
#k) およびステップ固有の条件コード (
#c) から、COND コードおよび ABEND コードを組み合わせて使用できます。この場合、次の点を考慮してください。
- #k パラメーターを使用して ACR を任意の値 (Y、N、R、または D) に設定するか、または #c パラメーターを使用してステップ固有の条件コードを設定する (あるいはその両方) と、すべてのステップに対してステップ COND チェックおよび IF/THEN/ELSE チェックが実行されます。
- ジョブを最初から実行しても、実際には指定したステップから開始するシミュレーションを提供するため、ACR およびステップ固有の条件コード パラメーターでは、ステップ COND テストおよび IF/THEN/ELSE テストの評価を細かく制御できます。
- ACR = YY の場合、ステップ CC は最後の実行からロードされ、ジョブ全体が実行されたかのように、すべてのステップに対して COND テストおよび IF テストが実行されます。
- ACR = NN の場合、ステップ CC はロードされず、すべてのステップが未実行としてマークされます。実行されなかったステップに対して評価された COND および IF 条件は FALSE と評価されるため、再開ステップより前のステップは無視されます。
- 異常終了および条件コード回復の ACR 値は混在できるため、たとえば、異常終了を 0 にリセットし、#kRY を使用して異常終了しなかったステップの既存の条件コードをロードできます。
- #c パラメーターを使用してステップ COND コードが指定されている場合 (#cSTEP(1):10 など)、ACR が値に設定されている場合と同様に、すべてのステップに対してステップ COND および IF 条件が評価されます。
- ステップ CC 値を設定すると、そのステップは実行されて CC 値の結果となったものとしてマークされます。たとえば、ACR = NN とし、ステップ CC コードを設定した場合、再起動パラメーターに COND CODES が設定されているステップを除き、すべてのステップが未実行としてマークされます。すべてのステップに対してチェックが行われますが、ステップが未実行としてマークされている場合、そのテストは
FALSE と評価されます。
- 従来の casout /j<job number> 再開機能を使用すると、既存のステップ COND コードがロードされ、新しく再開された実行のコードで上書きされます。高度な再開機能を使用すると、ジョブ実行のステップ COND コードが使用され、新しく再開された実行の終了時にこのコードが上書きされないため、ステップ
COND コードは常に元のジョブ実行のコードになります。Micro Focus では、同じジョブに対して、従来のジョブ再開呼び出しと新しいジョブ再開呼び出しを混在させないことをお勧めします。
Micro Focus Batch Scheduler Integration (MFBSI) を使用して再開
元のまたは変更された JCL を使用して、Micro Focus Batch Scheduler の mfbsijcl コマンドで JCL ジョブを再開できます。
- 元の JCL
- 次の例では、mfbsijcl コマンドおよび元の JCL を使用してジョブを再開する方法を示します。また、/jrestart の標準オプションの例も示します。
mfbsijcl /jrestart:1234567#fSTEP2:PSTEP(1)
- 変更された JCL
- mfbsijcl コマンドを使用して、変更された JCL でジョブを再開するには、次の構文を使用します。
mfbsijcl {/j<modified-JCL-file> | <basejcl>} /jrestart:<standard-parms>
詳細は次のとおりです。
- modified-JCL-file
- 変更された JCL ファイルのフル パスまたは相対パスおよびファイル名。
- basejcl
- mfbsi.cfg ファイルにある JCL-Submit および JCL-Exit を使用して解決される JCL ベース。
- standard-parms
- このトピックで別途明記されている /jrestart オプションの有効なパラメーター。
次に例を示します。
mfbsijcl /jC:\Temp\modified.jcl /jrestart:1234567#fSTEP2:PSTEP(1)
mfbsijcl /j/tmp/modified.jcl /jrestart:1234567#fSTEP2:PSTEP(1)
mfbsijcl basejcl /jrestart:1234567#fSTEP2:PSTEP(1)
変更された JCL を使用してジョブを再開する場合:
- 新しいジョブ番号がジョブに割り当てられます。
- 初期 JOB 番号 (/jrestart:nnnnnnn で指定) の JESYSMSG および関連する MFELX*.dat ファイルが使用可能である必要があります。
Notes: mfbsijcl コマンドを使用する場合:
- 高度な再開に関連するエラーの大部分は、OS Rc 220 コードで返されます。
- mfbsijcl 置換フェーズ (標準または Control-M) を再度実行する必要がある場合は、JCL 自体に変更が加えられていなくても、変更された JCL 構文を使用します。
JCL コードを変更して再開
ジョブの JCL コードを編集した後に、cassub コマンドで
/j と
/jrestart の両方のパラメーターを使用してジョブを再実行できます。
編集したジョブを再実行するときは、編集の基になった元のジョブ番号を指定する必要があります。変更後のジョブの実行時は、元のジョブの COND コードと GDG 情報が使用されます。たとえば、TEST1.JCL を再実行し、ジョブ 1006 の実行を STEP3 から再開するには次のように入力します。
cassub /rTST -jTEST1.JCL /jrestart:1006#fSTEP3
再開の自動調整
再開ステップの自動調整では、それよりも前のバイパスされたステップで作成されたはずのデータセットを考慮して、以降のステップに必要なデータセットが調整されます。自動調整を使用するかどうかは
#a パラメーターで決まります。デフォルト値 Y は自動調整をオンに、N は自動調整をオフにします。たとえば、
STEP2(3):PSTEP(1) 以降で使用されるデータセットを探して定義されている場所を特定し、それに応じて再開するステップおよびプロックステップを調整するには、次のように入力します。
casout /rTST /jrestart:1006#fSTEP2(3):PSTEP(1)#aY
デフォルトは #aY であるため、#a パラメーターを省略した場合も同じ動作になります。#aN を使用した場合は、自動調整は実行されません。
注: casout および cassub の構文では、いずれもスラッシュ (/) またはハイフンのいずれかを使用してパラメーターの開始位置を示すことができます。次に例を示します。
cassub -rTST -jTEST1.JCL -jrestart:1006#fSTEP3
これは次と同等です。
cassub /rTST -jTEST1.JCL /jrestart:1006#fSTEP3