Vorheriges Thema: BeispielNächstes Thema: removeJob – Entfernen von Jobs aus der Jobliste


reinstallProduct – Neuinstallation des Produkts

Diese Aktion installiert ein Produkt, das bereits als installiert gekennzeichnet ist, auf dem Zielcomputer neu.

Diese Aktion hat das folgende Format:

targetcomputer action=reInstallProduct
name=Computername
item=Elementname 
version=Elementversion 
procedure=Installationsprozedur
cname=[Name]
[{noLinkage|rollback|synchronized}]
[nocascade]
[deliveryTime=JJJJ-MM-TT HH:MM] 
[atTime=JJJJ-MM-TT HH:MM]
after={exacttime|boottime} 
[calendarname=Name_des_Lieferungskalenders]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[promptUser[={y|n}]] 
[allowCancel[={y|n}]] 
[execTimedOut[={y|n}]]
[prompt=Tage.Stunden] 
[offline[={y|n}]] 
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]] 
[globalTime] 
[noCalendar]
[parameters=Benutzerparameter] 
[jobTimeOut=t.h]
[unsealed]
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 =y" 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.

Wenn durch diesen Aufruf "promptUser" weder festgelegt wird, noch bereits aktiviert ist, wird dieser Parameter ignoriert. Es wird keine Warnung angezeigt.

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 des Kalenders, der die Zeit steuert, während der die Evaluierung ausgeführt werden kann.

cname

Gibt Folgendes an: optionaler eindeutiger Name eines Jobcontainers. (Standard: Zielcomputername[JJJJ-MM-TT hh:mm:ss]).

Er wird für die Verteilung der Anforderung verwendet. Wenn der Container bereits vorhanden und nicht versiegelt ist, wird er ohne eine Änderung seiner Verknüpfungsoptionen oder Überlappungsoptionen verwendet. Wenn er vorhanden, aber versiegelt ist, wird ein Fehler gemeldet. Wenn er nicht vorhanden ist, wird der Jobcontainer entsprechend der angegebenen Verknüpfungs- und Überlappungsparameter erstellt.

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.

Wenn durch diesen Aufruf "promptUser" weder festgelegt wird, noch bereits aktiviert ist, wird dieser Parameter ignoriert. Es wird keine Warnung angezeigt.

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.

item

Gibt Folgendes an: Name des Elements, der neu installiert werden soll.

jobTimeOut

Gibt Folgendes an: "jobTimeout" gibt den Ablaufzeitraum eines Jobs im Format "t.h" ein, wobei "t" für die Anzahl der Tage und "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.
"jobTimeout" sollte nicht mit dem Parameter "timeout" angegeben werden, da dies zu Fehlern führt. Wenn kein Parameter angegeben wird, gilt die Standardeinstellung "7.0".

Name

Gibt Folgendes an: Name des Computers, auf dem das Produkt neu installiert werden soll.

noCalendar

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

noCascade

Die Jobverknüpfungsoption wird auf "Überlappung ignorieren" gesetzt.

Dieser Parameter ist nur zulässig, wenn "Transaktion" oder "synchronisiert" angegeben sind.

noLinkage|rollback|synchronized

Wenn mehrere Jobs vorhanden sind, verarbeitet dieser Modus die Verknüpfung zwischen den einzelnen Jobs eines Jobcontainers. Dieser Code besitzt die folgende Funktion:

Nicht verwendet

Der Modus Batch-Job wird ohne Rollback verwendet.

noLinkage

Führt den Job unabhängig von den anderen Jobs im Container aus.

rollBack

Setzt die Jobverknüpfungsoption auf "Transaktion aktivieren".

synchronisiert

Die Jobverknüpfungsoption wird auf "Synchronisierte Jobausführung" gesetzt.

offline

Wenn "offline" oder "offline=y" 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.

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

parameters

Gibt Folgendes an: Benutzerparameter für die Prozedur.
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 die notwendigen Aktionen an, die nach Abschluss der angegebenen Prozedur ausgeführt werden müssen. 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.

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

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 Folgendes an: Name einer Prozedur

Prozedur, die für die Neuinstallation verwendet werden soll.

prompt=d.h

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

Wenn durch diesen Aufruf "promptUser" weder festgelegt wird, noch bereits aktiviert ist, wird dieser Parameter ignoriert. 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.

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

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.

unsealed

Der adressierte Jobcontainer bleibt unversiegelt, nachdem der generierte Job erfolgreich erstellt wurde.

Version

Gibt Folgendes an: Version des Elements.

Die Parameter "allowCancel", "execTimedOut" und "prompt" sind gültig, wenn die Option "promptUser" bereits festgelegt wurde oder mit Hilfe des Parameters "promptUser" von diesem Befehl festgelegt wird.
Wenn weder die Option "promptUser" eines Jobs noch der Parameter "promptUser" des Befehls festgelegt wird, werden diese Parameter ignoriert.
Es wird keine Warnung angezeigt.