| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Remove Program Temporary Fix (RMVPTF) command removes the specified program temporary fixes (PTFs) from the specified product. If the PTFs are temporarily applied, the original objects that they replaced are returned. The PTFs can be temporarily removed, in which case they are held in the product PTF library and they can be applied later. If the PTFs have not been applied, they can be permanently removed and moved to the QRPLOBJ library.
The RMVPTF command is used to remove immediate PTFs at the time the command is run, or to request PTFs to be removed during the next unattended initial program load (IPL).
Restriction: To use this command, you must be signed on as QSRV, or have *ALLOBJ authority.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| LICPGM | Product | Character value | Required, Positional 1 |
| RLS | Release | Character value, *ONLY | Optional |
| SELECT | PTF numbers to select | Single values: *ALL Other values (up to 300 repetitions): Character value |
Optional |
| OMIT | PTF numbers to omit | Values (up to 300 repetitions): Character value | Optional |
| RMV | Extent of change | *TEMP, *PERM | Optional |
| DELAYED | Delayed PTFs | *NO, *YES | Optional |
| IPLRMV | Remove on unattended IPL | *YES, *NO | Optional |
| RMVDEP | Remove dependent PTFs | *NO, *YES | Optional |
| Top |
Specifies the 7-character identifier of the product from which the PTFs are removed.
This is a required parameter.
| Top |
Specifies the release level of the PTFs being loaded.
The possible values are:
If the release-level specified is the release-level of the base option of the product, PTFs for all installed options of the product are removed regardless of the release-level of the option.
If the release-level specified is not the release-level of the base option of the product, only PTFs for the options installed at that release-level are removed.
| Top |
Specifies which PTFs are removed from the specified product. The PTF numbers to omit (OMIT) parameter cannot be specified if single PTF numbers are specified in the PTF numbers to select (SELECT) parameter.
You can enter multiple values for this parameter.
The possible values are:
| Top |
Specifies that all PTFs are removed except for those specified in this parameter. Specify the PTF numbers of the program temporary fixes that are omitted (left in the system) when all the rest are removed. A maximum of 300 PTF numbers can be specified. The OMIT parameter cannot be specified if single PTF numbers are specified in the PTF numbers to select (SELECT) parameter.
You can enter multiple values for this parameter.
| Top |
Specifies whether the PTFs are removed temporarily or permanently. Permanently removed PTF objects are moved to QRPLOBJ or deleted. Temporarily removed PTF objects are held in the product PTF library for application at a later time.
The possible values are:
| Top |
Specifies whether immediate PTFs are removed at the time the command is run, or whether immediate and delayed PTFs are removed in a delayed manner during the next unattended IPL.
| Top |
Specifies the action that is done for delayed or immediate PTFs at the next unattended IPL. This parameter is valid only if *YES was specified for the Delayed PTFs (DELAYED) parameter.
The possible values are:
| Top |
Specifies whether dependent PTFs and mutually dependent PTFs in the same product and option as the PTFs specified in the SELECT parameter are processed with the PTFs specified in the SELECT parameter list. The RMVDEP parameter is valid only if *ALL is not specified in the SELECT parameter.
The possible values are:
| Top |
Example 1: Temporarily Removing PTFs
RMVPTF LICPGM(5722SS1) DELAYED(*YES)
This command temporarily removes all temporarily applied PTFs from the operating system (5722SS1) at the next IPL. The PTFs can be applied again, if necessary, using the APYPTF command.
Example 2: Permanently Removing PTFs
RMVPTF LICPGM(5722SS1) SELECT(SI10002 SI10005) RMV(*PERM)
This command permanently removes two PTFs (numbers SI10002 and SI10005) from the operating system (5722SS1). The two PTFs are moved to QRPLOBJ and must be loaded again using the LODPTF command before they can be applied.
Example 3: Removing PTFs and Their Mutual Dependents
RMVPTF LICPGM(5722SS1) SELECT(SI00003 SI00008 SI00012)
DELAYED(*YES) RMVDEP(*YES)
This command temporarily removes PTFs SI00003, SI00008, SI00012, and their dependent and mutually dependent PTFs within the same product and option from the operating system in library QSYS at the next IPL.
| Top |
*ESCAPE Messages
| Top |