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

- アラートを解決する順番を決定する。
- 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
- SYSIBM.SYSAUTOALERTS カタログ表では、解決された各アラートに関する以下の列が更新されます。
- STARTTS
- ENDTS
- STATUS
- RETURN_CODE
- MESSAGE
- OUTPUT
- SYSIBM.SYSAUTORUNS_HIST ストアード・プロシージャーでは、1 行のデータが追加され、アクティビティーがログとして記録されます。

