Display PTF Group (DSPPTFGRP)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Display PTF Group (DSPPTFGRP) command displays information for the selected PTF group. A PTF group consists of a list of program temporary fixes (PTFs) defined for the purpose of managing those PTFs as one group. A PTF group can identify other PTF groups called related PTF groups. The PTFs in the PTF group as well as the PTFs in the latest installed level of all related PTF groups are used to determine the overall status of the PTF group.
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 |
|---|---|---|---|
| PTFGRP | PTF group | Character value | Required, Positional 1 |
| PTFGRPLVL | PTF group level | 1-99999, *INSTALLED, *LATEST | Optional |
| TYPE | Type of information | *PTF, *NOTINSPTF, *RELPTFGRP, *SPCHDLPTF | Optional |
| OUTPUT | Output | Optional |
| Top |
PTF group (PTFGRP)
Specifies the PTF group to display.
This is a required parameter.
- name
- Specify the name of the PTF group to display.
| Top |
PTF group level (PTFGRPLVL)
Specifies the level of the PTF group to display.
- *LATEST
- The latest level of the PTF group is displayed.
- *INSTALLED
- The latest level of the PTF group that has a status of Installed or Apply at next IPL is displayed. If no levels of the PTF group have a status of Installed or Apply at next IPL, the latest level of the PTF group that exists on the system is displayed.
- 1-99999
- Specify the level of the PTF group to display.
| Top |
Type of information (TYPE)
Specifies the type of information to display.
Note: If OUTPUT(*PRINT) is specified, this parameter is ignored and all of the information is printed for the selected PTF group. This includes the defined list of PTFs, the list of related PTF groups, the list of special handling PTFs, and the list of applicable PTFs that are not installed.
- *PTF
- Displays the list of PTFs defined in the selected PTF group.
- *NOTINSPTF
- Displays the list of all applicable PTFs that are not installed for the selected PTF group and its related PTF groups. If a PTF in the PTF group or related PTF groups has a status of Superseded, the PTF it is superseded by is displayed in place of the superseded PTF.
- *RELPTFGRP
- Displays the list of related PTF groups defined in the selected PTF group.
- *SPCHDLPTF
- Displays the list of special handling PTFs defined in the selected PTF group.
| 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.
| Top |
Examples
Example 1: Display Information for a PTF Group
DSPPTFGRP PTFGRP(SF99123) TYPE(*PTF)
This command displays the list of PTFs defined in the latest level of PTF group SF99123.
Example 2: Print Information for a PTF Group
DSPPTFGRP PTFGRP(SF99123) OUTPUT(*PRINT)
This command produces output which is printed with the job's spooled output. The information for the latest level of PTF group SF99123 is printed which includes the defined list of PTFs, the list of related PTF groups, the list of special handling PTFs, and the list of applicable PTFs that are not installed.
| Top |
Error messages
*ESCAPE Messages
- CPF3598
- PTF function already in process.
- CPF36A4
- PTF group &1 not found.
- CPF36A6
- PTF group name &1 not valid.
| Top |