Vorheriges Thema: ProzedurparameterNächstes Thema: Jobspezifische Makros


Parametermakros

Es werden mehrere Parametermakros unterstützt (die bei der Aktivierung der Elementprozedur erweitert werden), sofern sie für die Umgebung geeignet sind.

Die Parametermakros werden in die folgenden Gruppen unterteilt:

Jobspezifische Makros
$rf

Erstellt eine Ergebnisdatei, um die Ausgabe eines Jobs anzuzeigen.

1. Wenn die Anwendung über einen Parameter zum Schreiben der Ausgabe in eine Datei verfügt, z. B. "/F", kann "/F:$rf" festgelegt werden (wenn die Syntax des Befehls "/F:Datei" angibt).

2. Wenn die Ausgabe der Anwendung in "stdout" geschrieben wird, können Sie diese mit ">$rf" in die Ausgabedatei umleiten. Weitere Informationen finden Sie auf dieser Seite im letzten Abschnitt.

Um die Ausgabe eines Jobs anzuzeigen, erweitern Sie einen in der Jobliste enthaltenen Job, und wählen Sie im rechten Fensterbereich ein Jobziel aus. Klicken Sie mit der rechten Maustaste darauf, und wählen Sie im Kontextmenü die Option "Eigenschaften...". Klicken Sie im daraufhin angezeigten Dialogfeld "Jobzieleigenschaften" auf die Registerkarte "Jobausgabe". Dadurch wird die Ergebnisdatei eingeblendet.

$up

Die Auswahl dieses Makros ermöglicht die Definition von Benutzerparametern auf der Registerkarte Joboptionen.

$joid

Erweitert zur Jobobjekt-ID (dies kann bei der Erstellung eindeutiger Schlüssel hilfreich sein):

$#bg

Führt den Job im Hintergrund aus.

$#ec:xx

Setzt die übliche Interpretation des Beendigungscodes außer Kraft (wobei Beendigungscode=0 für "OK" steht; andernfalls "Fehler"). Sie können dies durch eine ausdrückliche Spezifikation der Beendigungscodeinterpretation ändern. Die Spezifikation kann mit Hilfe einer der vier folgenden Methoden vorgenommen werden (wobei die Spezifikationen verkettet werden können).

$#ec:a-b

wobei "a" für den Start und "b" für das Ende des Intervalls steht.

$#ec:a-

wobei "a" für den Start des (nach oben offenen) Intervalls steht.

$#ec:-b

wobei "b" für das Ende des (bei 0 beginnenden und nach unten offenen) Intervalls steht.

$#ec:b

wobei "b" den spezifischen Beendigungscode angibt.

Beispiel:

$#ec:3010 $#ec:0-100. Der Beendigungscode 3010 und alle Codes im Intervall zwischen 0 und 100 werden hier als gültig aufgefasst.

Zielspezifische Makros
$cn

Wählt den Computernamen und die LAN-ID des PCs, auf dem die Elementprozedur ausgeführt wird.

Erweiterter Wert:

ComputerName ComputerLanId.

$hd

Gibt die Buchstaben der Festplattenlaufwerke als Zeichenfolge aus. Erweiterter Wert: CDE (Zeichenfolge der Laufwerksbuchstaben).

"$hd" wird nicht für UNIX-Elementprozeduren unterstützt.

$()

Bei diesem Makro können Sie in den Klammern auf einen Parameter verweisen, der in der Software Delivery-Datenbank auf dem Software Delivery-Server gespeichert ist, wenn die folgenden Voraussetzungen erfüllt sind:

1. Ein Parameterpaket wurde mit Hilfe des Packagers erstellt und in der Bibliothek registriert.

2. Das Parameterpaket wurde zur Evaluierung des Parameterverweises auf dem Software Delivery-Server installiert.

Der Inhalt in den Klammern hat die Struktur X/Y/Parameter, wobei gilt: X=der Paketcomputer, auf dem das Parameterpaket erstellt wurde, und Y=das Parameterpaket.

"$()" kann ebenfalls in Abfragen und als Benutzerparameter beim Definieren von Jobs verwendet werden.

Softwareelement-spezifische Makros
$in

Wird zum Elementnamen erweitert.

$iv

Wird zur Elementversion erweitert.

$ip

Wird zum Quellpfad der Elementprozedur (in der Bibliothek) erweitert. Dies kann z. B. beim Schreiben einer Batch-Datei, die auf das Stammverzeichnis der Quelldateien verweist, nützlich sein.

Dieses Makro kann nicht von externen Prozeduren verwendet werden.

$pn

Wird zum Prozedurnamen erweitert.

$pf

Wird zur aktuellen Prozedurdatei (des aktuellen MSI-Pakets) erweitert.

$ioid

Wird zur Elementobjekt-ID erweitert. Dies kann bei der Erstellung eindeutiger Schlüssel hilfreich sein.

$pt

Erweitert die Einträge bis zum Elementprozedur-Maskentyp, d. h. "Installieren", "Deinstallieren", "Konfigurieren" und "Aktivieren".

Managerzeitspezifische Makros
$cl

Wählt das auf der Manageruhr angezeigte Datum und die Zeit aus, zu der die Aktivierung stattgefunden hat.

Erweiterter Wert: Stunde Minuten Sekunden Jahr Monat Tag.

$cl+nn

Wählt die Managerzeit und fügt die angegebene Anzahl Minuten hinzu.

Hier gilt die gleiche Erweiterung wie für "$cl".

$cl-nn

Wählt die Managerzeit und subtrahiert die angegebene Anzahl von Minuten.

Hier gilt die gleiche Erweiterung wie für "$cl".

Softwarespeicherort-spezifische Makros
$msi

Wird zum Pfad des Verzeichnisses erweitert, in dem sich "MSILIB" befindet; der für MSI-Verwaltungsinstallationen verwendete Pfad.

Dieses Makro gilt nur für MSI-Pakete.

Die entsprechende Elementprozedur führt nun die Erweiterung zum Unterverzeichnis MSI aus, in das eine Verwaltungsinstallation des aktuellen Elements abgelegt wurde.

$cd()

Wird beispielsweise zur Angabe eines Pfades einer Datei auf einer bestimmten CD verwendet.

Verwendung: "$cd(OfficeSw)\Subdir\msispy.msi", wobei "OfficeSw" die CD-Bezeichnung und "Subdir" das Verzeichnis auf der CD ist, in dem sich die MSI-Datei "msispy.msi" befindet.

Neustartspezifische Makros

Die folgenden Makros können der Befehlszeile der Prozedur oder als Benutzerparameter für den Jobcontainer hinzugefügt werden, sofern die Befehlszeile der Prozedur Benutzerparameter akzeptiert. Dies kann mit dem Makro "$up" aktiviert werden. Während der Jobevaluierung und -erstellung sucht der Manager nach diesen Makros. Falls er sie findet, werden sie aus der Befehlszeile entfernt und in Jobdefinitionseigenschaften umgewandelt, die dann an die Agenten gesendet werden.

$rto:Wert

Gibt das Zeitlimit in Sekunden für das Dialogfeld zum Herunterfahren an. Wert ist ein numerischer Wert größer 0. Wenn kein Wert angegeben wird, wird er durch die Konfigurationsrichtlinie festgelegt. Wenn ein Wert festgelegt wird, gilt er für das anfängliche Zeitlimit und jede nachfolgende Verschiebung.

Dieses Makro wird von den Routinen "logoff" und "reboot" verwendet.

Außer Kraft gesetzte Richtlinie: ITRM/USD/Agent/RebootPromptTO.

$rrt:Wert

Gibt die Anzahl der zulässigen Verschiebungen an. Wert ist ein numerischer Wert größer 0. Wenn kein Wert angegeben wird, wird er durch die Konfigurationsrichtlinie festgelegt.

Dieses Makro wird von den Routinen "logoff" und "reboot" verwendet.

Außer Kraft gesetzte Richtlinie: ITRM/USD/Agent/RebootPromptRT.

$rbp:Wert

Gibt an, ob eine Meldung angezeigt werden soll, bevor ein Neustart oder eine Abmeldung initiiert wird. Der Wert beträgt 0 oder 1. Wenn kein Wert angegeben wird, wird er durch die Konfigurationsrichtlinie festgelegt. Wenn "1" festgelegt ist, wird der angeforderte Neustart oder das Abmelden nicht automatisch initiiert. Stattdessen wird eine Meldung angezeigt, in der der Benutzer aufgefordert wird, seine Arbeit zu speichern. Die Meldung besitzt keinen Timer und kann nur vom Benutzer geschlossen werden. Nachdem die Meldung geschlossen wurde, wird das Herunterfahren initiiert.

Dieses Makro wird von den Routinen "logoff" und "reboot" verwendet.

Außer Kraft gesetzte Richtlinie: ITRM/USD/Agent/PoliteReboot.

$rbf:Wert

Gibt an, ob das Herunterfahren erzwungen werden soll. Der Wert beträgt 0 oder 1. Wenn kein Wert angegeben wird, wird er durch die Konfigurationsrichtlinie festgelegt. Wenn 1 festgelegt wurde, erzwingt die Routine "shutdown" das Herunterfahren der Programme.

Dieses Makro wird von den Routinen "logoff" und "reboot" verwendet.

Außer Kraft gesetzte Richtlinie: ITRM/USD/Agent/ForcedReboot.

Beispiel: Die Makros werden ohne Benutzerparameter verwendet.

Befehlszeile der Prozedur: "setup.exe $rto:50 $rrt:0 $rbp:0 $rbf:1"

Beispiel: Die Makros werden mit Benutzerparametern verwendet.

Befehlszeile der Prozedur: "setup.exe $up"

Jobbenutzerparameter: "$rto:50 $rrt:0 $rbp:0 $rbf:1"

Verhalten zum Abmelden/Neustarten nach dem letzten Job:

Die Boot-Option "Benutzer nach letztem Job abmelden/Nach letztem Job neu starten" kann zur Folge haben, dass mehr als ein Job versucht, die verwendeten Boot-Parameter zu beeinflussen. Diese Vorgehensweise wird auch verwendet, wenn die Neustartparameter für einen Job angegeben werden, für den keine Abmeldung und kein Neustart angefordert wurden. In diesem Fall gelten die folgenden Regeln:

Hinweise zur Kompatibilität:

Für die Funktionalität zum Außerkraftsetzen des Neustarts ist Client Automation r11.2 erforderlich. Wenn ein Manager der Version r11.2 mit Scalability-Servern oder Agenten einer früheren Version kombiniert wurde, funktioniert das Außerkraftsetzen des Neustarts nicht, und der Agent verwendet die Standardkonfiguration. Falls der Manager nicht Version r11.2 aufweist, verbleiben die Makros in der Befehlszeile und werden schließlich als normale Parameter an den vom Agenten gestarteten Installer übergeben.

InstallShield-Parameter
/SMS

Bewirkt, dass die Datei "setup.exe" von InstallShield vor dem Beenden automatisch auf die Fertigstellung der Installation wartet.

/s

Führt InstallShield Silent für eine Installation im Hintergrund aus. Eine Antwortdatei ist erforderlich.

/f1"setup.iss"

Gibt einen alternativen Speicherort und Namen der Antwortdatei (.iss-Datei) an. Eine Antwortdatei wird mit Hilfe des Parameters "/r" erstellt.

/f2$rf

Gibt einen alternativen Speicherort und Namen der durch InstallShield Silent erstellten Protokolldatei an.

/verbose$rf

Stellt bei einem Fehler von "setup.exe" detaillierte Informationen zur Verfügung.

/uninst

Führt "setup.exe" wie eine Deinstallation ohne Lesen des Skripts aus.

/m"Dateiname.mif"

Veranlasst Setup, am Ende der Installation automatisch eine MIF-Datei (Management Information Format) zu erstellen.

/m1[Seriennummer]

Veranlasst Setup, die durch den Schalter "/m" generierte angegebene Seriennummer in der MIF-Datei abzulegen.

/m2[Zeichenfolge für Gebietsschema]

Gibt die Sprache an, in der die Installation ausgeführt wird. Hier handelt es sich bei [language ID] um eine numerische Sprach-ID der Form "0xnnnn" oder einfach "nnnn".

Das $-Zeichen sollte nur in den oben erwähnten Parametermakros verwendet werden. In anderen Parametern sollte das $-Zeichen nicht enthalten sein.

Informationen zu den Parametern "/fd" und "$sl\activate" finden Sie in der Beschreibung des Befehls "sd_swdet".