OPTIONS 制御ステートメントのサンプル

以下の制御ステートメントのサンプルを、独自の OPTIONS 制御ステートメントを作成するためのモデルとして使用できます。

例 1: 制御ステートメントの構文を検査し、リストおよびテンプレートのデータ・セット名 をプレビューする

以下の OPTIONS ユーティリティー制御ステートメントは、後続のユーティリティー制御ステートメント が PREVIEW モードで実行することを指定しています。PREVIEW モードでは、Db2® はすべてのユーティリティー制御ステートメントの 構文エラーを検査しますが、通常のユーティリティーの実行は行われません。 構文が有効な場合は、Db2 は CPYLIST リスト、 および COPYLOC と COPYREM TEMPLATE ユーティリティー制御ステートメントのデータ・セット名 を展開して、その結果を SYSPRINT データ・セットに印刷します。

図 1. 構文を検査し、リストとテンプレートをプレビューする OPTIONS ステートメントの例
OPTIONS PREVIEW
TEMPLATE COPYLOC UNIT(SYSDA)
         DSN(&DB..&TS..D&JDATE..&STEPNAME..COPY&IC.&LOCREM.&PB.)
         DISP(NEW,CATLG,CATLG) SPACE(200,20) TRK
         VOLUMES(SCR03)
TEMPLATE COPYREM UNIT(SYSDA)
         DSN(&DB..&TS..&UT..T&TIME..COPY&IC.&LOCREM.&PB.)
         DISP(NEW,CATLG,CATLG) SPACE(100,10) TRK
LISTDEF CPYLIST INCLUDE TABLESPACES DATABASE DBLT0701
COPY LIST CPYLIST FULL YES
     COPYDDN(COPYLOC,COPYLOC)
     RECOVERYDDN(COPYREM,COPYREM)
     SHRLEVEL REFERENCE
 

例 2: LISTDEF および TEMPLATE 定義ライブラリーを指定する

次の例では、OPTIONS 制御ステートメントは LISTDEF 定義ライブラリーと TEMPLATE 定義ライブラリー の DD 名を指定しています。

最初の OPTIONS ステートメントでは、LISTDEF 定義ライブラリーが V1LIST DD ステートメントで、TEMPLATE 定義ライブラリーが V1TEMPL DD ステートメントで示されることを指定しています。 これらの定義ライブラリーは、後続の COPY ユーティリティー制御ステートメントに適用されます。 これによって、SYSIN で PAYTBSP リストが見つからなかった場合は、Db2 は V1LIST ライブラリー を探します。さらに、SYSIN で PAYTEMP1 テンプレートが見つからなかった場合 は、Db2 は V1TEMP ライブラリーを探します。

2 番目の OPTIONS ステートメントは、最初のものと似ていますが、別のライブラリーを 示しており、2 番目の COPY 制御ステートメントに適用されます。 この 2 番目の COPY 制御ステートメントは、最初の COPY ジョブと似ているように見えます。 しかし、このステートメントは別のリストを処理し、別のテンプレートを使用します。 最初の COPY ジョブは V1LIST ライブラリーからの PAYTBSP リストを使用するのに 対して、2 番目の COPY ジョブは V2LIST ライブラリーからの PAYTBSP リストを使用します。 また、最初の COPY ジョブは V1TEMPL ライブラリーからの PAYTEMP1 テンプレート使用するのに 対して、2 番目の COPY ジョブは V2TEMPL ライブラリーからの PAYTEMP1 テンプレートを使用します。

OPTIONS LISTDEFDD V1LIST TEMPLATEDD V1TEMPL 
COPY LIST PAYTBSP COPYDDN(PAYTEMP1,PAYTEMP1) 

OPTIONS LISTDEFDD V2LIST TEMPLATEDD V2TEMPL 
COPY LIST PAYTBSP COPYDDN(PAYTEMP1,PAYTEMP1)

例 3: 戻りコード 0 を強制する

次の例では、 最初の OPTIONS 制御ステートメントが、後続の MODIFY RECOVERY ユーティリティー制御ステートメントに対して戻りコード 0 を強制します。 通常は、このステートメントは、Db2 が表スペース A.B の SYSCOPY レコードおよび SYSLGRNX レコードをすべて削除する ように指定しているため、戻りコード 4 で終了します。2 番目の OPTIONS 制御ステートメントは 、デフォルトのオプションをリストアしているため、2 番目 の MODIFY RECOVERY 制御ステートメントでは戻りコードはオーバーライドされません。

OPTIONS EVENT(WARNING,RC0) 
MODIFY RECOVERY TABLESPACE A.B DELETE AGE(*) 
OPTIONS OFF 
MODIFY RECOVERY TABLESPACE C.D DELETE AGE(30)

例 4: 構文を検査し、リスト・オブジェクト処理中にエラーを スキップする

次の 制御ステートメントでは、最初の OPTIONS ユーティリティーは、後続のユーティリティー制御ステートメント が PREVIEW モードで実行することを指定しています。PREVIEW モードでは、Db2 はすべてのユーティリティー制御ステートメントの 構文エラーを検査しますが、通常のユーティリティーの実行は行われません。 この構文が有効な場合は、Db2 は 3 つのリスト (LIST1_LISTDEF、 LIST2_LISTDEF、および LIST3_LISTDEF) を 展開して、その結果を SYSPRINT データ・セットに印刷します。

2 番目の OPTIONS 制御ステートメントは、有効なリストを処理する後続の任意の ユーティリティー・ステートメントで、Db2 が戻りコード 8 をどのように扱うかを指定しています。 リスト項目の処理で戻りコード 8 が生じた場合は、Db2 はその項目をスキップして、引き続きリストに ある残りの項目の処理を続けますが、Db2 は次のユーティリティー制御ステートメントは処理しません。 その代わりに、ジョブは戻りコードは 8 で終了します。

図 2. 構文を検査し、エラーをスキップする OPTIONS ステートメントの例
変更の始まり
   OPTIONS PREVIEW
   LISTDEF COPY1_LISTDEF
               INCLUDE TABLESPACES TABLESPACE DSNDB01.SPT01
               INCLUDE TABLESPACES TABLESPACE DSNDB06.SYSGPAUT
               INCLUDE TABLESPACES TABLESPACE DBA91302.T?A9132*
   LISTDEF COPY2_LISTDEF
               INCLUDE TABLESPACES TABLESPACE DBA91303.TLA9133A
               INCLUDE TABLESPACES TABLESPACE DBA91303.TSA9133B
               INCLUDE TABLESPACES TABLESPACE DBA91303.TPA9133C
               INCLUDE TABLESPACES TABLESPACE DBA91304.TLA9134A
               INCLUDE TABLESPACES TABLESPACE DSNDB06.SYSUSER
               INCLUDE TABLESPACES TABLESPACE DSNDB06.SYSSTATS
               INCLUDE TABLESPACES TABLESPACE DSNDB06.SYSDDF
   LISTDEF COPY3_LISTDEF
               INCLUDE TABLESPACES TABLESPACE DBA91304.TSA9134B
               INCLUDE TABLESPACES TABLESPACE DSNDB06.SYSHIST
               INCLUDE TABLESPACES TABLESPACE DSNDB06.SYSGRTNS
               INCLUDE TABLESPACES TABLESPACE DSNDB06.SYSJAVA
               INCLUDE TABLESPACES TABLESPACE DBA91304.TPA9134C
   OPTIONS EVENT(ITEMERROR,SKIP)
   TEMPLATE TMP1 UNIT(SYSDA) DISP(MOD,CATLG,CATLG)
            VOLUMES(SCR03)
            DSN(DH109013.&TS..COPY&ICTYPE.&LOCREM.&PRIBAC.)
   COPY LIST COPY1_LISTDEF SHRLEVEL REFERENCE
        COPYDDN (TMP1)
        RECOVERYDDN (TMP1)
        FULL YES
   COPY LIST COPY2_LISTDEF SHRLEVEL REFERENCE
        COPYDDN (TMP1,TMP1)
        FULL YES
   COPY LIST COPY3_LISTDEF SHRLEVEL REFERENCE
        COPYDDN (TMP1,TMP1)
        RECOVERYDDN (TMP1,TMP1)
        FULL YES
変更の終わり