QUERY EVENT (管理イベント・スケジュールの表示)

オンラインで編集する

QUERY EVENT コマンドを使用して、選択した管理コマンド・スケジュールのスケジュール済みのイベントおよび完了イベントを表示します。

特権クラス

すべての管理者がこのコマンドを発行できます。

構文

構文図を読むビジュアル構文図をスキップQuery EVent schedule_nameType=Administrative BEGINDate=CURRENT_DATEBEGINDate=日付BEGINTime=00:00BEGINTime=時刻ENDDate=開始日ENDDate=日付ENDTime=23:59ENDTime=時刻EXceptionsonly=NoEXceptionsonly=NoYesFormat=StandardFormat=StandardDetailed

パラメーター

schedule_name (必須)
イベントが表示するスケジュールの名前を指定します。 ワイルドカード文字を使用して名前を指定することができます。
Type=Administrative (必須)
この照会で、管理コマンド・スケジュールのイベントが表示されることを指定します。
BEGINDate
表示されるイベントの時刻範囲の開始日を指定します。 この時間範囲内に開始するようにスケジュールされたすべてのイベントが表示されます。 このパラメーターはオプションです。 デフォルトは現在日付です。
以下の値の 1 つを使用して、日付を指定することができます。
値 説明 例
MM/DD/YYYY 特定の日付 09/15/1998
TODAY 現在日付 TODAY
TODAY+日 または +日 現在日付 + 指定日数。 指定できる最大日数は 9999 です。 TODAY +3 または +3。
TODAY-日 または -日 現在の日付から、指定した日数を引いた日付 TODAY-7 または -7

過去 7 日間に開始するようにスケジュールされたイベントを照会するには、BEGINDATE=TODAY-7 ENDDATE=TODAY または BEGINDATE=-7 ENDDATE=TODAY と指定します。
EOLM (End Of Last Month) 前月の最終日 EOLM
EOLM-日 前月の最終日から、指定した日数を引いた日付 EOLM-1

前月の最終日の 1 日前に活動状態であったファイルを組み込みます。
BOTM (Beginning Of This Month) 今月の初日 BOTM
BOTM +日 今月の初日に、指定した日数を加えた日付 BOTM+9

今月 10 日に活動状態であったファイルを組み込みます。
BEGINTime
表示されるイベントの時間範囲の開始時刻を指定します。 この時間範囲内に開始するようにスケジュールされたすべてのイベントが表示されます。 このパラメーターはオプションです。 デフォルト値は 00:00 です。
この時刻は、以下のいずれかの値を使用して指定できます。
値 説明 例
HH:MM:SS 指定された開始日における特定の時刻 10:30:08
NOW 指定された開始日の現在時刻 NOW
NOW+HH:MM (H) または +HH:MM (H) 指定した開始日付の現在の時刻に、指定した時間数と分数を加えた時刻 NOW+03:00 または +03:00。

このコマンドを 9:00 に出して、今から 3 時間後に開始するようにスケジュールされたイベントを照会したい場合、BEGINTIME=NOW+03:00 または BEGINTIME=+03:00 と指定することができます。 IBM Storage Protect は、指定された開始日の 12:00 のイベントを表示します。
NOW-HH:MM (H) または -HH:MM (H) 指定された開始日の現在時刻から時間数および分数を引いた時刻 NOW-04:00 または -04:00

このコマンドを 9:00 に出して、過去 4 時間の間に開始するようにスケジュールされたイベントを照会したい場合、BEGINTIME=NOW-04:00 ENDTIME=NOW または BEGINTIME=-04:00 ENDTIME=NOW のどちらかを指定することができます。 IBM Storage Protect は、指定された開始日の 5:00 のイベントを表示します。
ENDDate
表示するイベントの時間範囲の終了日を指定します。 この時間範囲内に開始するようにスケジュールされたすべてのイベントが表示されます。 このパラメーターはオプションです。 デフォルトは、BEGINDATE に使用された値です。
以下の値の 1 つを使用して、日付を指定することができます。
値 説明 例
MM/DD/YYYY 特定の日付 09/15/1998
TODAY 現在日付 TODAY
TODAY+日 または +日 現在日付 + 指定日数。 指定できる最大日数は 9999 です。 TODAY +3 または +3。
TODAY-日 または -日 現在の日付から、指定した日数を引いた日付 TODAY-8 または -8。

昨日で終了した 1 週間の時間間隔中に開始するようにスケジュールされたイベントを照会するためには、BEGINDATE=TODAY-8   ENDDATE=TODAY-1、または BEGINDATE=-8  ENDDATE=-1 のいずれかを指定することができます。
EOLM (End Of Last Month) 前月の最終日 EOLM
EOLM-日 前月の最終日から、指定した日数を引いた日付 EOLM-1

前月の最終日の 1 日前に活動状態であったファイルを組み込みます。
BOTM (Beginning Of This Month) 今月の初日 BOTM
BOTM +日 今月の初日に、指定した日数を加えた日付 BOTM+9

今月 10 日に活動状態であったファイルを組み込みます。
ENDTime
表示されるイベントの範囲の終了時刻を指定します。 この時間範囲内に開始するようにスケジュールされたすべてのイベントが表示されます。 このパラメーターはオプションです。 デフォルト値は 23:59 です。
この時刻は、以下のいずれかの値を使用して指定できます。
値 説明 例
HH:MM:SS 指定された終了日の特定の時刻 10:30:08
NOW 指定された終了日の現在時刻 NOW
NOW+HH:MM (H) または +HH:MM (H) 指定された終了日付の現在の時刻に、指定した時間数と分数を加えた時刻 NOW+03:00 または +03:00。

このコマンドを 9:00 に出して、今から 3 時間の間に開始するようにスケジュールされたイベントを照会したい場合、BEGINTIME=NOW ENDTIME=NOW+03:00 または BEGINTIME=NOW ENDTIME=+03:00 のどちらかを指定できます。
NOW-HH:MM (H) または -HH:MM (H) 指定された終了日付の現在の時刻から、指定した時間数と分数を引いた時刻 NOW-04:00 または -04:00
EXceptionsonly
スケジュール済みイベントまたは完了したイベントに関して入手したい情報の種類を指定します。 このパラメーターはオプションです。 デフォルトは NO です。 以下のいずれかの値を指定することができます。
No
過去の計画通りに行われたイベントに関する情報を表示するよう指定します。
Yes
失敗したか、あるいはスケジュール通りに処理されなかったイベントが表示されるということを指定します。
Format
情報の表示方法を指定します。 このパラメーターはオプションです。 デフォルトは STANDARD です。 可能な値は次のとおり:
Standard
イベントに関する部分的な情報を表示することを指定します。
Detailed
イベントに関する完全な情報を表示することを指定します。

例: 特定の管理スケジュールのイベントのリスト

DOSADMIN という管理スケジュールにスケジュールされたすべてのイベントに関する 部分的な情報を表示します。 1999 年 3 月 30 日 (03/30/1999) にスケジュールされたイベントだけに照会を制限します。 次のコマンドを出します。
query event dosadmin type=administrative 
begindate=03/30/1999 
enddate=03/30/1999 
Scheduled Start      Actual Start          Schedule Status
                                           Name
-------------------- --------------------  --------- ---------
03/30/1999 00:00:00  03/30/1999 00:00:01   DOSADMIN  Completed
03/30/1999 04:00:00  03/30/1999 04:00:01   DOSADMIN  Completed
03/30/1999 12:00:00                        DOSADMIN  Future
03/30/1999 16:00:00                        DOSADMIN  Future

フィールドの説明

スケジュール済み開始
イベントのスケジュールされた開始日時を指定します。
実際開始
クライアントがスケジュールされた操作のプロセスを開始した日時を指定します。 スケジュールが実行を開始していなければ、情報は表示されません。
スケジュール名
このイベントを開始したスケジュールの名前を指定します。
状況
WAIT=YES を指定する管理コマンドまたはスクリプトの場合、スケジュール済みイベントの状況は、そのコマンドまたはスクリプトによって指定された操作が完了するまで STARTED になります。 スケジュール済みイベントの最終状況は、操作の戻りコードに従います。 ただし、WAIT=YES で、スケジュールが PREVIEW=YES を指定するスクリプトを実行している場合、スクリプトに構文エラーがない限り最終状況は COMPLETED になります。

WAIT=NO を指定する管理コマンドまたはスクリプトの場合、スケジュール済みイベントの状況は、スケジュール済みコマンドまたはスクリプトが開始されている場合 COMPLETED になります。 スケジュールの成功は、コマンドまたはスクリプトによって実行される操作の成功に依存するものではありません。