Display Program Temporary Fix (DSPPTF)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Display Program Temporary Fix (DSPPTF) command shows the program temporary fixes (PTFs) for a specified product.
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 |
|---|---|---|---|
| LICPGM | Product | Character value, *ALL, *FMW | Optional, Positional 1 |
| SELECT | PTF numbers to select |  Character value, *ALL, *PTFSAVF, *ONORDER, *ACTRQD, *NOTAPY, *SAVFONLY, *ONORDONLY, *COVERONLY |
Optional, Positional 2 |
| RLS | Release | Character value, *ALL | Optional |
| COVERONLY | Cover letter only | *NO, *YES | Optional |
| OUTPUT | Output | *, *PRINT, *OUTFILE | Optional |
| OUTFILE | File to receive output | Qualified object name | Optional |
| Qualifier 1: File to receive output | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| OUTMBR | Output member options | Element list | Optional |
| Element 1: Member to receive output | Name, *FIRST | ||
| Element 2: Replace or add records | *REPLACE, *ADD |
| Top |
Product (LICPGM)
Specifies the product for the PTFs that are shown. When LICPGM(*ALL) is specified, PTFs for all installed and supported products are shown.
- *ALL
- The PTFs of all installed and supported products are shown.
- *FMW
- The PTFs of all installed and supported server firmware products are shown.
- licensed-program
- Specify the product for which PTFs are shown.
| Top |
PTF numbers to select (SELECT)
Specifies which PTF is shown 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, all PTFs for all installed and supported products are shown.
When LICPGM(licensed-program) and SELECT(*ALL) are specified, PTFs for all releases of the specified products are shown.
- *ALL
- The status of all PTFs for the specified product is shown.
- *PTFSAVF
- The status of all PTFs for the specified product that have a save file in library QGPL is shown. This special value is useful for determining which PTF save files are no longer needed. It is also useful for the service provider for determining which PTFs can be distributed.
- *ONORDER
- The status of all PTFs for the specified product that are on order is shown.
- *ACTRQD
- The PTFs that have required actions pending are shown. This special value is useful to the user for determining which PTFs require an action to become active.
Note: If *ACTRQD is specified, the exit programs that run take a long time, resulting in a delay in the appearance of the first screen.
- *NOTAPY
- All PTFs that are not already applied or superseded for the specified product are displayed.
- *SAVFONLY
- All PTFs with a status of Save file only are displayed for the specified product.
- *ONORDONLY
- All PTFs with a status of On order only are displayed for the specified product.
- *COVERONLY
- All PTFs with a status of Cover letter only are displayed for the specified product.
- character-value
- Specify the PTF identification number of the PTF that is shown.
| Top |
Release (RLS)
Specifies the release level of the PTFs being displayed.
- *ALL
- The PTFs for all releases of the supported and installed 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.
| Top |
Cover letter only (COVERONLY)
Specifies whether only the cover letter is displayed.
- *NO
- A cover letter is not displayed.
- *YES
- The cover letter is displayed.
| Top |
Output (OUTPUT)
Specifies whether the output from the command is displayed at the requesting work station 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).
- The output is printed with the job's spooled output. The name of the spooled output file is QSYSPRT.
- *OUTFILE
- The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.
| Top |
File to receive output (OUTFILE)
Specifies the physical database file where the PTF records are directed. If the output file already exists, the system attempts to use it. The system creates a physical database file (with the name specified in the OUTFILE parameter) in the designated library. A member is created for the file with the name specified in the Output member options (OUTMBR) parameter. If a new file is created, system file QADSPPTF in system library QSYS with a format name of QSCPTF is used as a model.
Qualifier 1: File to receive output
- name
- Specify the name of the database file to which the command output is directed.
Qualifier 2: Library
- *LIBL
- The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
- *CURLIB
- The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.
- name
- Specify the name of the library to be searched.
| Top |
Output member options (OUTMBR)
Specifies the name of the database file member that receives the output of the command.
Element 1: Member to receive output
- *FIRST
- The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the File to receive output (OUTFILE) parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
- name
- Specify the name of the file member that receives the output. If it does not exist, the system creates it.
Element 2: Replace or add records
- *REPLACE
- The system clears the existing member and adds the new records.
- *ADD
- The system adds the new records to the end of the existing records.
| Top |
Examples
Example 1: Printing Status of PTFs
DSPPTF LICPGM(57xxSS1) OUTPUT(*PRINT)
This command produces a printout containing the status of PTFs for the product 57xxSS1.
Example 2: Printing Information
DSPPTF LICPGM(57xxSS1) SELECT(SI00034) OUTPUT(*PRINT)
This command produces a printout containing detailed information about PTF SI00034 for the product 57xxSS1.
| Top |
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.
- CPF24B4
- Severe error while addressing parameter list.
- CPF35BE
- Product &1 &4 not supported or installed.
- CPF35F5
- Cover letter not found for PTF &1-&2 &4.
- CPF358A
- Release not valid.
- CPF3925
- Cannot open file &1.
- CPF3950
- Error message &2 received for file &1. Request ended.
- CPF6601
- No PTF activity exists for product &1.
- CPF6602
- PTF &1-&2 &4 not found.
- CPF6603
- No PTFs found.
- CPF6613
- No PTFs met selection criteria.
- CPF8191
- Product definition &4 in &9 damaged.
- CPF8193
- Product load object &4 in &9 damaged.
- CPF9860
- Error occurred during output file processing.
| Top |