Delete PTF (DLTPTF) command PTF selection criteria

News

Abstract

The Delete PTF (DLTPTF) command has been updated to allow additional special values on the PTF parameter. In addition, DLTPTF will now delete unregistered PTF save files and cover letters.

Content

You are in: IBM i Technology Updates > General IBM i Operating System > Delete PTF (DLTPTF) command PTF selection criteria

When a PTF save file exists in library QGPL, and PTF Management (DSPPTF) indicates the PTF does not have a save file, the PTF save file is unregistered. When a PTF cover letter exists in file QGPL/QAPZCOVER, and PTF Management (DSPPTF) indicates the PTF does not have a cover letter, the PTF cover letter is unregistered. The Delete PTF (DLTPTF) command has been updated to delete unregistered save files and cover letters using format 'Qptfid' for the PTF save file name and cover letter member name. For unregistered cover letters, only the English (2924) NLV will be deleted.

When a PTF download transmission fails, PTFs can be left in one of the following states:
- Cover letter only status with unregistered save files.
- On order only status with unregistered cover letters and/or unregistered save files

Instead of performing manual cleanup, the DLTPTF command can now be used to delete the partially downloaded PTFs using PTF(*COVERONLY) and PTF(*ONORDONLY) before reordering the PTFs.

IBM has long recommended cleaning up PTF save files and cover letters after they have been permanently applied. The exception is if the PTF save files are required for distribution or when using the Save System Information (SAVSYSINF) command. The DLTPTF command now allows the new *PRMAPY special value on the PTF parameter to delete PTFs that are permanently applied, or have a status of Superseded where the "Superseded-by" PTF is permanently applied.

Software Pre-requisite for IBM i:
- 7.1 PTF SI54641
- 7.2 PTF SI54590

Help text for the new special values on the PTF parameter is not available in 7.1 or 7.2, but can be viewed below:

Delete Program Temporary Fix (DLTPTF)

Where allowed to run: All environments (ALL) Threadsafe:* No

The Delete Program Temporary Fix (DLTPTF) command is used to delete program temporary fix (PTF) save files, their associated cover letters, and the records of PTFs that have been ordered.

Parameters

Keyword	Description	Choices	Notes
PTF	PTF	Values (up to 50 repetitions): Character value, ALL, PRMAPY, SAVFONLY, ONORDONLY, *COVERONLY	Required, Positional 1
LICPGM	Product	Character value, *ALL	Optional
RLS	Release	Character value, *ALL	Optional
DLTDUPPTF	Delete duplicate PTF numbers	YES, NO	Optional

PTF (PTF)

Specifies the PTF identification number of the PTF to be deleted.

This is a required parameter.

*ALL: All PTFs for the specified product are deleted.
*PRMAPY: All PTFs for the specified product that are permanently applied are deleted. This includes PTFs with a status of Superseded where the "Superseded-by" PTF is permanently applied.
*SAVFONLY: All PTFs for the specified product with a status of Save file only are deleted.
*ONORDONLY: All PTFs for the specified product with a status of On order only are deleted.
*COVERONLY: All PTFs for the specified product with a status of Cover letter only are deleted.
character-value: Specify the identification number of the PTF to be deleted. A maximum of 50 PTF numbers can be specified.

Product (LICPGM)

Specifies the 7-character identifier of the product for which the PTFs are to be deleted.

*ALL: The product id is ignored when searching for the specified PTF.
character-value: Specify the 7-character product identifier.

Release (RLS)

Specifies the release level of the PTFs being deleted.

*ALL

The PTF is deleted in all releases of the product.

character-value

A specific release cannot be specified when LICPGM(*ALL) is specified. Specify the 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.

Delete duplicate PTF numbers (DLTDUPPTF)

Specifies whether duplicate PTF numbers are deleted.

*NO: Duplicate PTF numbers are not deleted.
*YES: Duplicate PTF numbers are deleted.

Examples

DLTPTF PTF(SI12345)

This command deletes the save file of the PTF named SF12345 from the QGPL library. Any members in the cover letter file for the PTF named SF12345 are also deleted.

Error messages

*ESCAPE Messages

CPF35AE: Duplicate PTF &1 found.
CPF35C5: PTF &1-&2 &4 not deleted.
CPF35E2: Information for PTF &1-&2 &4 not found.
CPF35F1: Cover letter file &1 in &2 not found.
CPF35F2: Cover letter for PTF &2-&1 &3 not found.
CPF358A: Release not valid.
CPF3586: List of PTFs not correct.
CPF6602: PTF &1-&2 &4 not found.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Component":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Tips