Troubleshooting
Problem
At R710 and higher, 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.
Diagnosing The Problem
Software Pre-requisite for IBM i:
o 7.1 PTF SI54641
o 7.2 PTF SI54590
Resolving The Problem
At R710 and higher, 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.
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:
o Cover letter only status with unregistered save files.
o 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 PTF save files, cover letters and orders for PTFs that are permanently applied, or have a status of Superseded where the "Superseded-by" PTF is permanently applied.
Help text for the new special values on the PTF parameter is not available in 7.1 or 7.2; however, it can be viewed below:
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 PTF save files, cover letters and orders for the specified product are deleted.
*PRMAPY
All PTF save files, cover letters and orders of PTFs for the specified product that are permanently applied are deleted. This includes PTF save files, cover letters and orders for PTFs with a status of Superseded where the "Superseded-by" PTF is permanently applied.
*SAVFONLY
All PTF save files, cover letters and orders for the specified product with a status of Save file only are deleted.
*ONORDONLY
All PTF save files, cover letters and orders for the specified product with a status of On order only are deleted.
*COVERONLY
All PTF save files, cover letters and orders for the specified product with a status of Cover letter only are deleted.
character-value
Specify the identification number of the PTF save files, cover letters and orders 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 PTF save files, cover letters and orders 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 save files, cover letters and orders 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:
o 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.
o 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.
DLTPTF PTF(*PRMAPY)
This command deletes the save files and cover letters of PTFs that are permanently applied, or have a status of Superseded where the "Superseded-by" PTF is permanently applied.
Related Information
Was this topic helpful?
Document Information
Modified date:
18 December 2019
UID
nas8N1020388