DSPPTFCVR (Display PTF Cover Letter)

DSPPTFCVR Command syntax diagram

 

Purpose

The Display Program Temporary Fix Cover Letter (DSPPTFCVR) command shows the program temporary fix 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.

LICPGM

Specifies the product for which cover letters are displayed.

*ALL: The cover letters for all installed and supported products are displayed.

licensed-program: Specify the product for which cover letters are displayed.

SELECT

Specifies which cover letter is displayed for the specified product.

When LICPGM(*ALL) and SELECT(*ALL) are specified, all cover letters for all installed and supported products are displayed.

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

*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.

RLS

Specifies the release level of the PTFs being displayed.

*ALL: The cover letters for all releases of the supported and installed product are displayed.

release: 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 for the product options that are supported or installed at that release are displayed.

CVRATR

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

*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.

*PREOPR: Only cover letters with special instructions that need to be followed before being applied or removed (immediately or delayed) 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.

*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 for AS/400 licensed program.

CVRLTRLNG

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

*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).
• If no language feature code matches the service contact information, the language feature code that matches 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 chose 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.

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. More information on language feature code identifications and a list of IBM-supplied language feature codes is in the Software Installation book.

OUTPUT

Specifies whether the output from the command is shown at the requesting workstation or printed with the job's spooled output. More information on this parameter is in Commonly used parameters.

*: 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.

Example for DSPPTFCVR

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 for DSPPTFCVR

*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.

CPF3586

List of PTFs not correct.

CPF358A

Release not valid.

CPF35BE

Product &1 &3 not supported or installed.

CPF35F5

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

CPF35D5

Cover letter NLV not valid.

CPF6601

No PTF activity exists for product &1.

CPF6602

PTF &1-&2 &3 not found.

CPF6603

No PTFs found.