instfix Command

Edit online

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 ] [ -R ]

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.

Notes:
  • 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 the /usr/include/errno.h file.
  • Listing interim fix information is possible only when using the -f, -i, -k, -q, -r, -t, and -v flags. You cannot install the interim fixes using the instfix command.

Flags

Item Description
-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. To display filesets that are not installed, the -v flag must also be used. Status values are:
-
Down level
=
Correct level
+
Superseded
!
Not installed
-d Device Specifies the input device. Not valid with the -i and -a flags.
-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 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 might be used to list the fixes for that particular platform.
R
Specifies POWER® processor-based platform fixes only.
N
Specifies neutral fixes, that is, fixes that are not restricted to the POWER processor-based platform.
A
Specifies all fixes.
-p Displays file sets 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.
-R Specifies the User Specified Installation Location (USIL).
-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 Limits the search operation to a given type when used with the -i flag. Valid types are:
f
fix
p
preventive maintenance
i
interim fix
-v Specifies verbose mode when used with the -i flag. Displays information about each fileset associated with a fix or keyword. Use this flag with the -i flag to display filesets that are not installed. An uninstalled fileset is indicated by an ! (exclamation point).

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

  1. To install all filesets associated with fix IX38794 from the tape mounted on /dev/rmt0.1, type:
    instfix  -k IX38794  -d /dev/rmt0.1
  2. 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.
  3. To list all keyword entries on the tape containing the string SCSI, type:
    instfix  -s SCSI  -d /dev/rmt0.1
  4. To inform the user on whether fixes IX38794 and IX48523 are installed, type:
    instfix  -i  -k "IX38794 IX48523"
  5. 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.
  6. To list all of the fixes that are not restricted to the POWER processor-based platform, type:
    instfix  -T  -MN  -d /dev/cd0

Files

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