The Package Product for Distribution (PKGPRDDST) command saves a copy of the objects that make up a product into a save file so the product can be distributed electronically. A distribution catalog entry is created for the product, and the packaged product is loaded into the distribution repository.

Restrictions:

1. This command is shipped with public *EXCLUDE authority.
2. You must have the authority necessary to perform the Save Licensed Program (SAVLICPGM) command on the product to be packaged to run this command.
3. This command has the same restrictions as the SAVLICPGM command.

Parameters

Keyword	Description	Choices	Notes
PRDID	Product ID	Character value	Required, Positional 1
RLS	Release level	Character value, *ONLY	Optional
OPTION	Product option	1-99, *BASE	Optional
LODTYPE	Product load type	*ALL, *CODE, *LNG	Optional
LODID	Load ID	Character value, *CODE, *ALL	Optional
TGTRLS	Target release	*CURRENT, *PRV, V5R2M0, V5R3M0, V5R4M0	Optional
SAVF	Save file	Single values: *NONE Other values: Qualified object name	Optional
	Qualifier 1: Save file	Name
	Qualifier 2: Library	Name, *LIBL, *CURLIB
AUTL	Authorization list	Character value, QCQRPSAUTL	Optional
REPLACE	Replace	*NO, *YES	Optional

Top

Product ID (PRDID)

Specifies the 7-character identifier of the product to be saved.

Release level (RLS)

Specifies which version, release, and modification level of the product is saved.

*ONLY

Only one version, release, and modification level is installed for the product option.

release-level

Specify the release level in the format VxRxMy, where Vx is the version number, Rx is the release number, and My is the modification number. Valid values for x range from 0 through 9. Valid values for y range from 0 through 9 and A through Z.

Product option (OPTION)

Specifies which optional parts of the product identified in the Product ID (PRDID) parameter are saved.

*BASE

Only the base part of the product is saved.

product-option-number

Specify the option number for the product load being saved. Valid values range from 1 through 99.

Product load type (LODTYPE)

Specifies the product load objects being saved.

*ALL

Code and language objects specified on the LODID parameter are saved.

*CODE

The objects associated with this product load are saved.

*LNG

The objects associated with the national language version (NLV) identified on the LODID parameter are saved.

Load ID (LODID)

Specifies the load identifier used for the save operation.

*ALL

All languages for this product option are saved.

*CODE

The code load is used.

product-load-ID

Specify the code load to be used. When LODTYPE(*LNG) or LODTYPE(*ALL) is specified, the load ID must be one of the valid IBM national language versions and be specified in the form 29xx.

Target release (TGTRLS)

Specifies the release of the operating system on which you intend to use the object.

*CURRENT

The object is used on the release of the operating system currently running on your system. If V5R4M0 is running on your system, *CURRENT means that you intend to use the object on a system with V5R4M0 installed. The object can also be used on a system with any later release of the operating system installed.

release-level

Specify the release level in the format VxRxMx. The object is used on a system with the specified release or with any later release of the operating system installed.

Valid values depend on the current version, release, and modification level, and they change with each new release.

Save file (SAVF)

Specifies the qualified name of the save file that contains the product packaged for distribution.

*NONE A save file containing the product is not provided to package a product for distribution.

The name of the object can be qualified by one of the following library values:

*LIBL

All libraries in the job's library list are searched until the first match is found.

*CURLIB

The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name

Specify the name of the library to be searched.

save-file-name

Specify the name of the save file containing the product packaged for distribution.

Authorization list (AUTL)

Specifies the name of the authorization list of the distribution repository object. This parameter is valid only when SAVF(*NONE) is specified.

QCQRPSAUTL

The default authorization list is used.

authorization-list-name

Specify the name of an existing authorization list.

Replace (REPLACE)

Specifies whether the existing packaged product is replaced if the packaged product already exists in the distribution repository.

*NO

The existing packaged product is not replaced.

*YES

The existing packaged product is replaced.

Examples

Example 1: Package the Base Option for Distribution

PKGPRDDST   PRDID(5722PT1)  OPTION(*BASE)

This command saves the BASE option of the Performance Tools licensed program for both the code and language parts. It then creates the following distribution catalog entry and stores the saved product into the distribution repository:

I3IBM1 AS400 5722PT1 V5R2M0 BASE ALL ALL REF 001 V5R2M0

Example 2: Package the Program Objects

PKGPRDDST   PRDID(ACCOUNT)  RLS(V5R2M0)  LODTYPE(*CODE)
            LODID(*CODE)

This command packages the V5R2M0 ACCOUNT product for distribution and saves only the program objects for the product. The command also creates the following distribution catalog entry and stores the saved product into the distribution repository:

I3IBM1 AS400 ACCOUNT V5R2M0 BASE CODE CODE REF 001 V5R2M0

Example 3: Package the Language Objects

PKGPRDDST   PRDID(ACCOUNT)  LODTYPE(*LNG)  LODID(2924)

This command packages the English version of the ACCOUNT product for distribution and creates the following distribution catalog entry and stores the saved product into the distribution repository:

I3IBM1 AS400 ACCOUNT V5R2M0 BASE LNG 2924 REF 001 V5R2M0

Example 4: Package the Product for Distribution

PKGPRDDST   PRDID(BILLS01)  SAVF(*LIBL/BILLSAVF)

This command packages the V5R2M0 BILLS01 product for distribution for both the code and language parts. The product is not saved because the save file containing the product was specified. This command also creates the following distribution catalog entry and stores the saved product into the distribution repository:

I3IBM1 AS400 ACCOUNT V5R2M0 BASE ALL ALL REF 001 V5R2M0

Error messages

*ESCAPE Messages

CPF3D94

No product found in save file.

CPF37xx

Save/restore error messages.

CPF3805

Objects from save file &1 in &2 not restored.

CPF3812

Save file &1 in &2 in use.

CPF81xx

Damaged object error messages.

CPF98xx

Common error messages.

MSS0123

Internal processing error occurred.

MSS0144

Distribution catalog entry not retrieved.

MSS020C

Product and save file information do not match.

MSS020D

Required object not found or damaged.

MSS020F

Required object locked.

MSS0210

Not authorized to perform operation.

MSS0211

Product already packaged for distribution.

MSS0212

Product could not be packaged for distribution.

MSS022A

Object &2/&1 not found.

MSS022C

Cannot specify QTEMP for save file library.

MSS0415

Managed system attributes not found or damaged.