Vorheriges Thema: BeispielNächstes Thema: resume – Wiederaufnehmen einer angehaltenen Verteilung


renewjob – Erneuern eines Jobs

Der Renewjob-Befehl erneuert einen fehlgeschlagenen Job. Der Befehl ist nur gültig, wenn er vom Domänen-Manager ausgegeben wird.

Dieser Befehl hat das folgende Format:

renewjob  
item=Elementname  
version=Versionsname 
procedure=Prozedurname 
installedwith=Name_der_Installationsprozedur 
task={install | activate | configure | uninstall}
[deliverytime="jjjj-mm-tt hh:mm" ]
[calendername=Lieferausschlusskalender]
[attime="jjjj-mm-tt hh:mm" ]
[timeout=Stunden]
[runAtShutdown[={y|n}]]
[userJobMessage]
[userMessage]

oder

renewjob 
cname=[Name]
[item=Elementname  
version=Versionsname 
procedure=Prozedurname ]
[deliverytime="jjjj-mm-tt hh:mm" ]
[attime="jjjj-mm-tt hh:mm" ]
[calendername=Lieferausschlusskalender]
[timeout=Stunden]
[runAtShutdown[={y|n}]]
[userJobMessage]
[userMessage]
atTime

Gibt Folgendes an: 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.

calendarname

Gibt Folgendes an: Name eines Kalenders, der die Zeiträume angibt, in denen Lieferungen ausgeschlossen sind

cname

Gibt an: optionaler eindeutiger Name eines Jobcontainers, der die zu erneuernden Jobs enthält.

Die Parameter "item", "version" und "procedure" sind optional, wenn "cname" angegeben ist:

Wenn letztere angegeben sind, werden nur die Jobs des Containers, die durch diese Parameter angegeben sind, erneuert.

Wenn sie nicht angegeben sind, werden alle erneuerbaren Jobs des angegebenen Containers erneuert.

Wenn "cname" nicht angegeben ist, ist der zu erneuernde Job der erste erfasste erneuerbare Job, der der Spezifikation der Parameter "item", "version", "installedWith", "procedure" und "task" entspricht.

deliverytime

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

installedWith

Gibt Folgendes an: Name der Installationsprozedur.

Der zu erneuernde Job wurde mit dieser Prozedur installiert.

Der Parameter wird ignoriert, wenn "cname" angegeben ist.

item

Gibt Folgendes an: Name des Elements. Der zu erneuernde Job muss sich auf dieses Element beziehen.

Prozedur

Gibt Folgendes an: Name einer Prozedur. Der zu erneuernde Job muss sich auf diese Prozedur beziehen.

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.

task

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

Die wiederherzustellende Prozedur muss sich auf eine Prozedur dieses Task-Typs beziehen.

install

Eine Installationsprozedur.

configure

Eine Konfigurationsprozedur.

activate

Eine Aktivierungsprozedur.

uninstall

Eine Deinstallationsprozedur.

Der Parameter wird ignoriert, wenn "cname" angegeben ist.

timeout

Gibt Folgendes an: "timeout" gibt den Ablaufzeitraum eines Jobs im Format "h" ein, wobei "h" für die Anzahl der Stunden steht. Der Parameterbereich kann über den Manager definiert werden. Wenn der angegebene Wert den konfigurierten Maximalwert überschreitet, wird dieser Wert auf den Maximalwert gesetzt. Wenn der angegebene Wert den Mindestwert unterschreitet, wird der Mindestwert verwendet. Es wird keine Warnung angezeigt.
Der Parameter "timeout" sollte nicht mit dem Parameter "jobTimeout" angegeben werden, da dies zu Fehlern führt. Wenn kein Parameter angegeben wird, gilt die Standardeinstellung "168".

Version

Gibt Folgendes an: Version des Elements, dessen Registrierung aufgehoben wird.

userJobMessage

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

userMessage

Gibt die benutzerdefinierte Administratormeldung für einen Jobcontainer an.

Hinweis: Der erste Job mit Fehlerstatus in der Jobliste, der den Parametern "item", "version", "procedure" und "installedWith" entspricht, wird für die Operation "renew" ausgewählt. Diese verwendet die von dem Parameter "procedure" angegebene Prozedur.

Hinweis: In der "cname"-Variante des Befehls sind die Parameter "block item", "version" und "procedure" optional. Wenn Sie nicht angegeben werden, werden alle erneuerbaren Jobs des Containers erneuert.