ユーティリティー制御ステートメント

ユーティリティー制御ステートメントは、 ユーティリティー・ジョブが実行する機能を定義します。

ユーティリティー制御ステートメントの作成には、ISPF/PDF 編集機能を使用し、リストされた制御ステートメントのコーディング規則を使用します。 これらの制御ステートメントは、順次データ・セットまたは区分データ・セットに保存します。

制御ステートメントのコーディング規則

Db2® は、通常は SYSIN データ・セットからユーティリティー制御ステートメントを読み取ります。 Db2 は、LISTDEF 制御ステートメントを SYSLISTD データ・セットから、また TEMPLATE 制御ステートメントを SYSTEMPL データ・セットから読み取ることができます。 これらのデータ・セット内のステートメントは、次の規則に従う必要があります。

  • 固定長レコード: レコードが 80 文字の固定長レコードの場合、Db2 は 73 桁から 80 桁までを無視します。
  • レコードをまたぐステートメント: レコードは解析される前に連結されます。したがって、ステートメント、あるいはそのいずれの構文構造も、複数のレコードをまたぐことがあります。 継続文字は不要です。

    しかし、入力データ・セットに可変長レコードが含まれている場合、Db2 は列 1 にあるステートメント部分を直前のレコードのステートメントの続きであると解釈します。構文エラーにならないようにするために、ユーティリティー制御ステートメント内のすべての構文的構造が正しく区切られている必要があります。 可変長レコードを含むデータ・セットの各レコードの最初の文字について、このことは特に重要です。

  • 文字セット・エンコード: データ・セット内のすべての制御ステートメントが、完全に単一の文字セットで書かれている必要があります。 EBCDIC (コード・ページ 500) とユニコード UTF-8 (コード・ページ 1208) の 2 つの文字セットがサポートされています。 データ・セットの先頭文字が次のいずれかの文字の場合、Db2 は、Unicode UTF-8 制御ステートメントを自動的に検出して処理します。
    • ユニコード UTF-8 ブランク (x'20')
    • ユニコード UTF-8 ダッシュ (x'2D')
    • ユニコード UTF-8 大文字の A から Z (x'41' から x'5A')
    その他の場合はすべて、制御ステートメントのデータ・セットは EBCDIC として処理されます。 処理される文字セットを識別したことを示す通知メッセージが発行されます。 メッセージ DSNU1044I は、ステートメントが EBCDIC として処理されていることを示しています。 メッセージ DSNU1045I は、ステートメントが Unicode として処理されていることを示しています。

    以下の EBCDIC 文字の 16 進コード・ポイント値は、Unicode UTF-8 文字の J から P と同じです。

    ¢ . < ( + | &

    これらの文字のいずれかを入力データ・セットの先頭文字である場合、 制御ステートメントは誤って Unicode と解釈されることがあります。 このエラーは、ユーティリティー構文エラーです。 ただし、これらの文字が原因で Unicode から EBCDIC への変換エラーが生じ、構文エラーが検出される前に異常終了することがあります。 構文エラーが検出された後に、メッセージ DSNU005I には判読不能のステートメントが含まれる可能性があり、メッセージ DSNU082I には判読不能のキーワードが示されることがあります。

  • 構文: ユーティリティー・ステートメントは、ユーティリティーの構文で始まらなければなりません。ユーティリティー制御ステートメントの他の構文構造は、オプションの記述です。 任意の数のブランクによってその構造と区切ることができます。
  • オプション: オンライン・ユーティリティー名の 後に指定できるオプションは、使用するオンライン・ユーティリティーによって異なります。ユーティリティー・オプションを指定するには、オプションのキーワードを指定し、その後に そのキーワードに関連したパラメーター (1 つ以上) があれば指定します。パラメーター値も キーワードになり得ます。 一部のパラメーター値は括弧で囲む必要があります。 ユーティリティー制御ステートメントの構文図では、 括弧が必要な場合はそれが示されます。

    各ユーティリティー制御ステートメントの構文の説明では、 パラメーターはその前のオプション・キーワードの下に字下げして書かれています。 次のオプションはその標準的な例です。

    WORKDDN ddname
    一時作業ファイルを指定します。

    ddname は、一時ファイルのデータ・セット名です。

    デフォルト値は SYSUT1 です。

    この例で、WORKDDN はオプション・キーワード、ddname は変数パラメーターです。 パラメーター値は括弧で囲むことができますが、括弧は常に必要な わけではありません。 この場合、一時作業ファイルの指定は、WORKDDN SYSUT1 でも、WORKDDN (SYSUT1) でも 構いません。

    各ユーティリティーの特定の構文およびオプションについては、制御ステートメントの構文を参照してください。

    各ユーティリティーのサンプル制御ステートメントについては、制御ステートメントのサンプルを参照してください。

  • 区切り文字と小数点文字: ユーティリティー制御ステートメントで、区切り文字で区切られる複数の数値を指定する場合、これらの値をコンマ (",") で区切る必要があります。 アプリケーション・デフォルトのロード・モジュール (DSNHDECP またはユーザー指定のアプリケーション・デフォルトのロード・モジュールのいずれか) における DECIMAL の定義に関係なく、この区切り文字を使用する必要があります。 同様に、ユーティリティー制御ステートメントに 10 進数を指定する場合、アプリケーション・デフォルトのロード・モジュールにおける DECIMAL の定義に関係なく、ピリオド (".") を使用する必要があります。
  • 複数のユーティリティー制御ステートメント: 複数のユーティリティー制御ステートメントを SYSIN ストリームで指定することができます。 ただし、いずれかの制御ステートメントが 8 以上の戻りコードを返した場合は、そのジョブ・ステップの後続のステートメントは実行されません。
  • コメント: SYSIN ストリームにコメントを入力することができます。 コメントは 2 つのハイフン (--) で始まり、 以下の規則に従う必要があります。
    • 2 つのハイフンは、同一行で、間にスペースをいれずに使用する必要があります。
    • コメントは、区切りトークン内を除いて、スペースが有効であればどこからでも開始できます。
    • 行の終わりでコメントは終了します。

    次のステートメントでは、2 つのコメントが示されています。

    変更の始まり
    // SYSIN DD *
    RUNSTATS TABLESPACE DSNDB06.SYSDDF  -- COMMENT HERE
    -- COMMENT HERE
    /*
    変更の終わり
  • 連結演算子: ユーティリティー制御ステートメントでは、|| 連結演算子がサポートされます。 この演算子は、区切り文字で区切られた 2 つの文字ストリングの間、または区切り文字で区切られていない 2 つの文字ストリングの間に使用できます。 (区切り文字で区切られた文字ストリングは、二重引用符で囲まれます。) 結果の文字ストリングは、演算子の後にあるストリングが演算子の前にあるストリングに連結される構成になります。 次のステートメントに演算を示します。
    string1  ||  string2

    string1 と string2 の両方が、それぞれの SYSIN 入力レコード内で構文的に正しい必要があります。各ストリング内で引用符の平衡が取れている必要があります。DBCS 文字を使用するときには、シフトアウト文字とシフトイン文字が各ストリング内で対になっている必要があります。マルチバイト文字については、その全体が 1 つの SYSIN レコードに含まれている必要があります。

    || 演算子は、前と後に 1 つ以上のブランクを付けてスタンドアロン・トークンとして入力する必要があります。 "string1" と同じ入力レコードに入力するか、入力レコードに単独で入力するか、または "string2" と同じ入力レコードに入力できます。 この記号は、コンテキストが検出される前、または意味が適用される前に、トークン・レベルで機能します。次のステートメントに、ユーティリティー・ステートメントの例を示します。

    COPY  INDEX  
           "A" ||
           "B"
    results in:
           COPY INDEX   "AB"

    ユーティリティーの || 演算子には既存の SQL の意味があるため、この演算子はユーティリティーの処理によって EXEC SQL 制御ステートメントで無視されます。 演算子は、SQL による後続の処理では SQL ステートメントの一部のままになります。

    次のステートメントに、|| 連結演算子の別の例を示します。
    LOAD INTO TABLE
    CREA ||
    TOR.
    "TABL" ||
    "ENAME"                                                     

    この例では、ストリング CREA と TOR は区切り文字で区切られておらず、ストリング TABL と ENAME は、二重引用符で区切られています。この例の処理される出力は、次のステートメントに相当します。

    LOAD INTO TABLE CREATOR."TABLENAME"

制御ステートメントでのマルチバイト文字セット使用のヒント

マルチバイト文字セット を固定 80 バイト SYSIN データ・セット内で使用するのは、難しい場合があります。 長いオブジェクト名や長い文字リテラルは、1 行に収まらない場合があります。

可能な限り、以下の方法を使用することによって、オブジェクト名または文字リテラルを途中で切らなくて済むようにしてください。

  • 可変長レコードまたは大きさが十分なレコードを持つ SYSIN データ・セットを使用します。
  • オブジェクト名を短くします。名前が長くなるほど、継続の問題が生じる可能性が高まります。
  • 可能な限り、スペース名 (表スペースまたは索引スペース) を使用してオブジェクトを処理し、ユーティリティー構文に長いマルチバイトの表名や索引名を指定しないようにします。

必要な場合は、以下のいずれかの継続手法を使用します。

  • マルチバイト文字全体が列 72 で終わるように、ストリングの開始点を、入力レコード内の左方または右方へシフトします。 次の入力レコードの列 1 から次の文字を始めます。
  • 修飾子を区切るドット「.」を使用して、修飾オブジェクト名を 2 つの部分に分割します。 長い名前を複数の部分に分割すると、連結の規則に容易に従うことができます。 この技法は、EXEC SQL ユーティリティーでは使用できません。EXEC SQL ユーティリティーは、ユーティリティーの規則と SQL 構文の規則の両方に従う必要があります。
  • 連結記号 || を使用して、各 SYSIN レコードにきちんと収まるように、長 ID を複数の部分に分割します。

制御ステートメントの構文

使用する特定のユーティリティーのための制御ステートメント構文を、次の表に示します。

表 1. ユーティリティー制御ステートメントの構文およびオプション
オンライン・ユーティリティー 制御ステートメントの構文およびオプション
BACKUP SYSTEM BACKUP SYSTEM 制御ステートメントの構文とオプション
CATENFM CATENFM 制御ステートメントの構文とオプション
CATMAINT CATMAINT 制御ステートメントの構文とオプション
CHECK DATA CHECK DATA 制御ステートメントの構文とオプション
CHECK INDEX CHECK INDEX 制御ステートメントの構文とオプション
CHECK LOB CHECK LOB 制御ステートメントの構文とオプション
COPY COPY 制御ステートメントの構文とオプション
COPYTOCOPY COPYTOCOPY 制御ステートメントの構文とオプション
DIAGNOSE DIAGNOSE 制御ステートメントの構文とオプション
EXEC SQL EXEC SQL 制御ステートメントの構文とオプション
LISTDEF LISTDEF 制御ステートメントの構文とオプション
LOAD LOAD 制御ステートメントの構文とオプション
MERGECOPY MERGECOPY 制御ステートメントの構文とオプション
MODIFY RECOVERY MODIFY RECOVERY 制御ステートメントの構文とオプション
MODIFY STATISTICS MODIFY STATISTICS 制御ステートメントの構文とオプション
OPTIONS OPTIONS 制御ステートメントの構文とオプション
QUIESCE QUIESCE 制御ステートメントの構文とオプション
REBUILD INDEX REBUILD INDEX 制御ステートメントの構文とオプション
RECOVER RECOVER 制御ステートメントの構文とオプション
REORG INDEX REORG INDEX 制御ステートメントの構文とオプション
REORG TABLESPACE REORG TABLESPACE 制御ステートメントの構文とオプション
REPAIR REPAIR 制御ステートメントの構文とオプション
REPORT REPORT 制御ステートメントの構文とオプション
RESTORE SYSTEM RESTORE SYSTEM 制御ステートメントの構文とオプション
RUNSTATS RUNSTATS TABLESPACE の構文とオプション
STOSPACE STOSPACE 制御ステートメントの構文とオプション
TEMPLATE TEMPLATE 制御ステートメントの構文とオプション
UNLOAD UNLOAD 制御ステートメントの構文とオプション

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

使用する特定のユーティリティーのためのサンプル制御ステートメントを、次の表に示します。

表 2. ユーティリティー制御ステートメントのサンプル
オンライン・ユーティリティー ユーティリティー制御ステートメントのサンプル
BACKUP SYSTEM BACKUP SYSTEM 制御ステートメントのサンプル
CATENFM DSNTIJEN インストール・ジョブを参照してください。
CATMAINT DSNTIJTC インストール・ジョブを参照してください。
CHECK DATA CHECK DATA 制御ステートメントのサンプル
CHECK INDEX CHECK INDEX 制御ステートメントのサンプル
CHECK LOB CHECK LOB 制御ステートメントのサンプル
COPY COPY 制御ステートメントのサンプル
COPYTOCOPY COPYTOCOPY 制御ステートメントのサンプル
DIAGNOSE DIAGNOSE 制御ステートメントのサンプル
EXEC SQL EXEC SQL 制御ステートメントのサンプル
LISTDEF LISTDEF 制御ステートメントのサンプル
LOAD LOAD 制御ステートメントのサンプル
MERGECOPY MERGECOPY 制御ステートメントのサンプル
MODIFY RECOVERY MODIFY RECOVERY 制御ステートメントのサンプル
MODIFY STATISTICS MODIFY STATISTICS 制御ステートメントのサンプル
OPTIONS OPTIONS 制御ステートメントのサンプル
QUIESCE QUIESCE 制御ステートメントのサンプル
REBUILD INDEX REBUILD INDEX 制御ステートメントのサンプル
RECOVER RECOVER 制御ステートメントのサンプル
REORG INDEX REORG INDEX 制御ステートメントのサンプル
REORG TABLESPACE REORG TABLESPACE 制御ステートメントのサンプル
REPAIR REPAIR 制御ステートメントのサンプル
REPORT REPORT 制御ステートメントのサンプル
RESTORE SYSTEM RESTORE SYSTEM 制御ステートメントのサンプル
RUNSTATS RUNSTATS 制御ステートメントのサンプル
STOSPACE STOSPACE 制御ステートメントのサンプル
TEMPLATE TEMPLATE 制御ステートメントのサンプル
UNLOAD UNLOAD 制御ステートメントのサンプル