| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Apply Program Temporary Fix (APYPTF) command applies program temporary fixes (PTF) to a specified product. Before a PTF can be applied, it must first be loaded by the Load Program Temporary Fix (LODPTF) command.
When a PTF is applied, it completely replaces the affected objects in the product. PTFs can be applied temporarily or permanently. If they are applied temporarily, the replaced objects are saved by the system and can later be restored to the product by the Remove Program Temporary Fix (RMVPTF) command. If PTFs are applied permanently, the replaced objects are deleted from the system.
The APYPTF command is used to apply immediate PTFs at the time the command is run, or to request PTFs to be applied during the next unattended initial program load (IPL). During an attended IPL, the Work with PTFs display is used to apply PTFs at the time the system is started.
Some IPLs may take longer than others when PTFs are being applied. More information about applying PTFs is in the Maintain and manage i5/OS and related software topic of the iSeries Information Center at http://www.iseries.ibm.com/infocenter.
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, *ALL | Required, Positional 1 |
| RLS | Release | Character value, *ONLY, *ALL | 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 |
| APY | Extent of change | *TEMP, *PERM | Optional |
| DELAYED | Delayed PTFs | *NO, *YES, *IMMDLY | Optional |
| IPLAPY | IPL apply options | Single values: *NO Other values: Element list |
Optional |
| Element 1: Apply at unattended IPL | *YES | ||
| Element 2: Prerequisite lic int code | *APYPERM, *NOAPY | ||
| APYREQ | Apply requisite PTFs | *NO, *YES | Optional |
| Top |
Specifies the 7-character identifier of the product for which the PTFs are to be applied.
Note: LICPGM(*ALL) is valid only if SELECT(*ALL) is specified, and OMIT is not specified on this command.
This is a required parameter.
The possible values are:
| Top |
Specifies the release level of the software product. If multiple releases are installed, the release is required.
The possible values are:
| Top |
Specifies the previously loaded PTFs that are to be applied to the specified product. The PTF numbers to omit (OMIT) parameter cannot be specified if single PTF numbers are specified on the SELECT parameter.
You can enter multiple values for this parameter.
The possible values are:
| Top |
Specifies the PTF numbers that are not applied. Up to 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 applied on a temporary or permanent basis. Permanently applied PTFs cannot be removed; temporarily applied PTFs can be removed by the Remove Program Temporary Fix (RMVPTF) command.
The possible values are:
| Top |
Specifies whether immediate PTFs are applied at the time the command is processed or whether immediate and delayed PTFs are applied during the next unattended IPL.
| Top |
Specifies the action that is done for delayed or immediate PTFs at the next unattended IPL.
The possible PTFs Applied at IPL values are:
These values are valid only if DELAYED(*YES) is also specified.
The possible Prerequisite Licensed Internal Code values are:
The Licensed Internal Code prerequisites are applied immediately or at the next IPL depending on the values specified on the DELAYED parameter.
| Top |
Specifies whether the prerequisite and corequisite PTFs of the PTFs specified on the SELECT parameter, that are within the same product and release, are applied with the PTFs specified on the SELECT parameter list.
This parameter is valid only when *ALL is not specified in the SELECT parameter.
The possible values are:
| Top |
Example 1: Applying PTFs Temporarily
APYPTF LICPGM(5722SS1) DELAYED(*YES)
This command applies all the programming fixes that affect the operating system (5722SS1). The fixes are temporarily applied at the next IPL.
Example 2: Applying PTFs Permanently
APYPTF LICPGM(5722SS1) SELECT(SI00003 SI00008 SI00012)
APY(*PERM) DELAYED(*YES)
This command permanently applies PTFs SI00003, SI00008, and SI00012 to the operating system in library QSYS at the next IPL.
Example 3: Applying All Loaded PTFs
APYPTF LICPGM(*ALL) DELAYED(*IMMDLY)
This command permanently applies all PTFs that can be applied immediately and sets the rest to be applied at the next IPL.
Example 4: Applying Immediate PTFs and their Immediate Corequisites and Prerequisites at the Time the Command is Run
APYPTF LICPGM(5722SS1) SELECT(SI00003 SI00008 SI00012)
APYREQ(*YES)
This command applies the identified PTFs and their corequisites and prerequisites at the time the command is run if the PTFs and their corequisites and prerequisites are defined as immediate. PTFs defined as delayed or defined with corequisites or prerequisites defined as delayed are ignored along with the delayed requisites.
Example 5: Applying PTFs and their corequisites and prerequisites at the next IPL
APYPTF LICPGM(5722SS1) SELECT(SI00003 SI00008 SI00012)
DELAYED(*YES) APYREQ(*YES)
This command applies the identified PTFs and their corequisites and prerequisites at the next IPL regardless of whether they are defined as delayed or immediate.
Example 6: Applying PTFs and their corequisites and prerequisites as soon as possible
APYPTF LICPGM(5722SS1) SELECT(SI00003 SI00008 SI00012)
DELAYED(*IMMDLY) APYREQ(*YES)
This command applies the identified PTFs and their corequisites and prerequisites at the time the command is run if the PTFs and their corequisites and prerequisites are defined as immediate. PTFs defined as delayed or defined with corequisites or prerequisites defined as delayed are applied during the next IPL along with the delayed requisites.
| Top |
*ESCAPE Messages
| Top |