Copy PTF Cover Letter (CPYPTFCVR)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
Restrictions:
- This command is shipped with exclude (*EXCLUDE) public authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles are shipped with private authorities to use this command.
| Top |
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 device that contains the cover letters to be copied.
This is a required parameter.
- name
- Specify the name of the tape device or optical device from which the cover letters are copied.
| Top |
Product (LICPGM)
Specifies the 7-character identifier of the product for which the cover letters are copied.
- *ALL
- The cover letters for all installed or supported products are copied.
- *SUPPTD
- The cover letters for all supported products are copied.
- character-value
- Specify the product identifier of the cover letters to be copied.
| Top |
PTF numbers to select (SELECT)
Specifies which of the cover letters for the specified product are copied.
Single values
- *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.
Other values (up to 300 repetitions)
- character-value
- Specify the PTF identification number of the cover letters to be copied. Specific PTF identifers can be used only if a specific product identifier is specified on the Product (LICPGM) parameter.
| Top |
Release (RLS)
Specifies the release level of the software product.
- *ALL
- Cover letters for all releases of the specified product will be copied.
- character-value
- A specific release can be used only if a specific product identifier is specified on the Product (LICPGM) parameter. 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.
| Top |
Cover letter option (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.
| Top |
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.
- *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.
| Top |
Examples
CPYPTFCVR DEV(OPT01) LICPGM(57xxSS1) SELECT(*ALL)
RLS(VxRyMz)
This command copies all cover letters for PTFs that are not applied to product 57xxSS1 release VxRyMz from device OPT01.
| Top |
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 &4 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.
| Top |