Start the POSIX installation program
Domain: | SYSTEM-MANAGEMENT |
Privileges: | TSOS |
This command starts the POSIX installation program.
Format
START-POSIX-INSTALLATION | |||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||
Operands
INPUT-INTERFACE = *STD / *FHS / * FILE(...)
Specifies whether the installation is to run in interactive mode or in automated mode.
INPUT-INTERFACE = *STD / *FHS
The installation is to run in interactive mode (using FHS masks). See section “POSIX installation program in interactive mode” for details on the installation procedure.
INPUT-INTERFACE = *FILE(...)
The installation is to run in automated mode using the specified parameter file. For details on the structure of the parameter file, see the section “POSIX installation program in batch mode”.
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.
Command return codes
POSIX-specific command return codes (i.e. with maincode POS295x) are returned only if RETURNCODE=*YES was specified.
| (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. | |
lnr | 64 | POS2956 | Error in the parameter file. The number of the line (lnr) 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
Examples:
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