[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 2
diag Command
Purpose
Performs hardware problem determination.
Syntax
diag [ [ -a ] | [ -s [ -c ] ] [ -E days] [ -e] | [ -d Device [ -c ] [ -v ]
[ -e ] [ -A ] ] | [ -B [ -c ] ] |
[ -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 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
- 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. 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:
- 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. 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
/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 ]