Program temporary fix

Quality 0.50 · 2 views · Updated 2 months ago

title: "Program temporary fix" type: doc version: 1 created: 2026-02-28 author: "Wikipedia contributors" status: active scope: public tags: ["ibm-software", "software-maintenance"] topic_path: "general/ibm-software" source: "https://en.wikipedia.org/wiki/Program_temporary_fix" license: "CC BY-SA 4.0" wikipedia_page_id: 0 wikipedia_revision_id: 0

In IBM terminology, a program temporary fix or product temporary fix (PTF), sometimes depending on date,In 2001 a long time IBMer wrote "I thought it was now Product Temporary Fix." {{cite web |url=https://groups.google.com/d/topic/bit.listserv.ibm-main/Ir_Jp8C50KM |title=Should APARs be accepted}}Nonetheless PROGRAM temporary fix is still in use. {{cite web |title=Traps do not process for CiscoAPIC models in CA Spectrum |url=https://support.ca.com/us/knowledge-base-articles.TEC1984606.html |date=September 11, 2017 |website=ca.com}} is a one or more bug fixes distributed in a form ready to install.

A PTF normally follows an Authorized Program Analysis Report (APAR), and where an "APAR fix" was issued, the PTF "is a tested APAR" or set of APAR fixes. However, if an APAR is resolved as "Fixed If Next" or "Permanent Restriction" then there may be no PTF fixing it, only a subsequent release.

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

History and development

IBM developed formal service workflows and tooling to manage the distribution and installation of software fixes on its operating systems. On z/OS, SMP/E is described as a tool for installing and maintaining software and for managing the inventory of installed software, supporting systematic application of service such as PTFs. SMP/E documentation also describes receiving service and related data (such as HOLDDATA) as part of ongoing maintenance workflows.

On z/VM, VMSES/E is documented as an installation and service tool for IBM z/VM, providing mechanisms for servicing software and managing software levels as part of z/VM maintenance.

PTF installation

Initially, installations had to install service via a semi-manual process.{{cite book | title = IBM System/360 Operating System - Maintenance Program | id = C27-6918 | series = Systems Reference Library

Over time, IBM started to provide service aids such as IMAPTFLE{{cite book | title = IBM System/360 Operating System: Service Aids - OS Release 21 | id = GC28-6719-2 | date = March 1972 | edition = Third | pages = 219–239 | section = Chapter 9: IMAPTFLE | section-url = http://bitsavers.org/pdf/ibm/360/os/R21.0_Mar72/GC28-6719-2_Service_Aids_Rel_21_Mar72.pdf#page=219 | url = http://bitsavers.org/pdf/ibm/360/os/R21.0_Mar72/GC28-6719-2_Service_Aids_Rel_21_Mar72.pdf | series = Systems Reference Library and utilities such as IEBEDIT{{cite book | title = IBM System/360 Operating System - Utilities | id = GC28-6586-11 | date = June 1970 | edition = Twelfth | pages = 392–402 | section = The IEBEDIT Program | section-url = http://bitsavers.org/pdf/ibm/360/os/R19_Jun70/GC28-6586-11_Utilities_Rel_19_Jun70.pdf#page=392 | url = http://bitsavers.org/pdf/ibm/360/os/R19_Jun70/GC28-6586-11_Utilities_Rel_19_Jun70.pdf | series = Systems Reference Library to simplify the installation of batches of PTFs. For OS/360 and successors, this culminated in System Modification Program (SMP){{cite book | title = OS/VS System Modification Program (SMP) - System Programmer's Guide | id = GC28-0673-6 | date = September 1980 | edition = Seventh | url = http://bitsavers.org/pdf/ibm/370/OS_VS/GC28-0673-6_OS_VS_System_Modification_Program_%28SMP%29_Systems_Programmers_Guide_7th_ed_198009.pdf | series = Systems | publisher = IBM | access-date = July 10, 2023 and System Modification Program/Extended (SMP/E).{{cite book | title = System Modification Program Extended - 8.1 | id = SC28-1107-13 | date = September 1994 | edition = Fourteenth | url = http://bitsavers.org/pdf/ibm/370/SMP-E/SC28-1107-13_System_Modification_Program_Extended_Reference_Release_8.1_14th_ed_199409.pdf | publisher = IBM | access-date = July 10, 2023

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. The same documentation notes that PTFs can be applied temporarily or permanently, with temporarily applied fixes remaining reversible until made permanent.

For VM, this culminated in Virtual Machine Serviceability Enhancements Staged (VM/SP SES) and VMSES/E.

For DOS/360 and successors, this culminated in Maintain System History Program (MSHP)

PTF usage

PTFs used to be distributed in a group on a so-called Program Update Tape (PUT) or Recommended Service Upgrade (RSU), approximately on a monthly basis. They can now be downloaded straight to the system through a direct connection to IBM support. In some instances IBM will release a "Cumulative PTF Pack", a large number of fixes which function best as a whole, and are sometimes codependent. When this happens, IBM issues compact discs containing the entire PTF pack, which can be loaded directly onto the system from its media drive.

One reason for the use of physical media is size, and related (default) size limits. "By default, the /home file system on VIOS (Virtual I/O Server) for System p is only 10GB in size."{{cite web |title=Populating the VIOS Virtual Media Repository |author=Glenn Robinson |work=PowerWire - Connect to the IBMi Community |date=October 28, 2015 |url=http://powerwire.eu/tech-tip-populating-the-vios-virtual-media-repository}} If the "Cumulative PTF Pack" is larger than the default, "If you try (to) FTP 17GB of ISO images you will run out of space."

In z/OS, the PTFs are processed using SMP/E (System Modification Program/Extended) in several stages over a course of weeks. 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 will install all available service except PTFs excluded by, e.g., aging policies, HOLDDATA. Details vary from installation to installation, but a simple service cycle would involve these steps:

  1. Download the most recent HOLDDATA
  2. RECEIVE (load) the service and HOLDDATA to the Consolidated Software Inventory (CSI)
  3. APPLY CHECK the service and HOLDDATA to list exception SYSMODs, verify that necessary prerequisites are available, and to list potential problems, e.g., errors.
  4. Review exception SYSMODs for, e.g., ACTION, DOC, holds.
  5. Update documentation to reflect the exception SYSMODs, and take any necessary actions
  6. Order and RECEIVE any missing prerequisites.
  7. RESTORE, REJECT, rework and re-APPLY any local exits or modifications affected by the service.
  8. APPLY the service to one system in a cluster (if available), and review the system's performance over multiple weeks to ensure it does not hinder your productivity or functionality
  9. Selectively BYPASS HOLDDATA when appropriate
  10. RECEIVE and APPLY the service to the production system and monitor its effects for several weeks

If the system is adversely affected by the service, a system administrator may sometimes selectively RESTORE (un-apply) it and seek further support from IBM. However, if no problems are found after the service is applied, it can be permanently installed, ACCEPTed (committed) to the system.

These repairs to IBM software are often in response to APARs submitted by customers and others and acted on by IBM, and are a common first step to resolving software errors. It is generally expected by the customer that the problem would be fully corrected in the next release (version) of the relevant product.

Terminology and variants

IBM documentation uses both the expanded form Program temporary fix and, in some contexts, Product temporary fix, while retaining the acronym PTF. For example, IBM i documentation explicitly expands PTF as Program Temporary Fix in command references such as LODPTF and APYPTF. IBM z/VM service materials also refer to corrective service delivered via a Product Temporary Fix (PTF).

Comparison to APAR

At times IBM software has a bug.

Once IBM has ascertained that the cause is not one of

  • third-party hardware
  • non-IBM software -or-
  • user-specified configuration errors, IBM support staff, if they suspect that a defect in a current release of an IBM program is the cause, will file a formal report confirming the existence of an issue. This is referred to as an Authorized Program Analysis Report (APAR). See

APARs also include

  • information on known workarounds
  • information on whether a formal fix is scheduled to be included in future releases, and
  • whether or not a Program Temporary Fix (PTF) is planned.

Summary

There are at least 2 levels of fix:"An APAR fix is usually replaced later by a permanent correction called a PTF." {{cite book |title=Introduction to the New Mainframe: z/OS Basics |url=https://books.google.com/books?isbn=0738435341 |isbn=978-0738435343 |first1=Mike |last1=Ebbers |first2=John |last2=Kettner |first3=Wayne |last3=O'Brien |date=2012| publisher=IBM Redbooks }}

  • The APAR may result in an "APAR fix."
  • a permanent correction called a PTF.

The focus of the "APAR fix" is "to rectify the problem as soon as possible"{{cite web |title=Diff between PTF, APAR, INTERMFIX |author=Mehdi Salebi |url=http://unix.ittoolbox.com/groups/technical-functional/ibm-aix-l/diff-between-ptfaparintermfix-4353121 |date=August 7, 2011}} whereas the PTF "is a tested APAR... The PTF 'closes' the APAR. " Prior to that, an APAR is "a problem with an IBM program that is formally tracked until a solution is provided.”{{cite web |website=destinationz.org (MSP TechMedia) |author=Gabe Goldberg |date=June 12, 2013 |title=IBM's APAR process provides the tools for dealing with software issues |url=http://www.destinationz.org/Mainframe-Solution/Systems-Administration/APAR-Process-Provides-Tools-to-Deal-With-Software-|archive-url=https://web.archive.org/web/20140401090011/http://destinationz.org/Mainframe-Solution/Systems-Administration/APAR-Process-Provides-Tools-to-Deal-With-Software-|url-status=usurped|archive-date=April 1, 2014}}

Humor

Customers sometimes explain the acronym in a tongue-in-cheek manner as permanent temporary fix{{cite web |website=AcronymFinder.com |title=PTF - Permanent Temporary Fix (humor) |url=https://www.acronymfinder.com/Permanent-Temporary-Fix-(humor)-(PTF).html}} or more practically probably this fixes, because they have the option to make the PTF a permanent part of the operating system if the patch fixes the problem. One explanation of Program Temporary Fix says it's temporary, just until the next ice age.

References

References

  1. "IBM Security: APARs explained".
  2. "Apply Program Temporary Fix (APYPTF)". IBM.
  3. "Installing cumulative PTF packages". IBM.
  4. "Fix groups (IBM i)". IBM.
  5. "z/OS SMP/E". IBM.
  6. "z/VM: VMSES/E Introduction and Reference". IBM.
  7. "Apply Program Temporary Fix (APYPTF)". IBM.
  8. "z/OS SMP/E User's Guide". IBM.
  9. "Fix groups (IBM i)". IBM.
  10. "Apply Program Temporary Fix (APYPTF)". IBM.
  11. "Fix groups (IBM i)". IBM.
  12. "Fix groups (IBM i)". IBM.
  13. "Virtual I/O Server overview".
  14. "Apply Program Temporary Fix (APYPTF)". IBM.
  15. "Fix groups (IBM i)". IBM.
  16. "Fix groups (IBM i)". IBM.
  17. "IBM Support – Authorized Program Analysis Reports".

::callout[type=info title="Wikipedia Source"] This article was imported from Wikipedia and is available under the Creative Commons Attribution-ShareAlike 4.0 License. Content has been adapted to SurfDoc format. Original contributors can be found on the article history page. ::

ibm-softwaresoftware-maintenance