Retrieve Program Temporary Fix (RTVPTF)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
| Top |
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
- Specify the 6-character release level in one of the following formats:
- VxRyMz, where Vx is the version number, Ry is the release number, and Mz is the modification level. The variables x and y can be a number from 0 through 9, and the variable z can be a number from 0 through 9 or a letter from A through Z.
- vvrrmm, where version vv and release rr must be a number from 00 through 35, and modification mm must be a number from 00 through 09 or a letter from 0A through 0Z. The leading zeros are required. This format must be used if the version or release of the product is greater than 9.
The release level must be specified when PTF identifiers are not unique across products.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
Error messages
None
| Top |