ADMIN_UTL_EXECUTE ストアード・プロシージャー

ADMIN_UTL_EXECUTE は、SYSIBM.SYSAUTOALERTS カタログ表に保管されるアラートを解決するストアード・プロシージャーです。このカタログ表は、SYSIBM.SYSAUTOTIMEWINDOWS カタログ表で定義されるメンテナンス・ウィンドウ内にあります。このストアード・プロシージャーは、オートノミック統計を使用する場合に必要です。

汎用プログラミング・インターフェース情報の開始
ADMIN_UTL_EXECUTE ストアード・プロシージャーは、以下のタスクを実行します。

  • アラートを解決する順番を決定する。
  • SYSIBM.SYSAUTOTIMEWINDOWS カタログ表で定義されるメンテナンス・ウィンドウ内で、ADMIN_UTL_SCHEDULE ストアード・プロシージャーを呼び出して、RUNSTATS ユーティリティーを実行することでアラートを解決する。各アラートについて、SYSIBM.SYSAUTOALERTS 表で RUNSTATS のオプションが提供されます。
  • SYSIBM.SYSAUTOALERTS 表で、解決したアラートの状況および出力を更新する。
  • 管理タスク・スケジューラーが使用される場合、未解決のアラートが残っているときには、次のメンテナンス・ウィンドウ用にプロシージャー自体の実行を再スケジュールする。

環境

ADMIN_UTL_EXECUTE ストアード・プロシージャーは、WLM が確立したストアード・プロシージャー・アドレス・スペース内で実行され、リソース・リカバリー・サービス接続機能を使用して、Db2® に接続します。 ADMIN_UTL_EXECUTE ストアード・プロシージャーは、ADMIN_UTL_SCHEDULE ストアード・プロシージャーを呼び出して RUNSTATS 操作を実行します。ADMIN_UTL_EXECUTE ストアード・プロシージャーは必須で、インストールし実行可能にしておく必要があります。

このストアード・プロシージャーは、DSNADM.ADMIN_TASK_LIST ルーチンおよび SYSPROC.ADMIN_TASK_UPDATE ルーチンを呼び出します。

必要な許可

CALL ステートメントを実行するには、CALL ステートメントを含むパッケージまたは計画の所有者は、 DBADM またはそれ以上の権限を持っている必要があります。

構文

構文図を読む
>>-CALL--SYSPROC.ADMIN_UTL_EXECUTE--(----execute-options---,---->

>----history-entry-id---,----return-code---,----message---)----><

オプションの説明

ADMIN_UTL_EXECUTE ストアード・プロシージャーには、以下のオプションがあります。

execute-options
ADMIN_UTL_EXECUTE ストアード・プロシージャーの構成パラメーターを表すストリングです。構成パラメーターは、コンマで区切られた「NAME = VALUE」のペアにより構成されます。オプション・パラメーターを以下に示します。
STAND-ALONE
NO
ADMIN_UTL_EXECUTE ストアード・プロシージャーは、プロシージャー自体の次の実行について、管理タスク・スケジューラーと対話します。NO がデフォルト値です。
YES
ADMIN_UTL_EXECUTE ストアード・プロシージャーは、管理タスク・スケジューラーと対話しません。

execute-options は、タイプ VARCHAR(30000) の入力パラメーターです。

history-entry-id
SYSPROC.ADMIN_UTL_EXECUTE ストアード・プロシージャーの実行時に、SYSIBM.SYSAUTORUNS_HIST 表に書き込まれる実行ログを読み取るのに使用できる固有 ID が提供されます。これは、タイプ BIGINT の出力パラメーターです。
return-code
ストアード・プロシージャーからの戻りコードが格納されています。可能な値は、以下のとおりです。
0
呼び出しは正常に完了しました。
4
呼び出しは正常に完了しました。メッセージ出力パラメーターに、警告メッセージが含まれています。
12
呼び出しは正常に完了しませんでした。メッセージ出力パラメーターに、エラーを説明するメッセージが含まれています。

return-code パラメーターは、タイプ INTEGER の出力パラメーターです。

message
ストアード・プロシージャーが検出したエラーを説明するメッセージが含まれます。

message パラメーターは、タイプ VARCHAR(1331) の出力パラメーターです。

例

以下に、ADMIN_UTL_EXECUTE ストアード・プロシージャーの Java 呼び出しの例を示します。

long taskid = 7;
CallableStatement callStmt =
con.prepareCall("CALL SYSPROC.ADMIN_UTL_EXECUTE(?, ?, ?, ?)");
callStmt.setString(1, "");
callStmt.registerOutParameter(2,Types.BIGINT);
callStmt.registerOutParameter(3,Types.INTEGER);
callStmt.registerOutParameter(4,Types.LONGVARCHAR);
callStmt.execute();
if ( callStmt.getInt(3) > 0 )
{
    System.err.println("Error: " + callStmt.getString(4));
}

外部入力

The ADMIN_UTL_EXECUTE ストアード・プロシージャーは、SYSIBM.SYSAUTOALERTS カタログ表および SYSIBM.SYSAUTOTIMEWINDOWS カタログ表から追加入力を読み取ります。

出力

ADMIN_UTL_EXECUTE ストアード・プロシージャーは、以下の出力パラメーターを返します。

  • history-entry-id
  • return-code
  • message
また、ADMIN_UTL_EXECUTE ストアード・プロシージャーは、以下のカタログ表を更新します。
  • SYSIBM.SYSAUTOALERTS カタログ表では、解決された各アラートに関する以下の列が更新されます。
    • STARTTS
    • ENDTS
    • STATUS
    • RETURN_CODE
    • MESSAGE
    • OUTPUT
  • SYSIBM.SYSAUTORUNS_HIST ストアード・プロシージャーでは、1 行のデータが追加され、アクティビティーがログとして記録されます。
汎用プログラミング・インターフェース情報の終了