Display PTF Cover Letter (DSPPTFCVR)

The Display Program Temporary Fix Cover Letter (DSPPTFCVR) command shows the program temporary fix (PTF) cover letters for a specified product.

Restrictions:

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

Product (LICPGM)

Specifies the product for which cover letters are displayed.

*ALL
The cover letters for all installed or supported products are displayed.
character-value
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 for this 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.

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

*ALL
The cover letters for all releases of the installed or supported products are displayed.
character-value
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.

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

Single values

*ALL
All cover letters are displayed.

Other values (up to 7 repetitions)

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

*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.
character-value
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 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(57xxSS1)  SELECT(SI00034)  OUTPUT(*PRINT)

This command produces a printout of the cover letter for PTF SI00034 in the product 57xxSS1.

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 &4 not supported or installed.
CPF35D5
Cover letter NLV not valid.
CPF35F5
Cover letter not found for PTF &1-&2 &4.
CPF358A
Release not valid.
CPF3586
List of PTFs not correct.
CPF6601
No PTF activity exists for product &1.
CPF6602
PTF &1-&2 &4 not found.
CPF6603
No PTFs found.