[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 2

diag Command


Performs hardware problem determination.


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


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 Devices application in Web-based System Manager (wsm) to change device characteristics. You could also use the System Management Interface Tool (SMIT) smit diag fast path to run this command.


Note: Most users do not need to use any flags since the diag command is a menu driven program.
-A Specifies Advanced mode. Must also specify a device using the -d flag.
-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 are also 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. Must also use an optional flag that specifies a device to be tested, (d, B, s).
-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. This flag works with any other flag.
-e Performs error log analysis if supported on the selected device. No tests are performed. Must be used with the -d flag, otherwise the resource selection menu displays. If used with the -v flag, -v takes precedence and the -e flag is ignored. .
-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 Media Task
Certify Media Task
Download Microcode Task
Display Microcode Level Task
Spare Sector Availability Task
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. If used with the -e flag, the -v flag takes precedence and the -e flag is ignored. Must be used with the -d flag to specify a device to run diagnostics on.


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

Privilege Control: System group.


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

diag -d scdisk0 -c


/usr/sbin/diag Contains the diag command.

Related Information

For information on installing the Web-based System Manager, see Chapter 2: Installation and System Requirements in AIX 5L Version 5.2 Web-based System Manager Administration Guide.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]