RTVPRD (Retrieve Product)

Note: To use this command, have the 5722-SM1 (System Manager for iSeries) licensed program installed.

RTVPRD Command syntax diagram

 

Purpose

The Retrieve Product (RTVPRD) command provides the capability to retrieve a product, packaged with the OS/400 product packaging support, from a managed system.

 

Restrictions

  1. This command is shipped with public *EXCLUDE authority.

  2. The Managed System Services licensed program and the OS/400 licensed program cannot be specified.

  3. A product can only be retrieved from a single managed system.

Note: A change request is automatically submitted which can be viewed to determine the status of this command. A message is returned identifying the name of the change request.

 

Required Parameters

PRDID
Specifies the 7-character identifier of the product to be retrieved.

product-ID: Specify the 7-character product ID that is used in the activity.

 

Optional Parameters

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

*ONLY: Only one version, release, and modification level is used for the product option.

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

OPTION
Specifies which of the optional parts of the product given in the PRDID parameter are used.

*BASE: Only the base part of the product is used.

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

LODTYPE
Specifies the product load objects being used.

*ALL: Code and language objects specified on the LODID parameter are used.

*CODE: The program objects associated with this product load are used.

*LNG: Specify that the objects associated with the NLV identified on the LODID parameter are used.

LODID
Specifies the load identifier used.

*ALL: All languages for this product option are saved.

*CODE: The code load is used.

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

CPNAME
Specifies the APPN control point names of the managed systems on which this activity is to be performed.

*NETATR: The network ID of the local system is used. This is useful when the node being specified is in the same network as the local system.

network-identifier: Specify the APPN network identifier of the managed system on which the activity is to be performed.

control-point-name: Specify the APPN control point name of the managed system on which the activity is to be performed.

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

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

*PRV: The object is intended for a system that is at the previous release level compared to the local system.

Note: Modification levels are not supported. To specify the previous release with a modification level other than 0, such as V4R1M4, specify the value for the release rather than the special value *PRV.

release-level: Specify the release level in the VxRxMx format. 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.

Examples for RTVPRD

Example 1: Retrieving the Program and Language Parts 

RTVPRD  PRDID(1ACCOUN)   RLS(V5R2M0)   OPTION(*BASE)
  LODTYPE(*ALL)  LODID(*ALL)   CPNAME((*NETATR SYS1))

This command retrieves the program and language parts for the base option of product 1ACCOUN with release V5R2M0 from iSeries server SYS1.

Example 2: Retrieving an Option 

RTVPRD  PRDID(1CHECKS)  RLS(V5R2M0)  OPTION(10)
  LODTYPE(*ALL)  LODID(*ALL)   CPNAME((*NETATR SYS2))

This command retrieves the option 10 of the 1CHECKS product, release V5R2M0, for both the program and the language parts from the iSeries server SYS2.

Error messages for RTVPRD

*ESCAPE Messages

None