<job-create>

Definition:

<!ENTITY % cm.job-create "
  (name,
  comment?,
  execLogin?,
  execPerm?,
  isActive?,
  schedule?,
  script?,
  title?)
">
<!ELEMENT job-create %cm.create>

Aufgabe: Erzeugt einen neuen Job mit den angegebenen Parameterwerten.

Zusatzinformationen: Es ist empfehlenswert, mindestens ein globales Recht (beispielsweise permissionGlobalJobExec) zu definieren und neuen Jobs als erforderliches Ausführungsrecht zuzuweisen. Andernfalls können die Jobs von allen Benutzern ausgeführt werden.
Wird der Parameter execLogin nicht angegeben, so wird als dessen Wert das Login des authentifizierten Benutzers eingetragen.
Der Name des neuen Jobs muss angegeben werden. Von Benutzern können nur Jobs in der Kategorie user angelegt werden. Dies ist die voreingestellte Kategorie, so dass das Element category nicht angegeben werden muss.

Rückgabewert bei Erfolg: der Name des neuen Jobs.

Erforderliche Rechte: Der authentifizierte Benutzer muss Superuser sein.

Beispiel:

<cm-request...>
  <job-create>
    <name>myJob</name>
    <execLogin>stan</execLogin>
    <execPerm>permissionGlobalJobExec</execPerm>
    <script>obj root exportSubtree filePrefix /tmp</script>
  </job-create>
</cm-request>

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