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:

  1. The delete function of this command is only supported when the service requester has Managed System Services licensed program installed.
  2. 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(VxRxMx)
Specify the release level of the specified product. The format is VxRxMx.
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 V5R2M0))

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 V5R2M0))  DESTSRVRQS(*ALL)

This command shows how to delete a PTF from all service requesters supported by this service provider.

Top

Error messages

None

Top