Commands Reference, Volume 1

adelppname command

Purpose

Generates the lpp_name file required by the installp command.

adelppname -f Format -v Version -r ReleaseLevel -m Mod -F FixLevel -p Platform -u LppName.lp -o OutputFile -c Compids.table [ -t Type ] [ -l ProductName ] [ -a Path/liblpp.a ] [ -d FilesDirectory] [ -k APARsList] [ -L ]

Description

In order to create the output lpp_name file, the adelppname command copies data from the input lppname file (including data from the input flags), appends three files (option.prereq, option.size and option.supersede), and calculates the space needed by the liblpp.a library and its members to include in the output file. If a liblpp.a file exists in the root subdirectory, the root size information will also be included in the output file.

Note: Since adelppname utilizes some of the files generated by adeinventory, it must be run after the adeinventory command has completed.

Input Files

lppname.lp	The input lpp_name file must be specified by the -u flag. It contains user-supplied information prior to the build process. Sample input lpp_name file follows: bos.rte N B En_US Base Operating System Runtime #comments The fields in this file are: [option_name] [quiesce_char] [content] [language] [product_description] [comments] where: *option_name* Indicates the full name of the option that this file represents *quiesce_char* Indicates whether the subsystem must be stopped before updating this option. Valid values are: Y - Must stop subsystem; do not invoke bosboot. N - Do not need to stop subsystem; do not invoke bosboot. B - Must stop subsystem; must invoke bosboot and reboot. b - Do not need to stop subsystem; must invoke bosboot and reboot. *content* Indicates the contents of this option and is used to determine which SWVPD will be updated. Valid values are: U - /usr code only B - /usr and / (root) code H - /usr/share code only D - microcode *language* Indicates the language used for the default messages for this option description the formal description of this option *product_description* Indicates the formal description of this option comments Indicates optional comment
option.prereq	The option.prereq file is a user-supplied file that specifies requisite options that must be installed prior to or along with the specified option. adelppname looks for this file in the current working directory; or, specify an alternate directory location using the -d flag. The prereq file is appended to the output lpp_name file.
option.supersede	The option.supersede file is a user-supplied file. The meaning of this file is changing with AIX Version 4 of the operating system. Prior to AIX Version 4, the supersede file contained a list of PTF IDs that were superseded by the specified option during an update. The new update strategy for AIX Version 4 utilizes vrmf levels in place of PTF numbers. vrmf indicates version, release, modification level and fix level. Larger vrmf levels are assumed to supersede lower vrmflevels. Therefore requisites are satisfied by definition if the vrmf level of the option is greater than the requisite vrmf. If for any reason this assumption becomes invalid, the supersede file is used in AIX Version 4 to indicate the earliest base level that is compatible with the current level. Any time a fileset has a requisite to an option that contains a supersede entry, the requisite is only satisfied if the vrmf level of the requisite is greater than or equal to the one indicated in the supersede file. The supersede file should only be used if binary compatibility is broken between base levels. adelppname will look for this file in the current working directory; or, specify an alternate directory location using the -d flag. The supersede file is appended to the output lpp_name file.
option.size	This file is generated by the adeinventory command. adelppname looks for this file in the current working directory; or, specify an alternate directory location using the -d flag. The size file is included in the output lpp_name file.
root/option.size	This file is generated by the adeinventory command, if the specified option includes a root part. adelppname looks for this file relative to the current working directory. The root/option.size file is included in the output lpp_name file.
compids.table	The compids.table file must be specified by the -c flag if the file -L flag was specified to include iFOR/LS information in the lpp_name file. This is a user-supplied file that contains a list of components/options and the information required for packaging and distribution of these items. adelppname uses information from this table to include the appropriate keys in its output file. The format of this file is: prologue - contains standard prologue and comments. ** lines - contains information concerning maintenance of this file. %%_ lines - contains vendor identification and numeric_id. component/option lines - contains the information required for packaging and distribution of each component/option. The format of these lines are: package name:component id:feature code:component release level: system release level:change team id(s):CMVC release:vendor_id: iFOR/LS_product_id:iFOR/LS_product_version: For example: bos.adt:575603001:5005:410:410:TX2527:XXX:IBM:1234567:12345678901:

Output Files

lpp_name

The output lpp_name file is located in the path specified by the -o flag.

There are three types of output lpp_name files, specified by format types 1, 3, and 4.

The format of a type 4 lpp_name file (for AIX Version 4) includes a field on the VRM line (the line containing the lpp name). There are additional % separated sections in a type 4 lpp_name file. The empty % separated fields at the end of this example are for the iFOR/LS section and the Install By Keyword section, respectively.

4 R I bos.INed { 
bos.INed 04.01.0000.0000 01 N B En_US INed Editor 
[ 
% 
/usr/lib/INed 424 
/usr/lib/objrepos 24 
/usr/lib/INed/bin 264 
/usr/lib/INed/forms 280 
/usr/lib/INed/helpers 544 
/usr/bin 936 
/usr/lpp/bos.INed/inst_root/var 8 
INSTWORK 128 48 
/var 1032 
/etc/objrepos 8 
% 
INed.obj 4.1.0.0 
% 
% 
% 
 ] 
}

Flags

-a Path/liblpp.a	Specifies the fully qualified (or relative) pathname of the liblpp.a file. The default location is in the current working directory.
-c Compids.table	Specifies the fully qualified (or relative) path of the Compids.table. This flag is required if the -L flag is specified to include iFOR/LS information in the lpp_name file.
-d FilesDirectory	Specifies the directory where the .prereq, .supersede, and size files reside. The default location is the current working directory.
-f Format	Specifies the file format. Valid values are: 1 (for microcode) 4 (for AIX Version 4 of the operating system)
-F FixLevel	Specifies the fix level. Must be no more than 4 digits, for example, 0000
-k APARsList	Specifies the fully qualified (or relative) pathname of a file that contains a list of APAR numbers or other keywords that correspond to the PTF ID for the update. The contents of this file is included in the output lpp_name file. This flag is only valid with update package types.
-l ProductName	Specifies the product name. This flag is required if the file format is 4. The product name is placed in the fourth field of the first line of the output lpp_name file. This must match the ProductName for the package and is typically the same as the package name.
-L	Include iFOR/LS section in the lpp_name file.
-m Mod	Specifies the modification level. Must be no more than 4 digits, for example, 0000
-o OutputFile	Specifies the pathname for the output lpp_name file.
-p Platform	Specifies the platform. Must be 1 uppercase character. Valid values are: R (for POWER-based) I (for Itanium-based).
-r ReleaseLevel	Specifies the release level of the LPP. Must be no more than 2 digits, for example 01
-t Type	Specifies the package type. The default value for package type is I. Valid values and their meanings are: G - Single update, gold I - Installation package M - Maintenance packaging update MC - Cumulative packaging update ME - Enhancement packaging update O - Other S - Single update, normal SF - Single update, install code SR - Single update, required T - tar formatted file
-u LppName.lp	Specifies the input lppname file. This file must contain a concatenation of all .lp files. There are no specific requirements for the name of this file, but it must end in .lp.
-v Version	Specifies the version of the LPP. Must be no more than 2 digits, for example, 04

Error Codes

The adelppname command terminates processing with a non-zero return code if any of the following errors are detected:

The command line does not contain the minimum number of arguments. A usage message is displayed.
An invalid argument is detected for an option. A message describing the expected argument format is displayed.
The lppname.lp file (specified with the -u flag) argument is missing or the file specifies is empty or not found.
The format value was 4 but the -l flag was not provided on the command line.
The -o OutputFile flag was not specifies on the command line.

Warnings do not affect the return code of adelppname and processing continues. adelppname displays a warning message describing any actions taken as the result of the warning.

If the content field (that is, the 3rd field on the first non-comment, non-blank line of the input lpp_name file) is D but the format (specified with the -f flag) is not 1, adelppname displays a warning message and use a type 1 format. D indicates the content is microcode, which utilizes a 3.1 format for the lpp_name file.