Delete Remote PTF (DLTRMTPTF)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Delete Remote Program Temporary Fix (DLTRMTPTF) command allows a service provider to remotely delete PTFs 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.
Restrictions:
- The delete function of this command is only supported when the service requester has Managed System Services licensed program installed.
- If NODL value is specified, the node list must contain only entries that have an address type equal to *SNA.
| 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, *ALL | ||
| Element 2: Product | Character value, *ONLY | ||
| Element 3: Release level | Character value | ||
| DESTSRVRQS | Destination service requester | Single values: *ALL, *SELECT, *NONE Other values (up to 50 repetitions): Element list |
Optional |
| Element 1: Network identifier | Communications name, *NETATR | ||
| Element 2: Control point | Communications name | ||
| NODL | Node list name | Qualified object name | Optional |
| Qualifier 1: Node list name | Name, *NONE | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB |
| Top |
PTF description (PTFID)
Specifies the PTF that is to be deleted. A maximum of 50 PTF identifiers can be specified.
The possible PTF identifier values are:
- ptf-identifier
- Specify a 7-character PTF identifier.
- *ALL
- Deletes all PTFs for the specified product.
The possible product identifier values are:
- *ONLY
- Specifies that 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 or the PTF identifier is *ALL.
The possible release level of product value is:
- 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.
| Top |
Destination service requester (DESTSRVRQS)
Specifies the service requester where this PTF function is to be performed. A single service requester or a list of service requesters can be specified.
The possible network identifier values are:
- *SELECT
- Shows a list of service requesters. From the list, you can select one or more service requesters. *SELECT is not valid when the command is used in a batch environment.
- *ALL
- Specifies that this PTF function should occur on all of the service requesters that are defined for this service provider.
- *NONE
- The service requesters are identified in a node list object.
- *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.
The possible control point values are:
This element is not valid when the network identifier is *ALL, *SELECT, or *NONE.
- remote-control-point
- Specify the remote control point name of the service requester.
| Top |
Node list name (NODL)
Specifies the node list object name that contains a list of service requesters where this PTF function is to be performed.
The possible values are:
- *NONE
- The service requesters are identified in the DESTSRVRQS parameter.
The possible values are:
- *LIBL
- Searches all of the libraries in the user and in the system portions of the job's library list for the node list object.
- *CURLIB
- Searches for the node list object in the library for the current job.
- library-name
- Specify the name of the library to be searched.
The possible node list name value is:
- node-list-name
- Specify the node list name which contains the list of service requesters where this PTF function is to be performed.
| Top |
Examples
Example 1: Deleting a PTF
DLTRMTPTF PTFID((1234567 *ONLY V5R4M0))
This command shows how to delete a PTF on one or more service requesters. A list will be shown from which you select one or more service requesters.
Example 2: Deleting a PTF on All Service Requesters
DLTRMTPTF PTFID((1234567 *ONLY V5R4M0)) DESTSRVRQS(*ALL)
This command shows how to delete a PTF from all service requesters supported by this service provider.
| Top |
Error messages
None
| Top |