<job-where>

Ausschnitt aus der DTD:

<!ENTITY % cm.cm-request "
  ...
  (job-where+, job-cancel) |
  (job-where+, job-delete) |
  (job-where+, job-description) |
  (job-where+, job-exec) |
  (job-where+, job-get) |
  (job-where+, job-getLogEntry) |
  (job-where+, job-getOutput) |
  (job-where+, job-set) |
  ...
">


    Definition:
<!ENTITY % cm.job-where "
  (category |
  comment | 
  execLogin | 
  id |
  isActive | 
  isQueued | 
  name |
  title)*
">
<!ELEMENT job-where %cm.job-where>

Aufgabe: Sucht nach Jobs, bei denen alle durch die Werte der angegebenen Parameterelementen spezifizierten Bedingungen erfüllt sind. Wird kein Parameter angegeben, so wird die Liste der Namen aller Jobs geliefert.

Spezielle Parameter dieses Funktionselements:

  • category, id: Die Jobs, bei denen der Parameter dem angegebenen Wert entspricht, werden zurückgegeben.
  • comment, name, title: Die Jobs, bei denen der Parameter den angegebenen Wert enthält, werden zurückgegeben.
  • execLogin: Liefert die Jobs, bei denen das Skript unter dem angegebenen Login ausgeführt wird.
  • isActive: Liefert die Jobs, bei denen der Parameter isActive den angegebenen Wert enthält.
  • isQueued: Ist ein Wert ungleich 0 angegeben, so werden alle Jobs geliefert, bei denen queuePos größer oder gleich null ist. Andernfalls werden die Jobs geliefert, bei denen queuePos kleiner null ist.

Verwendung: job-where ist ein Funktionselement, das nicht ohne ein weiteres unmittelbar darauf folgendes Funktionselement verwendet werden kann. Mit job-where erhält man die Liste der Namen der Jobs, die dem Suchkriterium entsprechen. Erst durch das folgende Funktionselement wird bestimmt, wie die ermittelten Jobs zu behandeln sind. Jedes der Elemente, die auf job-where folgen können, entspricht dabei einer Schablone, die nacheinander auf jeden der mit job-where ermittelten Jobs angewendet wird (siehe Requests als Schablonen und die Darstellung der Ergebnis-Daten).

Rückgabewert bei Erfolg: die Liste der Namen der passenden Job-Einträge.

Erforderliche Rechte: keine Einschränkungen.