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 change request is automatically submitted that can be viewed to determine the status of this command. You can 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.

Parameters

Keyword	Description	Choices	Notes
PTFID	PTF description	Values (up to 50 repetitions): Element list	Required, Positional 1
	Element 1: PTF identifier	Character value
	Element 2: Product	Character value, *ONLY
	Element 3: Release level	Character value
DESTSRVRQS	From service requester	Single values: *SELECT Other values: Element list	Optional
	Element 1: Network identifier	Communications name, *NETATR
	Element 2: Control point	Communications name
PTFPART	PTF parts	*ALL, *PTF, *CVRLTR	Optional
CVRLTRLNG	Cover letter language	Values (up to 40 repetitions): Character value, *SRVPVDA	Optional

Top

PTF description (PTFID)

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

The possible PTF identifier values are:

ptf-identifier

Specify a 7-character PTF identifier.

The possible product identifier values are:

*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.

The possible release level of product values are:

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.

From service requester (DESTSRVRQS)

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

The possible network identifier values are:

*SELECT

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

*NETATR

The remove 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.

The possible control point value is:

remote-control-point

Specify the remote control point name of the service requester.

PTF parts (PTFPART)

Specifies if PTFs or cover letters should be retrieved.

The possible values are:

*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.

Cover letter language (CVRLTRLNG)

Specifies the cover letter language that should be retrieved.

The possible values are:

*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 upper and lower case English, or 2950 which is upper case English, is retrieved if available.

Examples

Example 1: Retrieving a PTF and Cover Letter

RTVPTF   PTFID(SF00001)  DESTSRVRQS(*NETATR CHICAGO1)

This command retrieves 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 command retrieves a cover letter from a selected service requester in the 2962 language.

Error messages

None