[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Commands Reference, Volume 2

diag Command

Purpose

Performs hardware problem determination.

Syntax

diag [ [ -a] | [-s] | [ [-d Device] [-v] [-c ] [-e] [-A] [-E days] ] | [-B] | [-T taskname] [-S testsuite]

Description

The diag command is the starting point to run a wide choice of tasks and service aids. Most of the tasks/service aids are platform specific. The following tasks and service aids are available:

You can use the Web-based System Manager Devices application (wsm devices fast path) to run this command. You could also use the System Management Interface Tool (SMIT) smit diag fast path to run this command.

Flags

Note: Most users do not need to use any flags since the diag command is a menu driven program.
-A Specifies Advanced mode.
-a Processes any changes in the hardware configuration by asking if missing resources have been removed, turned off, and so on.
-B Instructs diagnostics to run the base system test. Error log analysis will also be done on areas in the base system that supports error log analysis.
-c Indicates that the machine will not be attended. No questions will be asked. Results are written to standard output.
-d Device Specifies the device to run diagnostics on.
-E Days Specifies the number of days to use when searching the error log during Run Error Log Analysis.
-e Performs error log analysis if supported on the selected device. No tests are performed. Must be used with the -d flag.
-S testsuite Indicates a particular Test Suite of devices to test:
  1. Base System
  2. I/O Devices
  3. Async Devices
  4. Graphic Devices
  5. SCSI Devices
  6. Storage Devices
  7. Commo Devices
  8. Multimedia Devices
-s Runs diagnostics on all resources.
-T taskname Fastpath to specific task to run. Current fastpath tasks are the following:
format - Format Media Task
certify - Certify Media Task
download - Download Microcode Task
disp_mcode - Display Microcode Level Task
chkspares - Spare Sector Availability Task
identify - PCI RAID Physical Disk Identify Task

Note: Tasks are platform and device dependent. Some tasks may not be available on the system.

-v Runs diagnostics in System Verification Mode, no error log analysis performed. The default is Problem Determination mode that tests the device and runs error log analysis.

Security

Access Control: Only the root user can run this command.

Privilege Control: System group.

Examples

To run diagnostics on the scdisk0 device, without questions, enter:

diag -d scdisk0 -c

File

/usr/sbin/diag Contains the diag command.

Related Information

Symptom Index in AIX Version 4.3 Problem Solving Guide and Reference.

Setting up and running Web-based System Manager in AIX Version 4.3 System Management Guide: Operating System and Devices.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]