diag Command

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:

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
AIX 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 (RSPC)
Configure Ring Indicate Power-On (RSPC)
Configure Service Processor (RSPC)
Save or Restore Service Processor Configuration (RSPC)
Display Machine Check Error Log (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
7318 Serial Communication Network Server
Update System or Service Processor Flash (CHRP)
Display System Environmental Sensors (CHRP)
Display Checkstop Analysis Results
Analyze Adapter Internal Log
Flash SK-NET FDDI Firmware
Display Microcode Level

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:

Base System
I/O Devices
Async Devices
Graphic Devices
SCSI Devices
Storage Devices
Commo Devices
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.