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

ADMIN_UTL_MODIFY は、SYSIBM.SYSAUTORUNS_HIST カタログ表および SYSIBM.SYSAUTOALERTS カタログ表を保守するオートノミック・ストアード・プロシージャーです。

汎用プログラミング・インターフェース情報の開始
ADMIN_UTL_MODIFY ストアード・プロシージャーは、構成可能なしきい値よりも古い SYSIBM.SYSAUTORUNS_HIST 表内のすべてのエントリーを削除し、また、構成済みのしきい値よりも古く、COMPLETE 状態にある SYSIBM.SYSAUTOALERTS 表内の、すべてのエントリーを削除します。

環境

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

必要な許可

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

構文

構文図を読む
>>-CALL--ADMIN_UTL_MODIFY--(----modify-options---,-------------->

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

オプションの説明

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

modify-options
ADMIN_UTIL_MODIFY ストアード・プロシージャーの構成パラメーターを表すストリングです。構成パラメーターは、コンマで区切られた「NAME = VALUE」のペアにより構成されます。オプション・パラメーターを以下に示します。
HISTORY-DAYS
この日数が経過した後、SYSIBM.SYSAUTORUNS_HIST 表内のエントリーおよび SYSIBM.SYSAUTOALERTS 表内の完了済みアラートは削除されます。値は、日数を表す正数である必要があります。

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

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

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

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

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

例

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

String options = "history-days=90";
CallableStatement callStmt =
con.prepareCall("CALL SYSPROC.ADMIN_UTL_MODIFY(?, ?, ?, ?)");
callStmt.setString(1, options);
callStmt.registerOutParameter(2,Types.INTEGER);
callStmt.registerOutParameter(3,Types.INTEGER);
callStmt.registerOutParameter(4,Types.LONGVARCHAR);
callStmt.execute();
if ( callStmt.getInt(3) > 0 )
{
    System.err.println("Error: " + callStmt.getString(4));
}

外部入力

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

出力

ADMIN_UTL_MONITOR ストアード・プロシージャーは、以下の出力パラメーターを返します。
  • history-entry-id
  • return-code
  • message

また、ADMIN_UTL_MODIFY ストアード・プロシージャーは、SYSIBM.SYSAUTORUNS_HIST 表および SYSIBM.SYSAUTOALERTS 表から行を削除し、SYSIBM.SYSAUTORUNS_HIST 表に単一行を挿入して、そのアクティビティーをログとして記録します。

汎用プログラミング・インターフェース情報の終了