<job-where> <job-exec>

Definition:

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

Aufgabe: Mit job-exec wird jeder mit job-where ermittelte Job in die Ausführungswarteschlange gestellt.

Zusatzinformationen: Befindet sich ein Job bereits in der Ausführungswarteschlange, so wird er nicht ein zweites Mal in die Warteschlange gestellt.

Verwendung: Zunächst müssen mit job-where Jobs ermittelt werden. Anschließend wird job-exec verwendet, um diese Jobs in die Ausführungswarteschlange zu stellen.

Rückgabewert bei Erfolg: Der neue Wert für queuePos. Befinden sich Jobs bereits in der Warteschlange, so wird jeweils der aktuelle Wert von queuePos zurückgegeben.

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

Beispiel:

<cm-request...>
  <job-where>
    <name>rootJob</name>
  </job-where>
  <job-exec/>
</cm-request>

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