Operating System BS2000 OS DX V1.0 (en)

&pagelevel(3)&pagelevel

Start POSIX installation program

Component:	POSIX-BC
Functional area:	POSIX administration and application
Domain:	SYSTEM-MANAGEMENT
Privileges:	TSOS POSIX-ADMINISTRATION

Function

The START-POSIX-INSTALLATION command starts the POSIX installation program. The installation program can run in interactive mode, the installation statements being inquired via FHS masks. The installation program can also run automatically if a parameter file containing all the installation statements is specified.

Execution of the POSIX installation program is described in detail in the “POSIX Basics for Users and System Administrators” manual [28].

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

Operands

INPUT-INTERFACE = *STD / *FHS / *FILE(...)
Specifies whether installation is to run in interactive mode or automatically.

INPUT-INTERFACE = *STD / *FHS
Installation is to run in interactive mode (via FHS masks). Execution of installation in interactive mode is described in the “POSIX Basics for Users and System Administrators” manual [28].

INPUT-INTERFACE = *FILE(...)
Installation is to run automatically using the specified parameter file. Automatic execution of installation and details on how to set up the parameter file are described in the “POSIX Basics for Users and System Administrators” manual [28].

FILE-NAME = <filename 1..54>
Name of the parameter file.

ERROR-HANDLING = *PARAMETERS(...)
Defines the response when errors occur.

RETURNCODE = *NO / *YES
Defines whether, when errors occur, the command is to supply a POSIX-specific command return code (with the maincode POS295x) and trigger the spin-off mechanism.

RETURNCODE = *NO
When errors occur, the spin-off mechanism is not triggered and command return codes are not supplied.

RETURNCODE = *YES
When errors occur, the spin-off mechanism is triggered in procedures and the command supplies return codes (with the maincode POS295x).

ABORT-ON-WARNING = *NO / *YES
Controls the behavior when errors of the class ’warning’ occur in the parameter file (with the maincode POS2956).

When errors of the class ’error’ occur, processing of the parameter file is always aborted; when errors of the class ’note’ occur, processing is always continued in the next line.

ABORT-ON-WARNING = *NO

Processing of the parameter file is continued in the next line when errors of the class ’warning’ occur.

ABORT-ON-WARNING = *YES
Processing of the parameter file is aborted when errors of the class ’warning’ occur.

Return codes

POSIX-specific command return codes (i.e. with maincode POS295x) are returned only if RETURNCODE=*YES was specified. When RETURNCODE=*NO is specified, command return codes which are returned in the event of an error (subcode 1 not 0) cannot be guaranteed.

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	No errors
	64	POS2950	Invalid procedure parameter file.
	64	POS2951	Parameter file was not found or is not accessible.
	64	POS2952	The user ID is not authorized to execute the POSIX installation program.
	64	POS2953	Another instance of the POSIX installation program is currently being executed.
	64	POS2954	Installation program cannot be loaded.
	64	POS2955	Serious error in the installation program.
lno	64	POS2956	Error in the parameter file. The number of the line (lno) in or after which the error occurred can be taken from the SC2. In the case of batch installation in online mode, detailed information can be found in the POSIX file `/var/sadm/pkg/insterr`.
	64	POS2957	Timeout when waiting for a POSIX restart. File is locked.

Logging errors in the parameter file (maincode POS2956)

In the case of batch installation in online mode, i.e. not in the case of initial installation or file system extension in offline mode, the following information is written to the POSIX file /var/sadm/pkg/insterr:

Name of the parameter file
Date and time of installation

In the event of notes / warnings / errors, also:

Errored line in the parameter file
Error class (note, warning, error) and error text

Sample logging file

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