Display Program Temporary Fix (DSPPTF)

The Display Program Temporary Fix (DSPPTF) command shows the program temporary fixes (PTFs) for a specified product.

Restriction: This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.

Parameters

Keyword	Description	Choices	Notes
LICPGM	Product	Character value, *ALL	Optional, Positional 1
SELECT	PTF numbers to select	Character value, ALL, PTFSAVF, ONORDER, ACTRQD	Optional, Positional 2
RLS	Release	Character value, *ALL	Optional
COVERONLY	Cover letter only	NO, YES	Optional
OUTPUT	Output	, PRINT, *OUTFILE	Optional
OUTFILE	File to receive output	Qualified object name	Optional
	Qualifier 1: File to receive output	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
OUTMBR	Output member options	Element list	Optional
	Element 1: Member to receive output	Name, *FIRST
	Element 2: Replace or add records	REPLACE, ADD

Top

Product (LICPGM)

Specifies the product for the PTFs that are shown. When LICPGM(*ALL) is specified, PTFs for all installed and supported products are shown.

The possible values are:

*ALL: The PTFs of all installed and supported products are shown.
licensed-program: Specify the product for which PTFs are shown.

PTF numbers to select (SELECT)

Specifies which PTF is shown for the specified product. *ALL cannot be specified for the Product (LICPGM) parameter if a PTF number is specified on the PTF numbers to select (SELECT) parameter.

When LICPGM(*ALL) and SELECT(*ALL) are specified, all PTFs for all installed and supported products are shown.

When LICPGM(licensed-program) and SELECT(*ALL) are specified, PTFs for all releases of the specified products are shown. The possible values are:

*ALL: The status of all PTFs for the specified product is shown.
*PTFSAVF: The status of all PTFs for the specified product that have a save file in library QGPL is shown. This special value is useful for determining which PTF save files are no longer needed. It is also useful for the service provider for determining which PTFs can be distributed.
*ONORDER: The status of all PTFs for the specified product that are on order is shown.
*ACTRQD: The PTFs that have required actions pending are shown. This special value is useful to the user for determining which PTFs require an action to become active.
Note: If *ACTRQD is specified, the exit programs that run take a long time, resulting in a delay in the appearance of the first screen.
PTF-number: Specify the PTF identification number of the PTF that is shown.

Release (RLS)

Specifies the release level of the PTFs being displayed.

The possible values are:

*ALL

The PTFs for all releases of the supported and installed products are displayed.

release-level

Specify the release level in VxRyMz format 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.

If the release-level specified is the release-level of the installed base option of the product, PTFs for all installed options of the product are displayed regardless of the release-level of the option. All PTFs for options that are supported at this release-level are also displayed.

If the release-level specified is not the release-level of the installed base option of the product, only PTFs for the product options that are supported or installed at that release-level are displayed.

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

The possible values are:

*: The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
*PRINT: The output is printed with the job's spooled output. The name of the spooled output file is QSYSPRT.

*OUTFILE: The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.

File to receive output (OUTFILE)

Specifies the physical database file where the PTF records are directed. If the output file already exists, the system attempts to use it. The system creates a physical database file (with the name specified in the OUTFILE parameter) in the designated library. A member is created for the file with the name specified in the Output member options (OUTMBR) parameter. If a new file is created, system file QADSPPTF in system library QSYS with a format name of QSCPTF is used as a model.

The possible library values are:

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library for the job is used to locate the file. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the library where the file is located.

The possible values are:

file-name: Specify the name of the file that receives the PTFs.

Output member options (OUTMBR)

Specifies the name of the database file member where the output of the command is directed. A second value specifies whether the new data replaces the existing data or is added to the end of the data already in the file member.

The possible member name values are:

*FIRST: The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the File to receive output (OUTFILE) parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.

member-name: Specify the name of the member in the file that receives the output. If the specified member name does not exist, the system creates it.

The possible placement values are:

*REPLACE: The system clears the existing member and adds the new records.

*ADD: The system adds the new records to the end of the existing records.

Examples

Example 1: Printing Status of PTFs

DSPPTF   LICPGM(5722SS1)  OUTPUT(*PRINT)

This command produces a printout containing the status of PTFs for the product 5722SS1.

Example 2: Printing Information

DSPPTF   LICPGM(5722SS1)  SELECT(SI00034)  OUTPUT(*PRINT)

This command produces a printout containing detailed information about PTF SI00034 for the product 5722SS1.

Error messages

*ESCAPE Messages

CPF0C4B: Product availability object &2/&1 recovery required.
CPF0C4C: Cannot allocate object &1 in library &2.
CPF0C4D: Error occurred while processing object &1 in library &2.
CPF24B4: Severe error while addressing parameter list.
CPF35BE: Product &1 &3 not supported or installed.
CPF35F5: Cover letter not found for PTF &1-&2 &3.
CPF358A: Release not valid.
CPF3925: Cannot open file &1.
CPF3950: Error message &2 received for file &1. Request ended.
CPF6601: No PTF activity exists for product &1.
CPF6602: PTF &1-&2 &3 not found.
CPF6603: No PTFs found.
CPF6613: No PTFs met selection criteria.
CPF8191: Product definition &4 in &9 damaged.
CPF8193: Product load object &4 in &9 damaged.
CPF9860: Error occurred during output file processing.