Package Product for DST (PKGPRDDST)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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:
- This command is shipped with public *EXCLUDE authority.
- You must have the authority necessary to perform the Save Licensed Program (SAVLICPGM) command on the product to be packaged to run this command.
- This command has the same restrictions as the SAVLICPGM command.
| Top |
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, V5R4M0, V6R1M0, V7R1M0 | 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 |
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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 V7R1M0 is running on your system, *CURRENT means that you intend to use the object on a system with V7R1M0 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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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
| Top |
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.
| Top |