ADMIN_UTL_MODIFY ストアード・プロシージャー
ADMIN_UTL_MODIFY は、SYSIBM.SYSAUTORUNS_HIST カタログ表および 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 表に単一行を挿入して、そのアクティビティーをログとして記録します。

