diag Command

Purpose

Performs hardware problem determination.

Syntax

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:

Run Diagnostics
Display or Change Diagnostic Run Time Options
Display Service Hints
Display Previous Diagnostic Results
Display Hardware Error Report
Display Software Product Data
Display Configuration and Resource List
Display Hardware Vital Product Data
Display Resource Attributes
Change Hardware Vital Product Data
Format Media
Certify Media
Display Test Patterns
Local Area Network Analyzer
Add Resource to Resource List
Delete Resource from Resource List
SCSI Bus Analyzer
Download Microcode
Display or Change Bootlist
Periodic Diagnostics
Backup and Restore Media
Disk Maintenance
Configure Dials and LPFkeys
Add or Delete Drawer Config
Create Customized Configuration Diskette
Update Disk Based Diagnostics
Configure ISA Adapter
Operating System Shell Prompt (Online Service Mode only)
Display or Change Multiprocessor Configuration
- Enable and disable individual processors
Display or change BUMP Configuration
- Update the flash EPROM with a new binary image
- Display or change diagnostic modes
- Display or change remote phone numbers and modem configurations
Display or Change Electronic Mode Switch
Process Supplemental Media (Standalone Mode only)
Generic Microcode Download
Run Error Log Analysis
Service Aids for Use with Ethernet
Update System Flash in AIX® 5.1 and earlier (RSPC)
Configure Ring Indicate Power-On in AIX 5.1 and earlier (RSPC)
Configure Service Processor in AIX 5.1 and earlier (RSPC)
Save or Restore Service Processor Configuration in AIX 5.1 and earlier (RSPC)
Display Machine Check Error Log in AIX 5.1 and earlier (RSPC)
7135 RAIDiant Array Service Aids
SCSI Device Identification and Removal
SCSD Tape Drive Service Aid
Escon Bit Error Rate Service Aid
SSA Service Aid
PCI RAID Physical Disk Identify
Configure Ring Indicate Power On Policy (CHRP)
Configure Surveillance Policy (CHRP)
Configure Reboot Policy (CHRP)
Configure Remote Maintenance Policy (CHRP)
Save or Restore Hardware Management Policies (CHRP)
Display Firmware Device Node Information (CHRP)
Spare Sector Availability
Update System or Service Processor Flash (CHRP)
Display System Environmental Sensors (CHRP)
Display Checkstop Analysis Results
Analyze Adapter Internal Log
Log Repair Action
Flash SK-NET FDDI Firmware
Display Microcode Level

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.

Flags

Note: Most users do not need to use any flags since the diag command is a menu driven program.

Item	Description
-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. In AIX 5.2 and higher, missing resources (indicated by an 'M') and missing resource paths (indicated by a 'P') are integrated into the diagnostic resource selection list.
-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: Base System I/O Devices Async Devices Graphic Devices SCSI Devices Storage Devices Commo Devices Multimedia Devices
-L pending \| complete	Log Repair Action for a resource specified with the -d and -c options. Use pending if the part has been replaced, but it is not yet known if this part will remain in the system. Use complete if the part has been replaced and it is known that this part will remain in the system.
-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 identifyRemove Hot Plug 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.

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

Item	Description
/usr/sbin/diag	Contains the diag command.