CPYPTFCVR (Copy PTF Cover Letter)

CPYPTFCVR Command syntax diagram

 

Purpose

The Copy Program Temporary Fix Cover Letter (CPYPTFCVR) command copies program temporary fix 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 Program Temporary Fix Cover Letter (DSPPTFCVR) and Display Program Temporary Fix (DSPPTF) commands.

 

Restrictions

Parameters

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

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.

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

*ALL: Cover letters for all installed and/or supported products are copied.

*SUPPTD: Cover letters for all supported products are copied.

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

SELECT
Identifies which of the cover letters for the specified product are copied.

*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 numbers of the cover letters to be copied. A maximum of 300 PTF numbers can be specified.

RLS
Specifies the release level of the software product.

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

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.

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

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

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.

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

Example for CPYPTFCVR 

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

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

Error messages for CPYPTFCVR

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