About This Guide

This publication describes the hardware diagnostic subsystem for the RS/6000 machines.

Who Should Use This Guide

The information in this publication is needed by developers of diagnostic applications, application test units, device-driver test units, the diagnostic controller, and the diagnostic user interface.

How to Use This Guide

This section describes the contents of this guide, the highlighting conventions, and related publications.

Overview of Contents

This guide contains the following chapters:

"Introduction," provides an overview of the diagnostic architecture structure and strategy.
"Operating Environments," describes the various environments that Diagnostics is supported in.
"Diagnostic Components," provides detailed descriptions of each of the components that make up the Diagnostic Subsystem. Topics include the Diagnostic Controller, Diagnostic Application, Application Test Units, Diagnostic Libraries, Diagnostic Object Classes, and Diagnostic Header Files.
"Diagnostic Features," provides information on special features included in the Diagnostic Subsystem. Topics covered are Missing Options Resolution, Error Log Analysis, Periodic Diagnostics, Diagela, and Loop Mode Testing.
"Packaging," provides information on how the Diagnostic Subsystem is packaged. Topics covered are Hardfile, CDROM, and Supplemental Media".
"Debugging Hints," provides information on debugging tricks when running from hardfile or standalone media.
"Code Examples," provides some code examples for application test units and diagnostic applications. These are skeleton code examples, to be used for reference only.

Highlighting

The following highlighting conventions are used in this guide:

Bold	Identifies commands, subroutines, keywords, files, structures, directories, and other items whose names are predefined by the system.
italics	Identifies parameters whose actual names or values are to be supplied by the user.
monospace	Identifies examples of specific data values, examples of text similar to what you might see displayed, examples of portions of program code similar to what you might write as a programmer, messages from the system, or information you should actually type.

ISO 9000

ISO 9000 registered quality systems were used in the development and manufacturing of this product.

Related Publications

The following publications should be referenced if the diagnostic application is being developed on a 4.2 version of AIX.

AIX Version 4 General Programming Concepts: Writing and Debugging Programs, order number SC23-2533.
AIX Version 4 Kernel Extensions and Device Support Programming Concepts, order number SC23-2611.
AIX Version 4 Commands Reference, order number SBOF-1851.
AIX Version 4 Writing a Device Driver, order number SC23-2593.
POWERstation and POWERserver Common Diagnostics Information Manual, order number SA23-2765.
AIX Version 4 Problem Solving Guide and Reference, order number SC23-2606.
AIX Version 4 Technical Reference, order number SBOF-1852.

Prerequisite Software for Diagnostics Version 4

IBM AIX Version 4.3 with bos.diag 4.3.0.0 Package.

Ordering Publications

You can order publications from your sales representative or from your point of sale.

Use AIX and Related Products Documentation Overview for information on related publications and how to obtain them. The AIX and Related Products Documentation Overview is available:

On the World Wide Web. Using your web browser, go to the IBM Home Page by opening the following URL:
```
http://www.ibm.com/
```
On the IBM Home Page, search on "AIX and Related Products Documentation Overview" to access the publication.
In the Hypertext Information Base Library Version 1 for AIX. This online documentation is designed for use with the InfoExplorer hypertext retrieval system.
As a hardcopy publication; use order number SC23-2456.

[ Previous | Next | Contents | Home | Search ]