The Display Program Temporary Fix Cover Letter (DSPPTFCVR) command shows the program temporary fix (PTF) cover letters 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	Values (up to 300 repetitions): Character value, *NOTAPY, *ALL	Optional, Positional 2
RLS	Release	Character value, *ALL	Optional
CVRATR	Attributes	Single values: *ALL Other values (up to 7 repetitions): *SPCINST, *PREIMM, *PREDLY, *PREOPR, *POSTOPR, *UNKNOWN	Optional
CVRLTRLNG	Cover letter language	Character value, *DFT, *ALL	Optional
OUTPUT	Output	*, *PRINT	Optional

Top

Product (LICPGM)

Specifies the product for which cover letters are displayed.

The possible values are:

*ALL

The cover letters for all installed or supported products are displayed.

licensed-program

Specify the product for which cover letters are displayed.

PTF numbers to select (SELECT)

Specifies which cover letter is displayed 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, cover letters for all installed or supported products are displayed.

When LICPGM(licensed-program) and SELECT(*ALL) are specified, cover letters for all releases of the specified product are displayed. The possible values are:

*NOTAPY

All cover letters of the PTFs that are not already applied or superseded for the specified product are displayed.

*ALL

All cover letters for the specified product are displayed.

PTF-number

Specify the PTF identification number of the cover letter that is displayed. A maximum of 300 PTF numbers can be specified.

Release (RLS)

Specifies the release level of the PTFs being displayed.

The possible values are:

*ALL

The cover letters for all releases of the installed or supported 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 specified is the release of the installed base option of the product, cover letters for all installed options of the product are displayed regardless of the release of the option. All cover letters for options that are supported at this release are also displayed.

If the release specified is not the release of the installed base option of the product, only cover letters of the product options that are supported or installed at that release are displayed.

Attributes (CVRATR)

Specifies which cover letter to display based on the attributes contained in the cover letter.

Note: The CVRATR parameter can be specified only with SELECT(*ALL) or SELECT(*NOTAPY).

The possible values are:

*ALL

All cover letters are displayed.

*SPCINST

Only cover letters with special instructions are displayed.

*PREIMM

Only cover letters with special instructions that need to be followed before being applied or removed immediately are displayed.

*PREDLY

Only cover letters with special instructions that need to be followed before being applied or removed during an IPL (delayed) are displayed.

*PREOPR

Only cover letters with special instructions that need to be followed before being applied or removed (immediately or delayed) are displayed.

*POSTOPR

Only cover letters with special instructions that need to be followed after being applied or removed are displayed.

*UNKNOWN

Display the cover letters for which the system cannot detect if they have attributes. The most likely reasons are when the PTF cover letter was created prior to operating system release V5R1M0, or the cover letter was created using the System Manager licensed program.

Cover letter language (CVRLTRLNG)

Specifies the language feature code that is used to display the cover letters.

The possible values are:

*DFT

Cover letters are displayed in the default language feature code. If there is only one cover letter for the PTF, it will be displayed. If there is more than one cover letter for the PTF, the following criteria will be used to determine which cover letter to display.

The language feature code that matches the service contact information (WRKCNTINF) will be used.

If no language feature code matches the service contact information, the language feature code that matches the primary language of the operating system will be used.

If no cover letters match the language feature code in the service contact information, or the language feature code of the operating system, all cover letters for the PTF will be displayed. The user will be given a list of language feature codes to choose from (if requested by an interactive job) or all cover letters will be printed with the job's spooled output (if requested by a batch job).

*ALL

Cover letters for all languages are displayed.

language-feature-code

Cover letters for the selected language feature code are displayed. If a cover letter for the selected language feature code is not available, no cover letter is displayed for the PTF.

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting workstation 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.

Examples

Example 1: Print PTF Cover Letters

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

This command produces a printout of the cover letter for PTF SI00034 in 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.

CPF35BE

Product &1 &3 not supported or installed.

CPF35D5

Cover letter NLV not valid.

CPF35F5

Cover letter not found for PTF &1-&2 &3.

CPF358A

Release not valid.

CPF3586

List of PTFs not correct.

CPF6601

No PTF activity exists for product &1.

CPF6602

PTF &1-&2 &3 not found.

CPF6603

No PTFs found.