POSIX-Installationsprogramm starten
| Anwendungsbereich: | SYSTEM-MANAGEMENT |
| Privilegierung: | TSOS POSIX-ADMINISTRATION |
Dieses Kommando startet das POSIX-Installationsprogramm.
Format
START-POSIX-INSTALLATION | |||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
INPUT-INTERFACE = *STD / *FHS / *FILE(...)
Angabe, ob die Installation im Dialog oder automatisiert ablaufen soll.
INPUT-INTERFACE = *STD / *FHS
Die Installation soll im Dialog (über FHS-Masken) ablaufen. Zum Ablauf der Installation siehe "POSIX-Installationsprogramm im Dialog".
INPUT-INTERFACE= *FILE(...)
Die Installation soll automatisiert ablaufen unter Verwendung der angegebenen Parameterdatei. Zum Aufbau der Parameterdatei siehe "Automatisierter Ablauf des POSIX-Installationsprogramms".
FILE-NAME= <filename 1..54>
Name der Parameterdatei.
ERROR-HANDLING=*PARAMETERS(...)
Legt die Reaktion in Fehlerfällen fest .
RETURN-CODE=*NO / *YES
Legt fest, ob das Kommando in Fehlerfällen einen Returncode liefern und den Spin-Off-Mechanismus auslösen soll.
RETURNCODE=*NO
In Fehlerfällen wird der Spin-Off-Mechanismus nicht ausgelöst und Kommando-Returncodes werden nicht geliefert.
RETURNCODE=*YES
In Fehlerfällen wird innerhalb von Prozeduren der Spin-Off-Mechanismus ausgelöst und das Kommando liefert Returncodes (MAINCODE = POS295x).
ABORT-ON-WARNING=*NO / *YES
Steuert das Verhalten, wenn in der Parameterdatei Fehler der Klasse ’warning’ auftreten (MAINCODE = POS2956).
ABORT-ON-WARNING=*NO
Die Verarbeitung der Parameterdatei wird bei Fehlern der Klasse ’warning’ mit der nächsten Zeile fortgesetzt.
ABORT-ON-WARNING=*YES
Die Verarbeitung der Parameterdatei wird bei Fehlern der Klasse ’warning’ abgebrochen.
Kommando-Returncodes
Die Ausgabe von Returncodes erfolgt nur bei Angabe von ERROR-HANDLING=*PARAMETERS(RETURNCODE=*YES).
| (SC2) | SC1 | Maincode | Bedeutung |
| 0 | CMD0001 | Ohne Fehler. | |
| 64 | POS2950 | Ungültiger Prozedurparameter. | |
| 64 | POS2951 | Parameterdatei wurde nicht gefunden oder ist nicht zugreifbar. | |
| 64 | POS2952 | Die Benutzerkennung ist nicht zur Ausführung des POSIX-Installationsprogramms berechtigt. | |
| 64 | POS2953 | Eine andere Instanz des POSIX-Installationsprogramms wird gerade ausgeführt. | |
| 64 | POS2954 | Installationsprogramm kann nicht geladen werden. | |
| 64 | POS2955 | Schwerer Fehler im Installationsprogramm. | |
| znr | 64 | POS2956 | Fehler in der Parameterdatei. Die Nummer der Zeile (znr), bei oder nach der der Fehler aufgetreten ist, kann dem SC2 entnommen werden. Bei Batch-Installation im Online-Modus sind detailliertere Informationen in der POSIX-Datei /var/sadm/pkg/insterr zu finden. |
| 64 | POS2957 | Zeitablauf beim Warten auf POSIX-Neustart. Datei ist gesperrt. |
Protokollierung von Fehlern in der Parameterdatei (MAINCODE = POS2956):
Bei Batch-Installation im Online-Modus, d.h. nicht bei einer Erstinstallation oder bei einer Dateisystemerweiterung im Offline-Modus, werden folgende Informationen in die POSIX-Datei /var/sadm/pkg/insterr geschrieben:
Name der Parameterdatei
Datum und Uhrzeit der Installation
Bei Hinweisen / Warnungen / Fehlern zusätzlich:
fehlerhafte Zeile in der Parameterdatei
Fehlerklasse (note, warning, error) und Fehlertext
Beispiele:
input file : :FR01:$TSOS.POSIX-INSTALL.FS.TMP.TEST time : Wed Jan 28 13:17:40 2009 - line 3 : a;$SYSROOT.FS.TMP.TEST;8192;Y;Y;/tmp/test;N;;y;N note : Line 3: BS2000 file already existing, file size may not be changed note : Line 3: file system size of existing filesystem will be used input file : :V70A:$TSOS.INSTALL.POSIX-SOCKENS time : Wed Jan 28 13:27:25 2009 - line 4 : POSIX-SOCKENS;Y warning : IMON-GPN: installation unit not found in SCI input file : :FR01:$TSOS.POSIX-INSTALL.FIRST time : Wed Jan 28 13:38:51 2009 - line 1 : [FirstInstallation] error : POSIX subsystem is available