OPTIONS 制御ステートメントの構文とオプション

OPTIONS ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。

制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 制御ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに 保管します。 ジョブを実行するための JCL を作成するときは、SYSIN DD ステートメントを使用して、ユーティリティー 制御ステートメントを格納するデータ・セットの名前を指定してください。

構文図

>>-OPTIONS--+-| processing-options-spec |-+--------------------><
            +-OFF-------------------------+   
            '-KEY--key-value--------------'   

processing-options-spec:

>>-+---------+--+-------------------+--+--------------------+--->
   '-PREVIEW-'  '-LISTDEFDD--ddname-'  '-TEMPLATEDD--ddname-'   

>--+----------------+--+----------------+----------------------><
   '-FILSZ--integer-'  '-| event-spec |-'   

event-spec:

             .-ITEMERROR,HALT-.         .-WARNING,RC4-.      
>>-EVENT--(--+----------------+--+---+--+-------------+--)-----><
             '-ITEMERROR,SKIP-'  '-,-'  +-WARNING,RC0-+      
                                        '-WARNING,RC8-'      

オプションの説明

PREVIEW
後続のユーティリティー制御ステートメントを PREVIEW モードで実行することを 指定します。すべてのユーティリティー制御ステートメントの構文エラーは検査されますが、 通常のユーティリティー実行は行われません。 構文が有効な場合、このユーティリティーは、SYSIN にあるすべての LISTDEF リストと TEMPLATE DSN を展開し、 結果を SYSPRINT データ・セットに印刷します。

PREVIEW は、すべての LISTDEF ステートメントを評価し、実際の表スペースまたは索引スペース のリストに展開します。また、TEMPLATE DSN を評価して、可能であれば、実際のデータ・セット名に対して変数置換を使用します。 さらに、SYSLISTD DD からリストを展開し、ユーティリティーの呼び出しで参照される SYSTEMPL DD か ら TEMPLATE DSN も展開します。

TEMPLATE DSN 値のプレビューは、必ずしも常に可能とは限りません。 例えば、&DATE、&TIME、&SEQ、&PART などの一部の変数では、 置換値が実行時に変わるものがあります。 場合によっては、PREVIEW は近似的なデータ・セット名を生成し ます。OPTIONS ユーティリティーは、不明な文字変数を "UNKNOWN" という文字ストリングに置き換え、不明な整変数はゼロで置き換えます。

OPTIONS PREVIEW の代わりに、JCL PARM を使用してプレビュー処理をアクティブにすることができます。 この 2 つの機能は同一ですが、既存セットのユーティリティー制御ステートメント をプレビューする場合は、JCL PARM を使用してください。 ストアード・プロシージャーを介して Db2® ユーティリティー を起動する場合は、OPTION PREVIEW 制御ステートメントを使用してください。

次の JCL で示すように、JCL PARM は DSNUTILB の 3 番目の JCL PARM として、および DSNUPROC の UTPROC 変数 上で指定します。

//STEP1    EXEC DSNUPROC,UID='JULTU106.RECOVE1',
//         UTPROC='PREVIEW',SYSTEM='SSTR' 

PARM 値 PREVIEW によって、そのジョブ・ステップのユーティリティー制御ステートメントは、 プレビューのみのために処理されます。LISTDEF および TEMPLATE 制御ステートメントは展開されますが 、ユーティリティーは実行されません。

OPTIONS PREVIEW は、後続の OPTIONS ステートメントを指定して OPTIONS PREVIEW の プレビューをオフにできるという点を除けば、PREVIEW JCL パラメーターと同じ です。OPTION 制御ステートメントに PREVIEW キーワードがない場合は、プレビュー処理は行われません が、PREVIEW JCL パラメーター (指定されていた場合) をオーバーライドしないため、 このパラメーターは依然としてそのジョブ・ステップ全体に対して有効です。

LISTDEFDD ddname
LISTDEF 定義ライブラリーの ddname を指定します。 LISTDEF ライブラリーは、LISTDEF ユーティリティー制御ステートメントのみが入っているデータ・セットです。 このデータ・セットは、参照された LIST が SYSIN で検出されなかった場合にのみ処理されます。

デフォルト値は SYSLISTD です。

TEMPLATEDD ddname
TEMPLATE 定義ライブラリーの ddname を指定します。 TEMPLATE ライブラリーは、TEMPLATE ユーティリティー制御ステートメントのみが 入っているデータ・セットです。このデータ・セットは、参照された名前が DD 名としてジョブ・ステップに存在せず、 かつ、TEMPLATE 名として SYSIN に入っていない場合にのみ処理されます。

デフォルト値は SYSTEMPL です。

FILSZ integer
システム・パラメーター UTSORTAL が YES に設定されたユーティリティーによってソート作業データ・セットが割り振られるときに、ファイル・サイズをメガバイト単位で指定し、ソート・プログラムのファイル・サイズをオーバーライドします。 このキーワードは、IBM® ソフトウェア・サポートからの指示のもとでのみ使用してください。
EVENT
1 つ以上のペアのユーティリティー処理イベントとイベントに対するマッチング・アクションを指定します。 すべてのアクションがすべてのイベントに対して有効であるわけではありません。

EVENT オペランド内の小括弧とコンマは、現時点ではオプションですが、将来のリリースでは必須になる可能性があります。

ITEMERROR

リスト処理の際に、ユーティリティー処理でエラーをどのように取り扱うかを指定します。 特に、このキーワードは、戻りコード 8 に対応して、処理における影響を示します。 デフォルトにより、ユーティリティー処理は停止し ます (HALT)。ITEMERROR イベントには、異常終了 (アベンド) は含まれません。

QUIESCE ユーティリティーの場合、リスト内の表スペースの索引 (ある場合) は、ITEMERROR イベント のためのリスト項目であると見なされることに注意してくだ さい。ITEMERROR は、エラーの扱いについて、表スペースと索引の両方に影響を及ぼします。

HALT
イベント後にユーティリティーが停止することを指定します。
SKIP
イベントを無視し、リスト項目をスキップします。 リスト上の次の項目から処理が続行されます。

SKIP 処理は、有効なリストの処理の際にのみ適用され ます。SKIP は、呼び出されたユーティリティーではリストが無効であることを ユーティリティーが検出した場合は適用されません。 その場合、リストはエラー・メッセージとともにリジェクトされ、リストの処理は開始されません。

リストのいずれかの項目がスキップされると、ユーティリティーは戻りコード 8 を戻し、 これによってジョブ・ステップは終了します。 以下のコードは、SKIP オプションを持つ OPTIONS ステートメントを示しています。

      OPTIONS EVENT (ITEMERROR, SKIP)
      COPY LISTA
      COPY LISTB

この例で、LISTA には 10 のオブジェクトがあり、1 つのオブジェクトは COPY の際に戻りコード 8 を 生成したとすると、リストにある他の 9 つのオブジェクトは正常にコピーされます。 このジョブ・ステップは戻りコード 8 で終了し、COPY LISTB は実行されません。

WARNING
戻りコードのメッセージ・イベントに対する応答を指定します。

WARNING は、警告メッセージの戻りコードを変更する場合に使用します。 このオプションを用いると、メッセージ DSNU010I から戻りコードを変更することができます。 メッセージの戻りコードを変更すると、メッセージ DSNU1024I が出され、新しい戻りコードが 記録されます。

アクションの選択は、以下のとおりです。

RC0
戻りコード 4 で終了する単一のユーティリティー呼び出しの最終戻りコードを、 戻りコード 0 に下げます。警告メッセージに戻りコード 0 を強制する場合は、RC0 を使用します。

このオプションは、戻りコード 4 が予想され、受け入れ可能であり、さらに ユーティリティーの実行結果を検証する他のメカニズムが用意されている場合にのみ使用してください。

RC4
警告メッセージの戻りコードが変更されないままであることを指定します。 RC4 は、同じジョブ・ステップで前の OPTIONS WARNING の指定をオーバーライドする場合に使用します。
RC8
戻りコード 4 で終了する単一のユーティリティー呼び出しの最終戻りコードを、 戻りコード 8 に上げます。警告メッセージに戻りコード 8 を強制する場合は、RC8 を使用します。 戻りコード 8 によって、ジョブ・ステップは終了し、 後続のユーティリティー制御ステートメントは実行されません。
OFF
すべてのデフォルト・オプションをリストアすることを指定し ます。OPTIONS OFF は、PREVIEW JCL パラメーター (指定されている場合) をオーバーライドしない ため、このパラメーターは依然としてそのジョブ・ステップ全体に対して有効です。 その他の OPTIONS キーワードは、いずれも OPTIONS OFF と一緒に指定することはできません。

OPTIONS OFF は、OPTIONS LISTDEFDD SYSLISTD TEMPLATEDD SYSTEMPL EVENT (ITEMERROR、HALT、 WARNING、RC4) と同等です。

KEY
IBM ソフトウェア・サポートの指示があった場合のみ使用するべきオプションを指定し ます。OPTIONS KEY の後には、必要に応じて IBM ソフトウェア・サポートが提供する単一のオペランドが続きます。