RTVPTF (Retrieve Program Temporary Fix)

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

RTVPTF Command syntax diagram

 

Purpose

The Retrieve Program Temporary Fix (RTVPTF) command allows a service provider to retrieve remote PTFs and cover letters from a service requester's system.

Note:

A message is automatically returned identifying the name of the change request. Use the Work with Submitted Change Request (WRKSBMCRQ) command to monitor the status.

Restriction: The retrieve function of this command is only supported when the service requester has the Managed System Services licensed program installed.

 

Required Parameters

PTFID

Specifies the PTF that is to be retrieved. A maximum of 50 PTF identifiers can be specified.

Element 1: PTF identifier

ptf-identifier: Specify a 7-character PTF identifier.

Element 2: Product identifier

*ONLY: The PTF identifier is associated with only one product.

product-id: Specify the product of the PTF. The product must be specified when PTF identifiers are not unique across products.

Element 3: Release level of product

release(VxRxMx): Specify the release level of the product. The release level must be specified when PTF identifiers are not unique across products. The format is VxRxMx.

DESTSRVRQS

Specifies the service requester where the PTF should be retrieved. Only one service requester can be specified or selected.

Element 1: Network identifier

*SELECT: Shows a list of service requesters. From the list, the user can select a service requester from where the PTF is to be retrieved. *SELECT is not valid when the command is used in a batch environment.

*NETATR: The remote network identifier of the service requester is the same as the network identifier of this system.

remote-network-identifier: Specify the remote network identifier of the service requester.

Element 2: Control Point

remote-control-point: Specify the remote control point name of the service requester.

 

Optional Parameters

PTFPART

Specifies if PTFs or cover letters should be retrieved.

*ALL: Retrieve the PTF and its cover letter in the language specified.

*PTF: Retrieve only the PTF.

*CVRLTR: Retrieve only the cover letter in the language specified.

CVRLTRLNG

Specifies the cover letter language that should be retrieved.

*SRVPVDA: The value set in the Change Service Provider Attributes (CHGSRVPVDA) command is used.

cover-letter-language-ID: Specify the cover letter language code. Prompting (F4) on this field provides a list of all possible cover letter language codes.

Note:

If the specified cover letter language is not found on the service requester's system, a default cover letter language of 2924, which is uppercase and lowercase English, or 2950, which is uppercase English, is retrieved if available.

Examples for RTVPTF

Example 1: Retrieving a PTF and Cover Letter

RTVPTF PTFID(SF00001)  DESTSRVRQS(*NETATR CHICAGO1)

This example shows how to retrieve a PTF and a cover letter from a service requester. The cover letter language to be retrieved is defined as a service provider attribute.

Example 2: Retrieving a Cover Letter

RTVPTF PTFID(123456)   DESTSRVRQS(*SELECT)
  PTFPART(*CVRLTR)  CVRLTRLNG(2962)

This example shows how to retrieve a cover letter from a selected service requester in the 2962 language.

Error messages for RTVPTF

*ESCAPE Messages

None