Betriebssystem BS2000 OS DX V1.0B (de)

&pagelevel(3)&pagelevel

POSIX-Installationsprogramm starten

Komponente:	POSIX-BC
Funktionsbereich:	POSIX verwalten und benutzen
Anwendungsbereich:	SYSTEM-MANAGEMENT
Privilegierung:	TSOS POSIX-ADMINISTRATION

Funktionsbeschreibung

Das Kommando START-POSIX-INSTALLATION startet das POSIX-Installationsprogramm. Das Installationprogramm kann im Dialog ablaufen, wobei die Installationsanweisungen über FHS-Masken abgefragt werden. Mit Angabe einer Parameterdatei, die alle Installationsanweisungen enthält, kann das Installationsprogramm auch automatisiert ablaufen.

Der Ablauf des POSIX-Installationsprogramm ist detailliert im Handbuch „POSIX Grundlagen“ [28] beschrieben.

Format

START-POSIX-INSTALLATION

INPUT-INTERFACE = STD / FHS / *FILE(...)
	*FILE(...)
		\|	FILE-NAME = <filename 1..54>
		\|	,ERROR-HANDLING = *PARAMETERS(...)
		\|		*PARAMETERS(...)
		\|			\|	RETURNCODE = NO / YES
		\|			\|	,ABORT-ON-WARNING = NO / YES

Operandenbeschreibung

INPUT-INTERFACE = *STD / *FHS / *FILE(...)
Gibt an, ob die Installation im Dialog oder automatisiert ablaufen soll.

INPUT-INTERFACE = *STD / *FHS
Die Installation soll im Dialog (über FHS-Masken) ablaufen. Der Ablauf der Installation im Dialog ist im Handbuch „POSIX Grundlagen“ [28] beschrieben.

INPUT-INTERFACE = *FILE(...)
Die Installation soll automatisiert ablaufen unter Verwendung der angegebenen Parameterdatei. Der automatisierte Ablauf der Installation sowie der Aufbau der Parameterdatei ist im Handbuch „POSIX Grundlagen“ [28] beschrieben.

FILE-NAME = <filename 1..54>
Name der Parameterdatei.

ERROR-HANDLING = *PARAMETERS(...)
Legt die Reaktion in Fehlerfällen fest .

RETURNCODE = *NO / *YES
Legt fest, ob das Kommando in Fehlerfällen einen POSIX-spezifischen
Kommando-Returncode (mit dem Maincode POS295x) 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 (mit dem Maincode POS295x).

ABORT-ON-WARNING = *NO / *YES
Steuert das Verhalten, wenn in der Parameterdatei Fehler der Klasse ’warning’ auftreten (bei Maincode POS2956).

Bei Fehlern der Klasse ’error’ wird die Verarbeitung der Parameterdatei immer abgebrochen, bei Fehlern der Klasse ’note’ wird die Verarbeitung immer mit der nächsten Zeile fortgesetzt.

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-Returncode

POSIX-spezifische Kommando-Returncodes (d.h. mit Maincode POS295x) werden nur zurückgeliefert, wenn RETURNCODE=*YES angegeben wurde. Bei RETURNCODE=*NO können Kommando-Returncodes, die im Fehlerfall zurückgeliefert werden (Subcode 1 ungleich 0), nicht garantiert werden.

(SC2)	SC1	Maincode	Bedeutung / garantierte Meldungen
	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

Beispiel einer Protokolldatei

input file : :FR01:$TSOS.POSIX-INSTALL.FS.TMP.TEST
time       : Wed Jan 28 13:17:40 2017
- 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 2017
- 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 2017
- line 1   : [FirstInstallation]
  error    : POSIX subsystem is available

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

START-POSIX-INSTALLATION