Jump to content

Program temporary fix

Edit links
From Wikipedia, the free encyclopedia

In IBM terminology, a program temporary fix or product temporary fix (PTF) is a software fix, or a group of fixes, distributed in a form ready to install.[1][2]

A PTF normally follows an Authorized Program Analysis Report (APAR).[3] When an APAR fix is issued, the PTF is generally a tested APAR fix, or a set of APAR fixes.[4] However, if an APAR is resolved as "Fixed If Next" or "Permanent Restriction", there may be no PTF for the current release, only a correction in a later release.

PTFs are used across multiple IBM platforms and are installed using platform-specific service tools. On IBM i, PTFs can be applied either temporarily or permanently, with temporarily applied fixes remaining reversible until they are made permanent.[5] IBM i also distributes fixes in aggregated forms such as cumulative PTF packages and PTF groups.[6][7] On z/OS, PTFs are commonly installed and tracked using System Modification Program/Extended (SMP/E).[8] On z/VM, VMSES/E provides an installation and service toolset used for servicing software levels, including corrective service delivered as PTFs.[9]

History and development

[edit]

IBM developed formal service workflows and tools to manage the distribution and installation of software fixes on its operating systems. Initially, installations had to install service through a semi-manual process.[10]

Over time, IBM introduced service aids such as IMAPTFLE[11] and utilities such as IEBEDIT[12] to simplify the installation of batches of PTFs. For OS/360 and successors, this culminated in the System Modification Program (SMP)[13] and System Modification Program/Extended (SMP/E).[14]

For VM, IBM developed Virtual Machine Serviceability Enhancements Staged (VM/SP SES) and VMSES/E. For DOS/360 and successors, IBM used the Maintain System History Program (MSHP).

PTF installation

[edit]

On IBM i, PTF installation commonly involves loading a PTF into the system and then applying it to the affected product. IBM documentation describes the Load Program Temporary Fix (LODPTF) command as loading PTFs from media or save files into the product PTF library, and the Apply Program Temporary Fix (APYPTF) command as applying the fix to replace the affected objects in the product.[15] The same documentation notes that PTFs can be applied temporarily or permanently, with temporarily applied fixes remaining reversible until they are made permanent.[16]

In z/OS, PTFs are processed using SMP/E in several stages. Each PTF may include HOLDDATA, in which case it is known as an exception SYSMOD. In rare cases an installation may install a single PTF, but normally it installs available service except PTFs excluded by, for example, aging policies or HOLDDATA.

A typical z/OS service cycle may involve:

  1. Downloading the most recent HOLDDATA.
  2. Receiving the service and HOLDDATA into the Consolidated Software Inventory (CSI).
  3. Running APPLY CHECK against the service and HOLDDATA to identify exception SYSMODs, verify prerequisites and list potential problems.
  4. Reviewing exception SYSMODs, such as ACTION, DOC and hold items.
  5. Ordering and receiving any missing prerequisites.
  6. Reworking and reapplying any local exits or modifications affected by the service.
  7. Applying the service to a test or non-production system, where available.
  8. Monitoring the system before applying the service to production.
  9. Accepting the service permanently if no problems are found.

If the system is adversely affected by the service, a system administrator may sometimes selectively RESTORE the PTF and seek further support from IBM. If no problems are found after the service is applied, it can be permanently installed, or ACCEPTed, into the system.

PTF usage

[edit]

PTFs were formerly distributed in groups on a Program Update Tape (PUT) or as a Recommended Service Upgrade (RSU), often on a monthly basis. They can now be downloaded directly through IBM support systems. In some cases, IBM releases a cumulative PTF package, a larger collection of fixes intended to be installed together.

One reason for the continued use of physical or image-based media has been the size of some service packages. For example, the default size of the /home file system on VIOS (Virtual I/O Server) for IBM System p has been cited as 10 GB.[17][18] If cumulative PTF images exceed available space, they may need to be handled through alternative storage or installation methods.

PTFs are often issued in response to APARs submitted by customers or identified by IBM. They are a common step in correcting software errors before the correction is incorporated into a later product release.

Terminology and variants

[edit]

IBM documentation uses both the expanded forms program temporary fix and product temporary fix, while retaining the acronym PTF. IBM i documentation explicitly expands PTF as Program Temporary Fix in command references such as LODPTF and APYPTF.[19] IBM z/VM service materials also refer to corrective service delivered as a Product Temporary Fix (PTF).[20]

Comparison to APAR

[edit]

An Authorized Program Analysis Report (APAR) is a formal report used when IBM determines that a problem may be caused by a defect in an IBM program. IBM support may file an APAR after determining that the issue is not caused by third-party hardware, non-IBM software or user-specified configuration errors.[21]

APARs may include information on known workarounds, whether a formal fix is planned for a future release and whether a PTF is planned.[21] An APAR fix is typically intended to address a reported problem quickly, while a PTF is a tested correction that may close the APAR.[4]

Summary

[edit]

There are at least two levels of fix:[22]

  • An APAR may result in an APAR fix.
  • A PTF may provide a tested correction associated with one or more APARs.

The focus of an APAR fix is to address the problem as quickly as possible,[23] whereas a PTF is a tested fix that may close the APAR.[4]

Humor

[edit]

Customers sometimes explain the acronym in a tongue-in-cheek manner as permanent temporary fix[24] or probably this fixes, referring to the option of making a PTF a permanent part of the operating system if the patch resolves the problem.

See also

[edit]

References

[edit]
  1. ^ In 2001 a long time IBMer wrote "I thought it was now Product Temporary Fix." "Should APARs be accepted".
  2. ^ Nonetheless PROGRAM temporary fix is still in use. "Traps do not process for CiscoAPIC models in CA Spectrum". ca.com. September 11, 2017.
  3. ^ IBM Corporation. "IBM Security: APARs explained". ibm.com. Retrieved Oct 14, 2019. a formal report from IBM development to customers that have notified IBM of a problem or suspected defect.
  4. ^ a b c Gabe Goldberg (June 12, 2013). "IBM's APAR process provides the tools for dealing with software issues". destinationz.org (MSP TechMedia). Archived from the original on April 1, 2014.
  5. ^ "Apply Program Temporary Fix (APYPTF)". IBM Docs. IBM. Retrieved 2026-01-14.
  6. ^ "Installing cumulative PTF packages". IBM Docs. IBM. Retrieved 2026-01-14.
  7. ^ "Fix groups (IBM i)". IBM Docs. IBM. Retrieved 2026-01-14.
  8. ^ "z/OS SMP/E". IBM Docs. IBM. Retrieved 2026-01-14.
  9. ^ "z/VM: VMSES/E Introduction and Reference" (PDF). IBM Docs. IBM. Retrieved 2026-01-14.
  10. ^ IBM System/360 Operating System - Maintenance Program. Systems Reference Library. C27-6918.
  11. ^ "Chapter 9: IMAPTFLE" (PDF). IBM System/360 Operating System: Service Aids - OS Release 21 (PDF). Systems Reference Library (Third ed.). March 1972. pp. 219–239. GC28-6719-2.
  12. ^ "The IEBEDIT Program" (PDF). IBM System/360 Operating System - Utilities (PDF). Systems Reference Library (Twelfth ed.). June 1970. pp. 392–402. GC28-6586-11.
  13. ^ OS/VS System Modification Program (SMP) - System Programmer's Guide (PDF). Systems (Seventh ed.). IBM. September 1980. GC28-0673-6. Retrieved July 10, 2023.
  14. ^ System Modification Program Extended - 8.1 (PDF) (Fourteenth ed.). IBM. September 1994. SC28-1107-13. Retrieved July 10, 2023.
  15. ^ "Apply Program Temporary Fix (APYPTF)". IBM Docs. IBM. Retrieved 2026-01-14.
  16. ^ "Fix groups (IBM i)". IBM Docs. IBM. Retrieved 2026-01-14.
  17. ^ IBM Corporation. "Virtual I/O Server overview". IBM Knowledge Center. Retrieved Oct 14, 2019.
  18. ^ Glenn Robinson (October 28, 2015). "Populating the VIOS Virtual Media Repository". PowerWire - Connect to the IBMi Community.
  19. ^ "Apply Program Temporary Fix (APYPTF)". IBM Docs. IBM. Retrieved 2026-01-14.
  20. ^ "z/VM: VMSES/E Introduction and Reference" (PDF). IBM Docs. IBM. Retrieved 2026-01-14.
  21. ^ a b "IBM Support – Authorized Program Analysis Reports". AmitechSolutions.com. Archived from the original on 2017-12-08. Retrieved 2017-12-07.
  22. ^ "An APAR fix is usually replaced later by a permanent correction called a PTF." Ebbers, Mike; Kettner, John; O'Brien, Wayne (2012). Introduction to the New Mainframe: z/OS Basics. IBM Redbooks. ISBN 978-0738435343.
  23. ^ Mehdi Salebi (August 7, 2011). "Diff between PTF, APAR, INTERMFIX".
  24. ^ "PTF - Permanent Temporary Fix (humor)". AcronymFinder.com.
[edit]
Retrieved from "https://en.wikipedia.org/w/index.php?title=Program_temporary_fix&oldid=1352869094"