Package Product Option (PKGPRDOPT)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Package Product Option (PKGPRDOPT) command packages one or more product loads for a specified product option enabling the loads to be saved using the Save License Program (SAVLICPGM) command.

The following notes provide information on how the command works.

Notes:

  1. To package a product load that has folders, you must be enrolled in the system distribution directory and you must have *ALL authority to the folders.

    If you have authority for this command, you can package any product created using the System Manager program regardless of whether you have authority to the objects for the product.

  2. The only object types that the PKGPRDOPT command package is on is the Save Object list Application Program Interface (API). Other object types are ignored.
Top

Parameters

Keyword Description Choices Notes
PRDID Product ID Character value Required, Positional 1
OPTION Product option 1-99, *BASE Required, Positional 2
ALWAPICHG Allow change by program *SAME, *NO Required, Positional 3
LODID Load ID Character value, *ALL, *CODEDFT Optional
RLS Release level Character value, *ONLY Optional
REPACKAGE Package again *NO, *YES Optional
Top

Product ID (PRDID)

Specifies the product identifier (ID) of the product option being packaged. The ID must be seven characters in length.

Top

Product option (OPTION)

Specifies the product option being packaged.

The possible values are:

*BASE
The base option is packaged.
product-option-number
Specify the option number of the product to be packaged. Valid values range from 1 through 99.
Top

Allow change by program (ALWAPICHG)

Specifies whether to prevent changes to the description of each object processed by this command.

The possible values are:

*SAME
The 'allow change by program' attribute of the objects being packaged is not changed by this command.
*NO
The object description for each object packaged cannot be changed by the QLICOBJD application program interface (API) or the Change Product Object Description (CHGPRDOBJD) command.
Top

Load ID (LODID)

Specifies the load ID of the product loads being packaged.

The possible values are:

*ALL
All product loads for which a product load object exists are packaged.

If only a code load exists, the code load is packaged.

*CODEDFT
The default code load, 5001, is packaged.
product-load-ID
Specify a language load ID or the default code load, 5001, for a code load.
Top

Release level (RLS)

Specifies the version, release, and modification level of the product option.

The possible values are:

*ONLY
The release level is determined by searching the system for a product definition for the given product ID. The release level is taken from the product definition. This value is not valid if more than one product definition exists for the same product ID.
version-release-modification
Specify the version, release, and modification level of the product being packaged.
Top

Package again (REPACKAGE)

Specifies whether to allow the command to package a product option which has already been packaged.

The possible values are:

*NO
Product options which have been packaged are not repackaged.
*YES
Package all specified product options regardless of their current state.
Top

Examples

PKGPRDOPT   PRDID(9XYZ123)  OPTION(*BASE)  ALWAPICHG(*SAME)

This command packages the base option of the product 9XYZ123.

Top

Error messages

*ESCAPE Messages

CPF0CB2
Product identifier &1 not valid.
CPF0CEB
Product loads not packaged.
CPF0CE2
&9 product loads packaged, &10 product loads not packaged.
CPF0CE3
&9 product loads packaged, &10 product loads not packaged. See job log.
CPF0CE7
Product &1 release &2 not packaged.
CPF0CFC
Product definition not found.
CPF0CFD
Code load not found for product &1 release &2 option &3.
CPF0CFF
Multiple releases available.
CPF0C4B
Product availability object &2/&1 recovery required.
CPF0C4C
Cannot allocate object &1 in library &2.
CPF0C4D
Error occurred while processing object &1 in library &2.
CPF8122
&8 damage on library &4.
CPF8191
Product definition &4 in &9 damaged.
CPF8193
Product load object &4 in &9 damaged.
CPF9012
Start of document interchange session not successful for &1.
CPF9032
Document interchange session not started.
CPF9803
Cannot allocate object &2 in library &3.
CPF9830
Cannot assign library &1.
Top