Commands Reference, Volume 3

instfix Command

Purpose

Installs filesets associated with keywords or fixes.

Syntax

instfix [ -T [ -M Platform ] ] [ -s String ] [ -S ] [ -k Keyword | -f File ] [ -p ] [ -d Device ] [ -i [ -c ] [ -q ] [ -t Type ] [ -v ] [ -F ] ] [ -a ]

Description

The instfix command allows you to install a fix or set of fixes without knowing any information other than the Authorized Program Analysis Report (APAR) number or other unique keywords that identify the fix.

Any fix can have a single fileset or multiple filesets that comprise that fix. Fix information is organized in the Table of Contents (TOC) on the installation media. After a fix is installed, fix information is kept on the system in a fix database.

The instfix command can also be used to determine if a fix is installed on your system.

Note: Return codes for the instfix command are documented in the /usr/include/inuerr.h file, which is shipped with the bos.adt.include fileset. There is also a general failure code of 1 and a single reference to EACCES (13) from /usr/include/errno.h.

Flags

-a	Displays the symptom text associated with a fix. Can be combined with the -i, -k, or -f flag.
-c	Displays colon-separated output for use with -i flag. Output includes keyword name, fileset name, required level, installed level, status, and abstract. Status values are: - Down level = Correct level + Superseded ! Not installed
-d Device	Specifies the input device. Required for all flags except -i and -a.
-F	Returns failure unless all filesets associated with the fix are installed.
-f File	Specifies the input file containing keywords or fixes. Use - (dash) for standard input. The -T flag produces a suitable input file format for -f.
-i	Displays whether fixes or keywords are installed. Use this flag with the either the -k or the -f flag. Installation is not attempted when the -i flag is used. If you do not specify the -k or the -f flag, all known fixes are displayed.
-k Keyword	Specifies an APAR number or keyword to be installed. Multiple keywords can be entered. A list of keywords entered with the -k flag must be contained in quotation marks and separated with spaces.
-M Platform	Specifies that any of the Platform values may be used to list the fixes for that particular platform. R Specifies POWER-based platform fixes only. N Specifies neutral fixes, that is, fixes that are not restricted to the POWER-based platform. A Specifies all fixes.
-p	Displays filesets associated with keywords. This flag is used with either the -k or the -f flag. Installation is not attempted when the -p flag is used.
-q	Specifies quiet mode. Use this flag with the -i flag. If you use the -c flag, no heading is displayed, otherwise there is no output.
-s String	Searches for and displays fixes on media containing a specified string.
-S	Suppresses multiple volume processing when the installation device is a CD-ROM. Installation from a CD_ROM is always treated as a single volume, even if the CD-ROM contains information for a multiple volume CD set. This same suppression of multiple volume processing is performed if the INU_SINGLE_CD environment is set.
-T	Displays the entire list of fixes present on the media.
-tType	Used with the -i flag to limit searches to a given type. Valid types are: f fix p preventive maintenance
-v	Used with the -i flag to specify verbose mode. Displays information about each fileset associated with a fix or keyword.

Security

Privilege Control: You must be the root user to install using the instfix command, but any user can run the instfix command to query the fix database.

Examples

To install all filesets associated with fix IX38794 from the tape mounted on /dev/rmt0.1, type:
instfix -k IX38794 -d /dev/rmt0.1
To install all fixes on the media in the tape drive, type:
instfix -T -d /dev/rmt0.1 | instfix -d /dev/rmt0.1 -f-
The first part of this command lists the fixes on the media, and the second part of this command uses the list as input.
To list all keyword entries on the tape containing the string SCSI, type:
instfix -s SCSI -d /dev/rmt0.1
To inform the user on whether fixes IX38794 and IX48523 are installed, type:
instfix -i -k "IX38794 IX48523"
To create a list of filesets associated with fix IX12345 for bffs in the /bffs directory, type:
instfix -p -k IX12345 -d /bffs | installp -acgX -f- -d /bffs
This sequence passes the list of fixes to the installp command to be applied and committed. The installp command extends filesystems as needed with the flags shown. This example shows that you can select other installp flags. The instfix command calls installp if the -p flag is not used.
To list all of the fixes that are not restricted to the POWER-based platform, type:
instfix -T -MN -d /dev/cd0

Files

/usr/sbin/instfix	Contains the instfix command.
/usr/lib/objrepos/fix	Specifies the path to the Object Data Manager database.

Related Information

The installp command.