<job-where> <job-cancel>

Definition:

<!ENTITY % cm.job-cancel "EMPTY">
<!ELEMENT job-cancel %cm.job-cancel>

Aufgabe: job-cancel nimmt jeden mit job-where ermittelten Job aus der Warteschlange.

Zusatzinformationen: Bei den gewünschten Jobs wird queuePos auf -1 gesetzt. Der gerade ausgeführte Job (queuePos = 0) kann nicht zurückgezogen werden.

Verwendung: Zunächst werden mit job-where Jobs ermittelt. Anschließend wird job-cancel verwendet, um diese Jobs abzubrechen.

Rückgabewert bei Erfolg: keiner.

Erforderliche Rechte: Der authentifizierte Benutzer muss Superuser sein, das als execLogin spezifizierte Login oder das als Wert von execPerm angegebene Recht für jeden mit job-where ermittelten Job haben.

Beispiel:

<cm-request...>
  <job-where>
    <name>myJob</name>
  </job-where>
  <job-cancel/>
</cm-request>

<cm-response...>
  <cm-code numeric="0" phrase="ok"/>
</cm-response>