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

Commands Reference, Volume 2

getvrmf Command

Purpose

Generates the internalvrmfTable and ptfreqsList file.

Syntax

getvrmf

Description

These files contain data about the current set of PTFs being packaged and are used by the ptfpkg command during the process of generating an update. This command is invoked by the ptfpkg command.

The getvrmf command reads the $TOP/UPDATE/lpplist.$BLDCYCLE file. For each LPP listed, it reads the $TOP/UPDATE/$LPP/ptf_pkg.$BLDCYCLE file. The getvrmf command calculates the new VRMF level for each PTF listed in the ptf_pkg files and generates two data files. The $TOP/HISTORY/internalvrmfTable.$BLDCYCLE file contains the PTF id, fileset name, new VRMF level, and a list of APARs fixed by this PTF. The $TOP/HISTORY/ptfreqsFile.$BLDCYCLE file contains a list of each PTF and its requisites.

These table files are used throughout the ptfpkg command processing. The internal VRMF table is used by the gen_infofile command to generate the info_file for ccss images and by the updatefixdata command to update the fixdataDB for each APAR.

The $TOP/HISTORY/ptfreqsFile.$BLDCYCLE file is used to identify the requisites associated with a PTF in case it could not be packaged successfully. If a PTF cannot be created, then its requisite PTFs may need to be repackaged.

Environment Variables

BLDCYCLE Specifies the current build cycle. The build cycle identifier identifies the build in which the PTF was created.
TOP Specifies that the $TOP environment variable is set to the base of the update tree. The PTF, HISTORY, and UPDATE directories exist relative to $STOP.

Example

To call getvrmf to generate the internalvrmfFile and ptfreqsList file for the build cycle specified by $BLDCYCLE, type:

getvrmf

Input Files

lpplist.$BLDCYCLE The $TOP/UPDATE/lpplist.$BLDCYCLE file identifies the LPPs that are updated for the build cycle. The format of this file is one LPP name per line.
ptf_pkg.$BLDCYCLE Each LPP from the lpplist file has a ptf_pkg.$BLDCYCLE file associated with it. The ptf_pkg file contains the packaging information for each fileset PTF for the LPP. The format of the ptf_pkg file is:

ptfid | apars | fileName | fileset | ifreqs | coreqs | prereqs |

The fileset field may contain an optional VRMF level if the default VRMF calculations are being overridden. If that is the case, the fileset field has the format:

fileset:v.r.m.f

The default VRMF values should not be overridden. This mechanism is provided so that it is possible to generate a cumulative PTF with a non-zero fix level if desired.

Output Files

$TOP/HISTORY/internalvrmfTable.$BLDCYCLE This file contains the PTF, fileset, VRMF, and APAR information for each PTF currently being packaged by the ptfpkg command. The format of this file is:

ptfid fileset v.r.m.f list of APARs

$TOP/HISTORY/ptfreqsFile.$BLDCYCLE This file contains sets of PTFs that are requisites of each other. The file has an entry for each PTF currently being packaged by the ptfpkg command. The format of this file is:

ptfid list of requisite PTFs

Related Information

The gen_infofile command, ptfpkg command, updatefixdata command.

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