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
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 (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
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 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.

-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

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