Authorized Program Analysis Report

Last updated

An APAR (Authorized Program Analysis Report) [1] (pronounced A-PAR, rhymes with far) is an IBM designation of a document intended to identify situations that could result in potential problems. It also serves as a request for the correction of a defect in current releases of IBM-supplied programs.

Contents

The Process

"Occasionally" [2] IBM software has a bug.

Once it has been ascertained that the situation has not been caused by problems in third-party hardware or software or the user's 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. In addition to confirming the existence of an issue, APARs 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. [2]

Documenting the problem

IBM has a program to facilitate documenting the problem. [3] [4]

Solution levels

There are at least 2 levels of fix: [5]

Program temporary fix or Product temporary fix (PTF), sometimes depending on date, is the standard IBM terminology for a single bug fix, or group of fixes, distributed in a form ready to install for customers. Customers sometime explain the acronym in a tongue-in-cheek manner as permanent temporary fix 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.

A PTF is a permanent correction with respect to the VRM (Version, Release, Modification) level of the product to which it is applicable, and is a temporary fix in the sense that the problem correction will temporarily be available as a permanent fix, and later will be incorporated into the product base code, and will thereby no longer be a fix, although the associated PTF and/or APAR numbers will, as a rule, be included in the source documentation associated with the ensuing base code update.

System Improvement/Difficulty Report

SIDR was Xerox's acronym, covering APAR and PTF.

The acronym referred to: System Improvement / Difficulty Report. [9]

System Improvement Request

SIR (System Improvement Request) is a terminology that Digital Equipment Corporation used, much as Xerox used SIDR. [10]

Digital Equipment Corporation, using the trademark Digital, was a major American company in the computer industry from the 1950s to the 1990s.

See also

Related Research Articles

A software bug is an error, flaw, failure or fault in a computer program or system that causes it to produce an incorrect or unexpected result, or to behave in unintended ways. The process of finding and fixing bugs is termed "debugging" and often uses formal techniques or tools to pinpoint bugs, and since the 1950s, some computer systems have been designed to also deter, detect or auto-correct various computer bugs during operations.

z/OS 64-bit operating system for IBM mainframes

z/OS is a 64-bit operating system for IBM mainframes, produced by IBM. It derives from and is the successor to OS/390, which in turn followed a string of MVS versions. Like OS/390, z/OS combines a number of formerly separate, related products, some of which are still optional. z/OS offers the attributes of modern operating systems but also retains much of the functionality originating in the 1960s and each subsequent decade that is still found in daily use. z/OS was first introduced in October 2000.

OS/390 is an IBM operating system for the System/390 IBM mainframe computers.

Xerox Star Workstation

The Star workstation, officially named Xerox 8010 Information System, was the first commercial system to incorporate various technologies that have since become standard in personal computers, including a bitmapped display, a window-based graphical user interface, icons, folders, mouse (two-button), Ethernet networking, file servers, print servers, and e-mail.

A workaround is a bypass of a recognized problem or limitation in a system. A workaround is typically a temporary fix that implies that a genuine solution to the problem is needed. But workarounds are frequently as creative as true solutions, involving outside the box thinking in their creation.

A software release life cycle is the sum of the stages of development and maturity for a piece of computer software: ranging from its initial development to its eventual release, and including updated versions of the released version to help improve software or fix software bugs still present in the software.

Software development is the process of conceiving, specifying, designing, programming, documenting, testing, and bug fixing involved in creating and maintaining applications, frameworks, or other software components. Software development is a process of writing and maintaining the source code, but in a broader sense, it includes all that is involved between the conception of the desired software through to the final manifestation of the software, sometimes in a planned and structured process. Therefore, software development may include research, new development, prototyping, modification, reuse, re-engineering, maintenance, or any other activities that result in software products.

IBM System/34

The IBM System/34 was an IBM midrange computer introduced in 1977. It was withdrawn from marketing in February 1984. It was a multi-user, multi-tasking successor to the single-user System/32. Most notably, it included two very different processors, one based on System/32 and the second based on older System/3. Like the System/32 and the System/3, the System/34 was primarily programmed in the RPG II language.

Interlisp is a programming environment built around a version of the programming language Lisp. Interlisp development began in 1966 at Bolt, Beranek and Newman in Cambridge, Massachusetts with Lisp implemented for the Digital Equipment Corporation (DEC) PDP-1 computer by Danny Bobrow and D. L. Murphy. In 1970, Alice K. Hartley implemented BBN LISP, which ran on PDP-10 machines running the operating system TENEX. In 1973, when Danny Bobrow, Warren Teitelman and Ronald Kaplan moved from BBN to the Xerox Palo Alto Research Center (PARC), it was renamed Interlisp. Interlisp became a popular Lisp development tool for artificial intelligence (AI) researchers at Stanford University and elsewhere in the community of the Defense Advanced Research Projects Agency (DARPA). Interlisp was notable for integrating interactive development tools into an integrated development environment (IDE), such as a debugger, an automatic correction tool for simple errors (via do what I mean software design, and analysis tools.

A patch is a set of changes to a computer program or its supporting data designed to update, fix, or improve it. This includes fixing security vulnerabilities and other bugs, with such patches usually being called bugfixes or bug fixes, and improving the functionality, usability or performance.

Code review is a software quality assurance activity in which one or several humans check a program mainly by viewing and reading parts of its source code, and they do so after implementation or as an interruption of implementation. At least one of the humans must not be the code's author. The humans performing the checking, excluding the author, are called "reviewers".

Software maintenance in software engineering is the modification of a software product after delivery to correct faults, to improve performance or other attributes.

A Fagan inspection is a process of trying to find defects in documents during various phases of the software development process. It is named after Michael Fagan, who is credited with being the inventor of formal software inspections.

A software review is "A process or meeting during which a software product is examined by a project personnel, managers, users, customers, user representatives, or other interested parties for comment or approval".

Apar may refer to:

A Supervisor Call instruction (SVC) is a hardware instruction in the System/360 family of IBM mainframe computers up to contemporary zSeries used to cause an interrupt to request a service from the operating system. The system routine providing the service is called an SVC routine. SVC is a specific implementation of a system call.

SMP/E "is a tool designed to manage the installation of software products on [a] z/OS system and to track the modifications" to those products.

CP-6 is a discontinued computer operating system developed by Honeywell, Inc. in 1976. It was a backward-compatible work-alike of the Xerox CP-V fully rewritten for Honeywell Level/66 hardware. CP-6 was a command line oriented system. A terminal emulator allowed use of PCs as CP-6 terminals.

ITIL, formerly an acronym for Information Technology Infrastructure Library, is a set of detailed practices for IT service management (ITSM) that focuses on aligning IT services with the needs of business.

References

  1. "Authorized program analysis reports".
  2. 1 2 "Issues with Cognos and other IBM software can arise from configuration errors, problems in third-party hardware or software, and occasionally, because of a bug in the IBM product itself." "IBM Support – Authorized Program Analysis Reports". AmitechSolutions.com. Archived from the original on 2017-12-08. Retrieved 2017-12-07.
  3. "An authorized program analysis report (APAR) is an IBM-supplied program that allows you to create a diskette file or a tape file. The file contains information from your system to help software service representatives to correct programming problems." "Using authorized program analysis reports".
  4. There is no date atop this document, which does not mention eMail options.
  5. "An APAR fix is usually replaced later by a permanent correction called a PTF." Ebbers, Mike; Kettner, John; O'Brien, Wayne; Ogden, Bill (2012). Introduction to the New Mainframe: z/OS Basics (PDF). ISBN   0738435341.
  6. "PTF - Permanent Temporary Fix (humor)". AcronymFinder.com.
  7. "Diff between PTF,APAR,INTERMFIX". August 7, 2011.
  8. Gabe Goldberg (June 12, 2013). "IBM's APAR process provides the tools for dealing with software issues". destinationz.org (MSP TechMedia).
  9. "Xerox Program Availability List" (PDF).
  10. "The Emacs text editing program for VAX/VMS". Tech Insider. October 1984. ... taken from VAX System Improvement Request F83-33. ... DEC should ...