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

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

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

構文図

構文図を読む
>>-CATMAINT--UPDATE--------------------------------------------->

>--+-------------------------------------------------+---------->
   |         .-------------------------------------. |   
   |         V                                     | |   
   +-SCHEMA----SWITCH(schema-name,new-schema-name)-+-+   
   |                 .-,----------.                  |   
   |                 V            |                  |   
   '-OWNER--FROM--(----owner-name-+--)--TO ROLE------'   

>--+-------------------------------------------+---------------->
   |       .---------------------------------. |   
   |       V                                 | |   
   '-VCAT----SWITCH(vcat-name,new-vcat-name)-+-'   

>--+---------------------+-------------------------------------><
   '-UTILX--+-BASIC----+-'   
            +-EXTENDED-+     
            '-RESET----'     

オプションの説明

UPDATE
カタログを更新することを指示します。このオプションは、 新リリースの Db2® へマイグレーションするとき、 または IBM® ソフトウェア・サポートから 指示があった場合のみ実行してください。
SCHEMA SWITCH(schema-name,new-schema-name)
データベース・オブジェクトの所有者、作成者、およびスキーマを変更します。ビュー、マテリアライズ照会表、SQL スカラー関数、トリガー、およびネイティブ SQL プロシージャーに関するスキーマは変更されません。 オブジェクトを使用するプランおよびパッケージの作成者または所有者の 許可 ID は変更されません。

schema-name は、 変更対象の既存の所有者、作成者、またはスキーマを指定するストリングです。 これは、所有者、作成者、またはスキーマ名を示していない場合は無視されます。

以下のいずれかのオブジェクトが依存しているオブジェクトのスキーマや修飾子を schema-name で識別することはできません。

  • トリガー
  • ビュー
  • SQL 関数
  • マテリアライズ照会表
  • ネイティブ SQL プロシージャー
  • 式ベースの索引
  • 列マスク
  • 行の許可

チェック制約内のチェック条件で schema-name を参照することはできません。 オブジェクトの所有権は、所有者がいずれかのロールである場合は変更 されません。

new-schema-name は、 所有者、作成者、またはスキーマの新しい名前を指定します。この名前は、既存の オブジェクトを修飾するスキーマであってはなりません。

OWNER FROM(owner-name) TO ROLE
オブジェクトの所有権を、あるユーザーからあるロールに変更します。INSTALL SYSADM に対してトラステッド・コンテキスト が作成されてからでないと、CATMAINT UPDATE OWNER を実行することは できません。オブジェクトを使用するプランおよびパッケージの作成者または所有者の 許可 ID は変更されません。

owner-name は、 オブジェクトの現在の所有者を指定します。複数の所有者を指定できます。

VCAT SWITCH(vcat-name,new-vcat-name)
ストレージ・グループ、ユーザー索引、および表スペースによって使用されるカタログ名 を変更します。

vcat-name は、 索引、表スペース、およびストレージ・グループ用のユーザー管理データ・セットによって 現在使用されている統合カタログ機能カタログを指定します。

new-vcat-name は、 索引、表スペース、およびストレージ・グループ用のユーザー管理データ・セットによって 使用されることになる新しい統合カタログ機能カタログを指定します。

英数字以外の文字を 指定する場合は、それぞれの名前を単一引用符で囲みます。

変更の始まりUTILX変更の終わり
変更の始まりカタログと OBD を、指定した状態 (BASIC または EXTENDED) に更新します。
  • 表スペースが要求された状態に既になっている場合は、変更は行われず、成功のメッセージおよび戻りコードが返されます。
  • 表スペースが要求された状態とは異なり、表スペースが空でない場合、その要求は DSNU777I メッセージを出して失敗します。
  • 表スペースが要求された状態とは異なり、表スペースが空の場合、表スペースはその新しい状態に再設定されます。
BASIC
SYSUTILX とその索引を基本 6 バイト RBA 形式に初期化します。形式を変更する前に、すべてのユーティリティーが完了または終了していることを確認してください。そうしないと、コマンドは DSNU777I メッセージを出して失敗します。 このオプションは、変換モードを除くすべてのモードで使用可能です。
EXTENDED
SYSUTILX とその索引を拡張 10 バイト RBA 形式に初期化します。形式を変更する前に、すべてのユーティリティーが完了または終了していることを確認してください。そうしないと、コマンドは DSNU777I メッセージを出して失敗します。 このオプションは、変換モードを除くすべてのモードで使用可能です。
RESET
DSNDB01.SYSUTILX ディレクトリー表スペースを再初期化します。 DSNDB01.SYSUTILX がアクティブかつ未解決のユーティリティーに関する情報を含んでいるため、この表スペースを再初期化するプロセスは、どのオブジェクトに進行中のユーティリティーが存在するかを決定し、ペンディング状態を解決してアクセス可能なオブジェクトにする処理を含みます。 このオプションは、変換モードで使用可能です。

以下のいずれかの状態にあるときは、DSNDB01.SYSUTILX ディレクトリー表スペースを再初期化してください。

  • コマンド DISPLAY UTILITY または TERMINATE UTILITY を正常に実行できない。

このステートメントを実行した後、DSNDB01.SYSUTILX は空の状態にリセットされ、以前の内容は失われます。その時点でアクティブ状態または停止状態のユーティリティーが存在していた場合は、それらの追跡情報が失われるため、予測不能な結果がサブシステムで発生する可能性があります。 UPDATE UTILX RESET を実行する前に、終了可能なすべてのユーティリティーを終了しておくことが重要です。

変更の終わり