[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 2


gen_infofile Command

Purpose

Generates an infofile for a PTF.

Syntax

gen_infofile -i InfoFile -b BffFile -r TarFile -t Compids -p Ptf -o PtfOptions -v InternalVrmfTable -l LabelTable [ -h ]

Description

The infofile is required for generating a ccss image for distribution. The gen_infofile command for AIX Version 4 is invoked by the ptfpkg command to generate a ccss image. It is not intended to be run standalone. The gen_infofile command generates an infofile for a backup or tar update image. The infofile contains the APAR symptom text, component ID, requisite information, and supersede information.

In AIX Version 4, lpp_name files contain the fileset/VRMF (version, release, mod, fix) level information instead of PTF IDs. However, the requisite sections of the infofile need to contain PTF IDs. The PTF IDs are obtained from the ptfoptions file (-o flag) and internalvrmfTable (-v flag) file. The ptfoptions file contains the fileset and VRMF level for each PTF built in a previous build cycle. The internalvrmfTable contains the fileset/VRMF/APAR information for all PTFs that are being built in the current build cycle.

The label table file contains a list of package types and associated labeling text. The gen_infofile command gets the package type from the lpp_name file and searches the label table for a match. If a match is not found, the default label text is used. The default label text is identified by the character X in the type field of the label table entry.

Flags


-b BffFile Specifies the location of the backup image PTF.
-h Specifies help or usage information.
*-i InfoFile Specifies the location of the output info_file.
*-l LabelTable Specifies the location of the label_text.table file.
*-o PtfOptions Specifies the location of the ptfoptions file. This file is generated by the ptfpkg command but may be hand generated if desired.
*-p Ptf Specifies the PTF ID.
-r TarFile Specifies the location of the tar image PTF.
*-t Compids Specifies the location of the compids.table file.
-v InternalVrmfTable Specifies the location of the internal VRMF table. This file is internally generated during execution of the ptfpkg command. If the gen_infofile is being run standalone, this file is not required and the information for the current build cycle may be included with the ptfoptions file.

Notes:
  1. The -b and -t flags are mutually exclusive. Either the -b or -t flag is required.
  2. Flags indicated with an asterisk (*) are required.

Example

To create an infofile for the backup image P231004.bff, type the following all on one line:

gen_infofile -p P231004 -b P231004.bff \ -l $ODE_TOOLS/usr/lib/label_text.table \ 
-o $TOP/HISTORY/ptfoptions -i P231004.info \ -t $ODE_TOOLS/usr/lib/compids.table

Input Files


bff image The bff image must be generated using the Itanium-based backup command or the adepackage command. The lpp_name file must exist as ./lpp_name in the bff image. The gen_infofile command extracts the lpp.doc, productid, option.fixdata, and lpp_name files from the backup or tar image.
internalvrmfTable The internalvrmfTable file is created by the ptfpkg command and exists only during execution of the ptfpkg command. If the gen_infofile command is being used standalone, then this file should be hand generated. The internalvrmfTable file provides the PTF/fileset/VRMF/APAR mapping for each PTF being built during the current build cycle. Its format is:

ptfid fileset v.r.m.f space separated list of APARs
label table The label table provides distribution label text based on the package type for the PTF. A default label is provided. The label is included on distributed media. The format of the label table is:

Package Type label text

Example:

##############################################
##################### 
# label_text.table  
##############################################
##################### 
# 
I - Software Installation Package
S - Selective Fix Package
M - Selective Enhancement Package
P - Preventive Maintenance Package
G - Initial Update Package
X - For use on AIX 4.1 only
ptfoptions The ptfoptions file is typically generated by the ptfpkg command when a PTF is successfully created. This file maps the PTF, fileset, and VRMF information. The format of this file is:

ptfid fileset v.r.m.f

Example:

U431004 bos.sysmgt.sysbr 4.1.0.1
tar image The tar image must be generated using the tar command or the adepackage command with the -t flag. The lpp_name file must exist as ./lpp_name in the tar image. The gen_infofile command extracts the lpp.doc, productid, option.fixdata, and lpp_name files from the backup or tar image.

Output File


infofile The output infofile for the PTF contains APAR text, label information, and requisite information. The infofile is used as input to the ccss_pack command to create the ccss format file.

Related Information

The adepackage command, backup command, ccss_pack command, ptfpkg command, tar command.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]