Open System Services Shell and Utilities Reference Manual (G06.28+, H06.05+)

pinstall(1) OSS Shell and Utilities Reference Manual
Standard Error
Diagnostic messages are written to the standard error file. Tape messages are written to the pro-
cess identified as HOMETERM in the Guardian environment.
EXAMPLES
To extract files from the archive tape that is currently mounted on the tape drive $TAPE and
restore them to the same directory from which they were originally copied, enter:
pinstall -r -f /G/tape
NOTES
pinstall uses unlabeled-tape processing. There is no mechanism to check for tape sequence in
the case of multiple-reel archives.
On systems where the Distributed Systems Management/Distributed Con
figuration Manager
(DSM/SCM) product is used to install HP product files from the ZOSSUTL subvolume and main-
tain those files in the OSS file system, do not use pinstall to install HP product files from the
ZOSSUTL subvolume.
On systems where DSM/SCM is not used to install HP product files from the ZOSSUTL subvo-
lume and maintain those files in the OSS file system, do not use pinstall on files with Guardian
file identifiers that begin with ZFB or ZPG. Such files are created and maintained by DSM/SCM.
Using pinstall on such files can duplicate installation effort or overwrite current versions of pro-
duct files with obsolete versions.
DIAGNOSTICS
A diagnostic message is written to the standard error file and a nonzero exit value is returned (but
processing continues) when pinstall cannot create a file or preserve the user ID, group ID, or file
mode bits.
If the extraction of a file from an archive is permanently terminated for any reason, either pinstall
might have extracted only a partially restored file or the file attributes of the extracted files might
not be set correctly.
If appropriate privileges are required to set one of the file access mode bits and if the user restor-
ing the files from the archive does not have the appropriate privileges, the file access mode bits
for which the user does not have privileges are ignored.
EXIT VALUES
The following exit values are returned by pinstall:
0 (zero) All files were processed successfully.
>0 An error occurred.
RELATED INFORMATION
Commands: copyoss(8), cp(1), ed(1), pax(1).
STANDARDS CONFORMANCE
The pinstall command is an extension to the XPG4 Version 2 specification.
7−26 Hewlett-Packard Company 527188-007