The Copy Program Temporary Fix Cover Letter (CPYPTFCVR) command copies program temporary fix (PTF) cover letters from tape or optical media into file QAPZCOVER in library QGPL. Each cover letter contains information such as problem description, correction, and special instructions. Cover letters can then be viewed using the Display PTF Cover Letter (DSPPTFCVR) and Display Program Temporary Fix (DSPPTF) commands.

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
DEV	Device	Character value	Required, Positional 1
LICPGM	Product	Character value, *ALL, *SUPPTD	Optional, Positional 2
SELECT	PTF numbers to select	Single values: *NOTAPY, *ALL Other values (up to 300 repetitions): Character value	Optional
RLS	Release	Character value, *ALL	Optional
CVROPT	Cover letter option	*NEW, *ADD, *ALL	Optional
ENDOPT	End of media option	*REWIND, *LEAVE, *UNLOAD	Optional

Top

Device (DEV)

Specifies the name of the device that contains the cover letters to be copied.

This is a required parameter.

tape-device-name

Specify the name of the tape device from which the cover letters are copied.

optical-device-name

Specify the name of the optical device from which the cover letters are copied.

Product (LICPGM)

Specifies the 7-character identifier of the product for which the cover letters are copied.

The possible values are:

*ALL

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

*SUPPTD

The cover letters for all supported products are copied.

licensed-program

Specify the product identifier of the cover letters to be copied.

PTF numbers to select (SELECT)

Specifies which of the cover letters for the specified product are copied.

The possible values are:

*NOTAPY

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

*ALL

All the cover letters for the specified product are copied.

PTF-number

Specify the PTF identification number of the cover letters to be copied. A maximum of 300 PTF numbers can be specified. Specific PTF identifers can be used only if a specific product identifier is specified on the Product (LICPGM) parameter.

Release (RLS)

Specifies the release level of the software product.

The possible values are:

*ALL

Cover letters for all releases of the specified product will be copied.

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. A specific release can be used only if a specific product identifier is specified on the Product (LICPGM) parameter.

Cover letter option (CVROPT)

Specifies what to do if the cover letter being copied already exists on the system.

The possible values are:

*NEW

If a cover letter for the PTF already exists on the system in any language feature code, the cover letter will not be copied from the media. If no cover letter for the PTF exists on the system, the cover letter will be copied.

*ADD

If a cover letter for the PTF does not exist with the same language feature code, the cover letter will be copied from the media. Otherwise the cover letter will not be copied.

*ALL

If a cover letter with the same language feature code already exists on the system, it will be replaced. If no cover letter exists on the system for the language feature code, the cover letter will be copied.

End of media option (ENDOPT)

Specifies the operation that is automatically performed on the tape or optical volume after the PTF operation ends. If one or more volumes of media is involved, this parameter applies only to the last volume.

Note: For optical devices, *UNLOAD is the only special value supported, *REWIND and *LEAVE will be ignored.

The possible values are:

*REWIND

The tape is automatically rewound, but not unloaded, after the operation has ended.

*LEAVE

The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.

*UNLOAD

The tape is automatically rewound and unloaded after the operation ends. Some optical devices will eject the volume after the operation ends.

Examples

CPYPTFCVR   DEV(OPT01)  LICPGM(5722SS1)  SELECT(*ALL)
            RLS(V5R4M0)

This command copies all cover letters for PTFs that are not applied to product 5722SS1 release V5R4M0 from device OPT01.

Error messages

*ESCAPE Messages

CPF354D

Device &1 not allowed.

CPF3586

List of PTFs not correct.

CPF358A

Release not valid.

CPF359D

No PTFs on device &3 met the selection criteria.

CPF35BE

Product &1 &3 not supported or installed.

CPF35E0

Error occurred copying PTF information.

CPF35F1

Cover letter file &1 in &2 not found.

CPF363C

No PTF cover letters copied from device &3.

CPF9814

Device &1 not found.

CPF9822

Not authorized to file &1 in library &2.

CPF9825

Not authorized to device &1.