Copy PTF to Save File (CPYPTFSAVF)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Copy Program Temporary Fixes (PTFs) to Save Files (CPYPTFSAVF) command allows you to copy all or selected PTFs for installed and supported products from a device into PTF save files.
Restrictions:
- Only PTFs for installed and supported products are copied.
The following notes provide information on how the command works.
Notes:
- A SAVF is created in the QGPL library for each PTF that is copied.
- If the PTF exists, the PTF is not copied.
- When the PTF SAVF is created in the QGPL library, it is named Qxxxxxxx where xxxxxxx is the PTF identification number or time stamp.
- Cover-letter files in the QGPL library are named Qxxxxxxyy, and placed in file QAPZCOVER, where xxxxxxx is the PTF identification number and yy is the language of the PTF. For English cover letters yy is blank.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FROMDEV | From device | Name | Required, Positional 1 |
| LICPGM | Product | Character value, *ALL, *SUPPTD | Optional, Positional 2 |
| SELECT | PTF numbers to select | Single values: *ALL Other values (up to 50 repetitions): Character value |
Optional |
| OMIT | PTF numbers to omit | Values (up to 50 repetitions): Character value | Optional |
| Top |
From device (FROMDEV)
Specifies the tape unit or optical device that contains the Program Temporary Fixes (PTFs) to be copied into save files (SAVF). Specify the name of the tape device or optical device.
| Top |
Product (LICPGM)
Specifies the names of the licensed programs for which PTFs are to be copied.
The possible values are:
- *ALL
- PTFs for all licensed programs that are installed or supported are copied on to the system.
- *SUPPTD
- Only PTFs for supported licensed programs are copied.
- licensed-program
- Specify the licensed program for which PTFs are copied.
| Top |
PTF numbers to select (SELECT)
Specifies which PTFs are to be copied. The OMIT parameter cannot be specified if individual PTF identification numbers are specified on SELECT parameter.
The possible values are:
- *ALL
- All PTFs are copied.
- PTF-number
- Specify the PTF identification number of the PTF to be copied. A maximum of 50 PTF identification numbers can be specified.
| Top |
PTF numbers to omit (OMIT)
Specifies that all PTFs are copied except for those specified on this parameter. Up to 50 PTF identification numbers can be specified for omission.
| Top |
Examples
Example 1: Copying PTFs for a Specified Program
CPYPTFSAVF FROMDEV(TAP01) LICPGM(5770SS1)
This command copies all PTFs for the licensed program named 5770SS1 from the device named TAP01 into save files on the system.
Example 2: Copying All PTFs
CPYPTFSAVF FROMDEV(TAP01) LICPGM(*ALL)
This command copies all PTFs for all supported products from the device named TAP01 to a save file on the system.
Example 3: Copying PTFs for a Supported Product
CPYPTFSAVF FROMDEV(TAP01) LICPGM(*SUPPTD)
This command copies PTFs for all supported products from the device named TAP01 to a save file on the system.
Example 4: Copying a Specific PTF
CPYPTFSAVF FROMDEV(OPT01) LICPGM(5770SS1) SELECT(PTF0001)
This command copies only the PTF named PTF0001 for the licensed program named 5770SS1 from the device named OPT01 to a save file on the system.
| Top |
Error messages
None
| Top |