Schedule-Tag

Sie können Servermanagement-Anforderungen so einrichten, dass sie nach einem Zeitplan ablaufen. Legen Sie mit den folgenden <schedule>-Subtags die Zeitplanung für die Anforderung fest.

<schedule>-Subtags

Beschreibung

Definiert die Tageszeit, zu der der Server mit der Generierung von Berichten beginnt. Zum Beispiel:

<starttime>09:00:00</starttime>

Enthält zwei Subtags, starttime und endtime, die ein Intervall für die Generierung von Berichten durch den Server definieren. Kann nicht in demselben Zeitplan wie starttime verwendet werden. Zum Beispiel:

<between>
  <starttime>Mon Jan 16 09:00:00 EST 2006</starttime>
  <endtime>Mon Jan 17 09:00:00 EST 2006</endtime>
</between>

Definiert das Intervall zwischen aufeinanderfolgenden Berichten in Stunden. Kann nicht in demselben Zeitplan wie everyminute oder everysecond verwendet werden. Beispiel: Die folgende Anforderung generiert einen Bericht alle zwei Stunden, beginnend um 9 Uhr vormittags:

<schedule>
  <starttime>09:00:00</starttime>
  <everyhour>2</everyhour>
</schedule>

Definiert das Intervall zwischen aufeinanderfolgenden Berichten in Minuten. Kann nicht in demselben Zeitplan wie everyhour oder everysecond verwendet werden.

<schedule>
  <everyminute>10</everyminute>
</schedule>

Definiert das Intervall zwischen aufeinanderfolgenden Berichten in Sekunden. Kann nicht in demselben Zeitplan wie everyhour oder everyminute verwendet werden.

<schedule>
  <everysecond>45</everysecond>
</schedule>

Jeder Tag enthält einen Tag der Woche, an dem der Zeitplan aktiv ist. Der folgende Zeitplan läuft beispielsweise an Montagen und Dienstagen:

<schedule>
  <ondayofweek>Monday</ondayofweek>
  <ondayofweek>Tuesday</ondayofweek>
</schedule>

Jedes Tag enthält einen Tag des Monats, an dem der Zeitplan aktiv ist. Beispiel: Der folgende Zeitplan ist am 15. des Monats aktiv:

<schedule>
  <ondayofmonth>15</ondayofmonth>
</schedule>

Das Datum, an dem der Zeitplan aktiv wird. Zum Beispiel:

<startdate>Mon Jan 16 2006</startdate>

Sie ändern einen Zeitplan, indem Sie eine neue Servermanagement-Anforderung mit derselben requestId registrieren. Sie löschen einen Zeitplan, indem Sie eine Servermanagement-Anforderung mit derselben requestId und dem schedule-Tag <schedule>none</schedule> registrieren.

Hinweise

Die einzelnen Tags, mit Ausnahme von <ondayofweek> und <ondayofmonth>, können nur einmal in einem Zeitplan verwendet werden.
Das <between>-Tag und das jeweilige Tag für <starttime> können nicht gemeinsam in demselben Zeitplan verwendet werden.
Die Tags <everysecond>, <everyminute> und <everyhour> schließen einander in einem Zeitplan aus und können daher nur einzeln verwendet werden.

Beispiel

Im folgenden Beispiel wird ein dauerhafter Zeitplan erstellt, der einen Bericht über alle Nachrichten auf dem Server unter Einschluss von ID und Status jeder Nachricht ausgibt. Außerdem werden damit alle früheren dauerhaften Anforderungen überschrieben, die der Anforderungs-ID dailyMessageStatus zugeordnet wurden.

<?xml version="1.0" encoding="UTF-8"?>
<actions>
  <MessageDetailsRequest>
   <request>
     <replyAddr>myclient\messageStatusQueue</replyAddr>
     <requestId>dailyMessageStatus</requestId>
     <schedule>
       <everyhour>24</everyhour>
     </schedule>
     <persistent/>
     <messageId/>
     <status/>
   </request>
  </MessageDetailsRequest>
</actions>

Das folgende Beispiel zeigt, wie so ein Bericht aussehen kann. Er wird an die Adresse myclient\messageStatusQueue gesendet. Er gibt an, dass sich zwei Nachrichten auf dem Server befinden, wobei eine den Status 60 (empfangen) und die andere den Status1 (ausstehend) aufweist.

<?xml version="1.0" encoding="UTF-8"?>
<MessageDetailsReport>
   <requestId>dailyMessageStatus</requestId>
   <UTCDatetime>Mon Jan 16 15:03:04 EST 2007</UTCDatetime>
   <statusDescription>Scheduled report</statusDescription>
   <messageCount>2</messageCount>
   <message>
     <messageId>ID:26080b8927f83f9722357eab0a0628eb</messageId>
     <status>60</status>
   </message>
   <message>
     <messageId>ID:fe857fa8-a7d7-4266-985b-a1818a85d1a2</messageId>
     <status>1</status>
   </message>
</MessageDetailsReport>

Kommentieren Sie diese Seite in DocCommentXchange.
Senden Sie uns Feedback über diese Seite via E-Mail.