Vorheriges Thema: Jobmanagement-BefehleNächstes Thema: Beispiel


addJob – Job zu Jobcontainer hinzufügen

Dieser Befehl fügt einem vorhandenen Jobcontainer einen Job hinzu. Sie dürfen den Jobcontainer nicht versiegeln.

Dieser Befehl hat das folgende Format:

jobcontainer action=addjob
name=Jobcontainername
{item=Elementname version=Elementversion  
procedure=Prozedurname
{[task=install] 
|task={configure|activate|uninstall}
[installedWith=Installationsprozedur]}
| group=Gruppenname [procedures=Datei]}
{{{compgrp=Computergruppenname | ccompgrp=(Computergruppenname Trennzeichen groupScope)} 
[sep=Trennzeichen]
|{computer=Computername}}
[deliverytime=JJJJ-MM-TT HH:MM ] 
[attime=JJJJ-MM-TT HH:MM ]
[{preaction={none|reboot|logoff}|bootbefore}]
[{postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}|bootafter}]
[promptUser[={y|n}]] 
[allowCancel[={y|n}]] 
[execTimedOut[={y|n}]]
[offline[={y|n}]] 
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]] 
after={exacttime|boottime}
[calendername=Lieferungskalender]
[globalTime=y|n] 
[nocalendar[={y|n}]]
[resolveQuery[={y|n}]] 
[stagingServer[={y|n}]]
[parameters=Benutzerparameter]
[prompt=Tage.Stunden]] 
[jobTimeOut=Tage.Stunden]
[reinstall[={y|n}]]
[userJobMessage]
after

Startzeit der Prozedur im Zielsystem.

Folgende Werte sind gültig:

exacttime

Die Prozedur wird sofort nach Erreichen von atTime gestartet.

boottime

Die Prozedur wird erst nach dem nächsten Neustart nach dem Ablauf von atTime ausgeführt.

allowCancel

Wenn "allowCancel" oder "allowCancel =j" angegeben ist, kann der Benutzer die Ausführung des Jobs abbrechen.

Bei Angabe von "allowCancel =n" ist dies dem Benutzer nicht möglich.

Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.

atTime

Gibt das Datum und die Uhrzeit an, an dem bzw. zu der die Aktion gestartet wird.

Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.

Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die aktuelle Uhrzeit verwendet.

calendarname

Gibt den Namen des Kalenders an, mit dem der Zeitraum bestimmt wird, in dem die Evaluierung ausgeführt werden kann.

ccompgrp

Gibt die Computergruppe mit Gruppenname und Bereich an. Standardmäßig sind Name und Bereich durch einen Punkt (".") getrennt. Sie können jedoch mit der Option "sep" ein anderes Trennzeichen festlegen. Das Trennzeichen darf nicht als Teil der Namen verwendet werden.

Für den Gruppenbereich sind nur die folgenden Werte gültig.

lokal

Die Gruppe wird auf dem lokalen Domänen-Manager erstellt.

global

Die Gruppe wurde auf dem Enterprise-Manager erstellt und kann repliziert werden.

"ccompgrp" kann mit "compgrp" in einem Aufruf angegeben werden.

compgrp

Gibt den Namen einer Gruppe von Computern an, auf denen das angegebene Produkt verarbeitet wird.

Der Parameter kann mehrfach angegeben werden, um mehrere Computergruppen zu bestimmen.

Der Parameter muss zusammen mit dem Computerparameter angegeben werden.

computer

Gibt den Namen des Computers an, auf dem das angegebene Produkt verarbeitet wird.

Der Parameter kann mehrfach angegeben werden, um mehrere Computer zu bestimmen.

Der Parameter muss zusammen mit dem Parameter "compgrp" angegeben werden.

deliveryTime

Gibt Folgendes an: Startzeit der Lieferung vom Domänen-Manager.
Das Datum wird im ISO-Format "JJJJ-MM-TT HH:MM" angegeben.

Wenn der Parameter nicht angegeben ist, werden das aktuelle Datum und die aktuelle Uhrzeit verwendet.

execTimedOut

Wenn "execTimedOut" oder "execTimedOut=y" angegeben ist, wird die Ausführung des Jobs automatisch gestartet, wenn das Zeitlimit der Benutzereingabe erreicht wird.

Wenn "execTimedOut=n" angegeben ist, wird der Job nicht automatisch gestartet.

globalTime

Wenn "globalTime" oder "globalTime=y" angegeben ist, basieren die Zeitangaben auf der Zeit des Enterprise-Managers.

Wenn "globalTime=n" angegeben ist, basieren sie auf der Zeit des Domänen-Managers.

Gruppe

Gibt den Namen einer Software oder Prozedurgruppe an, für die die Jobs generiert werden.

Der Parameter muss zusammen mit dem Parameter "item" angegeben werden.

installedWith

Gibt den Namen der Installationsprozedur an.

Dieser Parameter ist obligatorisch für die Tasks "configure", "activate" und "uninstall". Anderenfalls wird sie ignoriert.

item

Gibt den Namen des zu verarbeitenden Elements an.

Dieser Parameter muss zusammen mit dem Parameter "group" angegeben werden.

jobTimeOut

Gibt das Ablaufdatum des Jobs in Form eines Zeitraums an.

Der Zeitraum wird im Format "t.h." angegeben. Dabei steht "t" für Tage und "h" für Stunden.

Der Bereich dieses Parameters reicht von drei Stunden bis zu sieben Tagen (von 0.3 bis 7.0).

Wenn der angegebene Wert unter dem gültigen Mindestwert liegt, wird er durch den Mindestwert ersetzt.

Wenn der angegebene Wert den gültigen Maximalwert übersteigt, wird er durch den Maximalwert ersetzt.

Es wird keine Warnung angezeigt.

Name

Gibt den Namen des Jobcontainers an, dem der Job hinzugefügt wird.

noCalendar

Wenn "noCalendar" angegeben ist, wird ein möglicherweise auf dem Zielcomputer vorhandener Kalender für die Jobausführung ignoriert.

offline

Wenn "offline" oder "offline=j" angegeben ist, wird die Verbindung zwischen dem Zielcomputer und dem Server für die Jobausführung getrennt und anschließend wiederhergestellt.

Wenn "offline=n" angegeben ist, wird die Verbindung nicht getrennt.

parameters

Gibt die Benutzerparameter für die Prozedur an.

Mehrere Parameter müssen innerhalb von Anführungszeichen durch Leerzeichen getrennt werden.

Wenn eine leere Zeichenfolge eingegeben wird, werden keine Parameter mehr verwendet.

postaction

Gibt an, dass notwendige Aktionen ausgeführt werden müssen, nachdem die angegebene Prozedur abgeschlossen wurde. Folgende Werte sind gültig:

kein

Führt keine Folgeaktion aus.

reboot

Startet das System nach Abschluss der Prozedur neu.

logoff

Meldet den Benutzer nach Abschluss der Prozedur ab.

rebootAtEnd

Startet das System nach Abschluss aller Jobs dieses Containers neu.

logoffAtEnd

Meldet den Benutzer nach Abschluss aller Jobs dieses Containers ab.

shutdownAtEnd

Fährt den Zielcomputer nach Abschluss der Jobs herunter.

preaction

Gibt an, dass notwendige Aktionen ausgeführt werden müssen, bevor die angegebene Prozedur startet. Folgende Werte sind gültig:

kein

Führt keine vorangestellte Aktion aus.

reboot

Startet das System vor dem Start der Prozedur neu.

logoff

Meldet den Benutzer vor dem Start der Prozedur ab.

preventLogon

Wenn "preventLogon" oder "preventLogon=y" angegeben ist, werden Anmeldeversuche von Benutzern während der Ausführung des Jobs zurückgewiesen. Wenn ein Benutzer bereits angemeldet ist, wird die Ausführung des Jobs verzögert, bis sich der Benutzer abgemeldet hat.

Wenn "preventLogon=n" angegeben ist, wird der Anmeldeversuch nicht zurückgewiesen.

Prozedur

Gibt den Namen einer Prozedur an.

Verfahren

Gibt den Namen der Datei an, die die für die Softwaregruppe verwendeten Prozeduren und/oder die einzelnen Joboptionen für die Prozeduren (Software- und Prozedurgruppen) definiert.

Informationen zum Inhalt dieser Prozedurdatei finden Sie unter "Format der Prozedurdatei".

prompt

Gibt die Zeitspanne an, in der der Benutzer zum Starten des Jobs aufgefordert wird.

Der Zeitraum wird im Format "t.h" angegeben. Dabei steht "t" für Tage und "h" für Stunden.

Der Bereich dieses Parameters reicht von drei Stunden bis zu sieben Tagen (von 0.3 bis 7.0). Wenn der angegebene Wert unter dem gültigen Mindestwert liegt, wird er durch den Mindestwert ersetzt. Wenn der angegebene Wert den gültigen Maximalwert übersteigt, wird er durch den Maximalwert ersetzt. Es wird keine Warnung angezeigt.

promptUser

Wenn "promptUser" oder "promptUser=j" angegeben ist, wird der Benutzer zur Ausführung des Jobs aufgefordert.

Wenn "promptUser=n" eingegeben wird, wird der Benutzer nicht aufgefordert.

reinstall

Optional. Standard: "reinstall=n"

Wenn "reinstall" oder "reinstall=y" codiert ist, wird ein ggf. vorhandener zum Auftrag gehöriger Installationsdatensatz entfernt, bevor der Job durch den Domänen-Manager ausgewertet wird.

Wenn "reinstall=n" codiert ist, bleiben solche Datensätze bestehen.

Hinweis: Diese Option gilt nur für Installationsjobs. In allen anderen Fällen wird sie ignoriert.

resolveQuery

Wertet vor Erstellung des Jobs eine möglicherweise vorhandene Abfragegruppe aus.

runAtShutdown

Wenn "runAtShutdown" oder "runAtShutdown=y" angegeben ist, wird die Ausführung des Jobs erst beim Herunterfahren gestartet.

Wenn "runAtShutdown=n" angegeben ist, wird die Ausführung des Jobs auch zu beliebigen anderen Zeitpunkten gestartet.

Wenn der Parameter nicht angegeben ist, wird standardmäßig der Joboptions-Wert der zugehörigen Prozedur verwendet.

Dieser Parameter wird nur für Unix-Ziele verwendet.

sep

Gibt ein alternatives Trennzeichen für die Option "ccompgroup" an. Das Trennzeichen darf nicht Teil des Gruppennamencodes für die "ccompgroup"-Optionen sein.

stagingServer

Liefert das zugehörige Produkt auch an die Staging-Bibliotheken der Scalability-Server der Zielcomputer.

Dieser Parameter bezieht sich nur auf Prozeduren des Aufgabentyps "install".

task

Gibt den Typ des von der Elementprozedur auszuführenden Tasks an.

Die folgenden Typen sind zulässig:

activate

Die Prozedur aktiviert das Element.

configure

Die Prozedur konfiguriert das Element.

install

Die Prozedur installiert das Element.

uninstall

Die Prozedur deinstalliert das Element.

Bei fehlender Angabe des Parameters wird "install" angenommen.

Version

Gibt die Version des zu verarbeitenden Elements an.

userJobMessage

Gibt die benutzerdefinierte Administratormeldung für einen Job in einem Jobcontainer an.

Hinweis: Sie sollten Folgendes beachten:

Format der Prozedurdatei

Die Prozedurdatei besteht aus Einträgen mit der folgenden Syntax:

item = Element 
version = Version 
procedure = Prozedur 
task={install|configure|activate|uninstall}
[deliverytime="JJJJ-MM-TT hh:mm" ] 
[attime="JJJJ-MM-TT hh:mm" ]
[after={exacttime|boottime}] 
[calendarname=Lieferungskalender]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd}]
[promptUser={y|n}] 
[allowCancel={y|n}] 
[execTimedOut={y|n}] 
[prompt=Tage.Stunden]
[offline={y|n}] 
[RunAtShutdown={y|n}] 
[PreventLogon={y|n}] 
[GlobalTime={y|n}] 
[nocalendar={y|n}]
[ResolveQuery={y|n}] 
[Parameters=Benutzerparameter]
[stagingserver={y|n}]
[JobTimeout=t.h]
item

Name des Gruppenelements, mit dem dieser Eintrag verbunden ist.

Version

Version des Gruppenelements, mit dem dieser Eintrag verbunden ist.

Prozedur

Gibt die durchzuführende Elementprozedur an.

task

Gibt den Prozedurentyp an.

Die folgenden Typen sind zulässig:

install

Die Prozedur installiert das Element.

configure

Die Prozedur konfiguriert das Element.

activate

Die Prozedur aktiviert das Element.

uninstall

Die Prozedur deinstalliert das Element.

Bei fehlender Angabe des Parameters wird "install" angenommen.

Die Parameter "item", "version", "procedure" und "task" müssen in jeder Zeile als erste Parameter angegeben werden, und die Angabe muss in der Reihenfolge wie in der oben dargestellten Syntaxdefinition erfolgen. Die verbleibenden Parameter können in beliebiger Reihenfolge angegeben werden.

Die Bedeutung der anderen Parameter entspricht der Bedeutung der in "cadsmcmd jobcontainer action=addjob" dargestellten Befehlsparameter.

Die Prozeduroptionen für eine Jobprozedur werden aus den Einstellungen in dieser Liste übernommen.

Wenn für eine Prozedur im entsprechenden Listeneintrag keine Option angegeben wurde, wird die Einstellung der Befehlsebene verwendet.

Ist sie nicht angegeben, wird sie den registrierten Prozeduroptionen entnommen.