QUERY EVENT (クライアント・スケジュールの表示)

オンラインで編集する

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

特権クラス

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

構文

パラメーター

domain_name (必須)

スケジュールが属するポリシー・ドメインの名前を指定します。ワイルドカード文字を使用してこの名前を指定することができます。

schedule_name (必須)

イベントが表示されるスケジュールの名前を指定します。ワイルドカード文字を使用してこの名前を指定することができます。

Type=Client

照会でクライアント・スケジュールのイベントを表示することを指定します。このパラメーターはオプションです。デフォルト値は CLIENT です。

Nodes

イベントを表示するよう指定したポリシー・ドメインに所属しているクライアント・ノード名を指定します。複数のクライアント・ノードを指定するには、名前と名前の間にスペースを入れずにコンマで区切ります。ノードの指定にワイルドカード文字を使用できます。クライアント名を指定しない場合には、ドメイン名とスケジュール名に一致するすべてのクライアントのイベントが表示されます。

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: イベントに関する完全な情報を表示することを指定します。

失敗したイベントに関する部分的な情報の表示

DOMAIN1 にスケジュールされ、正しく実行されなかったすべてのイベントに関する部分的な情報を表示します。 JOE という名前のクライアントだけを検索します。表示されるイベントを、2001 年 2 月 11 日 (02/11/2001) から 2001 年 2 月 12 日 (02/12/2001) までに発生するようにスケジュールされたイベントに制限します。

query event domain1 * nodes=joe begindate=02/11/2001 
enddate=02/12/2001 exceptionsonly=yes

Scheduled Start      Actual Start          Schedule  Node    Status
                                            Name     Name
-------------------- --------------------  --------- ----   ---------
02/11/1999 01:00:00  02/11/1999 01:13:55   BACK1      JOE   Failed
02/12/1999 01:00:00                        DAILYBKP   JOE   Missed

フィールドの説明については、フィールドの説明を参照してください。

クライアントのスケジュール済みイベントに関する部分的な情報の表示

処理するようにスケジュールされているすべてのイベントの完全な情報を表示します。開始時刻を今日から 10 日前、終了時刻を今日までに設定します。

query event * * begindate=today-10 enddate=today


Scheduled Start         Actual Start            Schedule Name    Node Name        Status
--------------------    --------------------    -------------    -------------    ---------
02/04/2013 14:00:00                             SCHD_INCR-DM1    TSM_CET_DM1      Missed
02/04/2013 14:00:00     02/04/2013 14:12:49     VDATAMVR1-IN1    VDATAMVR1-T1     Completed
02/04/2013 14:30:00     02/04/2013 14:33:10     VDATAMVR1-IN2    VDATAMVR1-T2     Completed
02/04/2013 15:00:00     02/04/2013 15:01:49     VDATAMVR1-IN3    VDATAMVR1-T3     Completed
02/04/2013 15:30:00     02/04/2013 15:42:00     VDATAMVR1-IN4    VDATAMVR1-T4     Completed
02/05/2013 14:00:00                             SCHD_INCR-DM1    TSM_CET_DM1      Missed
02/05/2013 14:00:00     02/05/2013 14:05:22     VDATAMVR1-F1     VDATAMVR1-F1     Completed
02/05/2013 14:30:00     02/05/2013 14:32:53     VDATAMVR1-F2     VDATAMVR1-F2     Failed 12
02/05/2013 15:00:00     02/05/2013 15:00:38     VDATAMVR1-F3     VDATAMVR1-F3     Completed
02/05/2013 15:30:00     02/05/2013 15:36:41     VDATAMVR1-F4     VDATAMVR1-F4     Completed
02/06/2013 14:00:00                             SCHD_INCR-DM1    TSM_CET_DM1      Missed
02/06/2013 14:00:00     02/06/2013 14:06:42     VDATAMVR1-F1     VDATAMVR1-F1     Completed
02/06/2013 14:30:00     02/06/2013 14:35:41     VDATAMVR1-F2     VDATAMVR1-F2     Completed
02/06/2013 15:00:00     02/06/2013 15:08:56     VDATAMVR1-F3     VDATAMVR1-F3     Completed
02/06/2013 15:30:00     02/06/2013 15:40:49     VDATAMVR1-F4     VDATAMVR1-F4     Completed
02/07/2013 14:00:00                             SCHD_INCR-DM1    TSM_CET_DM1      Missed
02/07/2013 14:00:00     02/07/2013 14:03:43     VDATAMVR1-F1     VDATAMVR1-F1     Completed
02/07/2013 14:30:00     02/07/2013 14:35:10     VDATAMVR1-F2     VDATAMVR1-F2     Completed
02/07/2013 15:00:00     02/07/2013 15:09:12     VDATAMVR1-F3     VDATAMVR1-F3     Completed
02/07/2013 15:30:00     02/07/2013 15:40:21     VDATAMVR1-F4     VDATAMVR1-F4     Completed
02/08/2013 14:00:00                             SCHD_INCR-DM1    TSM_CET_DM1      Missed
02/08/2013 14:00:00     02/08/2013 14:10:17     VDATAMVR1-F1     VDATAMVR1-F1     Completed
02/08/2013 14:30:00     02/08/2013 14:39:16     VDATAMVR1-F2     VDATAMVR1-F2     Completed
02/08/2013 15:00:00     02/08/2013 15:08:17     VDATAMVR1-F3     VDATAMVR1-F3     Completed
02/08/2013 15:30:00     02/08/2013 15:41:16     VDATAMVR1-F4     VDATAMVR1-F4     Completed
02/09/2013 14:00:00                             SCHD_INCR-DM1    TSM_CET_DM1      Missed
02/09/2013 14:02:16                             VDATAMVR1-F1     VDATAMVR1-F1     Failed 12
02/09/2013 14:30:00     02/09/2013 14:44:26     VDATAMVR1-F2     VDATAMVR1-F2     Failed 12
02/09/2013 15:00:00     02/09/2013 15:06:24     VDATAMVR1-F3     VDATAMVR1-F3     Failed 12
02/09/2013 15:30:00     02/09/2013 15:32:18     VDATAMVR1-F4     VDATAMVR1-F4     Completed
02/11/2013 14:00:00                             SCHD_INCR-DM1    TSM_CET_DM1      Missed
02/11/2013 14:00:00     02/11/2013 14:01:05     VDATAMVR1-F1     VDATAMVR1-F1     Failed 12
02/11/2013 14:30:00     02/11/2013 14:31:42     VDATAMVR1-F2     VDATAMVR1-F2     Failed 12
02/11/2013 15:00:00     02/11/2013 15:06:17     VDATAMVR1-F3     VDATAMVR1-F3     Failed 12
02/11/2013 15:30:00     02/11/2013 15:30:19     VDATAMVR1-F4     VDATAMVR1-F4     Completed
02/12/2013 14:00:00                             SCHD_INCR-DM1    TSM_CET_DM1      Missed
02/12/2013 14:00:00     02/12/2013 14:03:37     VDATAMVR1-F1     VDATAMVR1-F1     Completed
02/12/2013 14:30:00     02/12/2013 14:33:07     VDATAMVR1-F2     VDATAMVR1-F2     Completed
02/12/2013 15:00:00     02/12/2013 15:03:56     VDATAMVR1-F3     VDATAMVR1-F3     Completed
02/12/2013 15:30:00     02/12/2013 15:36:44     VDATAMVR1-F4     VDATAMVR1-F4     Completed
02/13/2013 14:00:00                             SCHD_INCR-DM1    TSM_CET_DM1      Missed
02/13/2013 14:00:00     02/13/2013 14:06:24     VDATAMVR1-F1     VDATAMVR1-F1     Completed
02/13/2013 14:30:00     02/13/2013 14:34:50     VDATAMVR1-F2     VDATAMVR1-F2     Completed
02/13/2013 15:00:00     02/13/2013 15:15:01     VDATAMVR1-F3     VDATAMVR1-F3     Completed
02/13/2013 15:30:00     02/13/2013 15:30:18     VDATAMVR1-F4     VDATAMVR1-F4     Completed
02/14/2013 14:00:00                             SCHD_INCR-DM1    TSM_CET_DM1      Future
02/14/2013 14:00:00                             VDATAMVR1-F1     VDATAMVR1-F1     Future
02/14/2013 14:30:00                             VDATAMVR1-F2     VDATAMVR1-F2     Future
02/14/2013 15:00:00                             VDATAMVR1-F3     VDATAMVR1-F3     Future

フィールドの説明については、フィールドの説明を参照してください。

クライアントのスケジュール済みイベントに関する詳細な情報の表示

クライアント DOC によって 2005 年 11 月 1 日 (11/01/2005) の 10:00 AM から 11:00 AM の間に処理するようにスケジュールされたイベントに関する詳細情報を表示します。状況が「失敗」の場合は結果コードが表示される点に注意してください。

query event domain1 * nodes=doc begindate=11/01/2005
begintime=10:00 endtime=11:00 enddate=11/01/2005
exceptionsonly=yes format=detailed

Scheduled Start      Actual Start         Schedule   Node    Status 
                                          Name       Name    
-------------------- -------------------- ---------  ------  -------
11/01/2005 10:01:01  11/01/2005 10:03:46  T1         DOC     Failed 8
11/01/2005 10:16:01  11/01/2005 10:16:10  T1         DOC     Failed 4
11/01/2005 10:31:01  11/01/2005 10:33:08  T1         DOC     Completed
11/01/2005 10:46:01                       T1         DOC     Missed
11/01/2005 10:57:49  11/01/2005 10:58:07  T0         DOC     Failed 12

フィールドの説明

ポリシー・ドメイン名

スケジュールを割り当てるポリシー・ドメインの名前を指定します。

スケジュール名

このイベントを開始したスケジュールの名前を指定します。

ノード名

操作の実行をスケジュールされたクライアントを指定します。

スケジュール済み開始

イベントのスケジュールされた開始日時を指定します。

実際開始

クライアントがスケジュールされた操作のプロセスを開始した日時を指定します。スケジュール済みの操作が開始されていなければ、情報は表示されません。

完了

スケジュールされたイベントが完了する日時を示します。

状況

QUERY EVENT コマンドが発行された時点のイベントの状況を指定します。以下の値を指定できます。

完了: スケジュールされたイベントが完了していることを示します。
失敗: クライアントが、スケジュールされた操作の実行に失敗し、一連の再試行にも失敗したことを報告していることを示します。
失敗 - 未再開: クライアント・セッションがサーバー上の通信エラーまたはタイムアウトによって中断された場合の中間状況を指定します。イベントの完了時に、この状況を「Completed」または「Failed」に変更できます。
将来の: イベントの開始時間帯が、後で開始されることを指定します。この状況は、そのイベントのイベント・レコードがまだ作成されていないことも示します。
「進行中」: スケジュール済みイベントが実行されており、完了状況がサーバーにまだ報告されていないことを指定します。
スケジュール済みイベントの完了状況を定期的に検査します。この状況が妥当な時間内に更新されない場合には、クライアントがサーバーにこのイベントの結果を報告しなかった理由を判別するためにクライアントの dsmsched.log および dsmerror.log を検討します。スケジュールされたバックアップに失敗した場合は、データ・バックアップを確実にするために、スケジュール済みイベントを再実行するか、もしくは手動の差分バックアップを実行します。
欠損: このイベントにスケジュールされたスタートアップ期間が経過してしまい、スケジュールが開始されなかったことを示します。
保留中: イベントのスタートアップ期間中に QUERY EVENT コマンドが発行されたが、スケジュールされた操作の処理がまだ開始されていないことを示します。
再始動済み: クライアントが、スケジュールされた操作の処理を再試行したことを示します。
切断: イベントが完了する前にクライアントとの通信が切断されるように指定します。
開始済み: イベントがプロセスを開始したことを指定します。
不明: イベントの状態を判別できないことを指定します。サーバーが指定するUncertainQUERY EVENT コマンドがイベント・レコードを検出しない場合。レコードが削除されている場合、あるいはスケジュール済み開始時間帯中にサーバーが選択不可能である (スケジュールが開始されていない) 場合には、イベント・レコードは見つかりません。「不確定」状況のレコードは、データベースに保管されません。このようなレコードを表示したくない場合は、EXCEPTIONSONLY=YES を指定するか、あるいはスケジュールがもう必要でなければ、それを削除してください。

重要: スケジュールされた操作が処理中であり、指定された期間内に再始動されない場合、「状況」フィールドには以下が表示されます。Started指定された期間を超えて操作を続行すると、イベント・レコードは作成されません。指定された期間が経過した後に照会が発行されると、状況は次のように表示されます。Failed操作がまだ実行されている場合でも、実行されます。操作が完了した後で、イベント・レコードが作成され、続く照会では、その結果が「状況」フィールドに示されます。

結果

スケジュールが正常に処理されたかどうかを示す戻りコードを指定します。戻りコードが 0 以外の値である場合、サーバーの活動記録ログおよびクライアントのエラー・ログおよびスケジュール・ログを調査してください。

戻りコード	説明
0	すべての操作が正常に完了しました。
4	操作は完了しましたが、一部のファイルが処理されませんでした。
8	操作は完了しましたが、1 つ以上の警告メッセージが出されました。
12	操作は完了しましたが、1 つ以上のエラー・メッセージが出されました。エラー・メッセージをカウントする際、スキップされたファイルに関する通知は含まれません。
-99	クライアントとサーバー間のセッションが不明な理由で終了したために、操作は失敗しました。クライアントがサーバーに再接続してスケジュール・イベントを完了できるかどうかは不明です。

スケジュールにパラメーターとして ACTION=COMMAND があり、コマンドが IBM Storage Protect コマンドでない場合、コマンドは「結果」フィールドに他の値を生成することができます。

理由

戻りコードの理由を指定します。