lscfg Command

Commands Reference, Volume 3

lscfg Command

Purpose

Displays configuration, diagnostic, and vital product data (VPD) information about the system.

Syntax

To Display Specific Data on all Systems

lscfg [ -vp ] [ -l Name ]

To Display Specific Data on a RSPC System

lscfg [ -rv ] | [ [ -r ] | [ -v ] [ -l Name ] ]

Description

If you run the lscfg command without any flags, it displays the name, location, and description of each device found in the current Customized VPD object class that is a child device of the sys0 object. The list is sorted by parent, child, and device location. Information on a specific device can be displayed with the -l flag.

Use the lscfg command to display vital product data (VPD) such as part numbers, serial numbers, and engineering change levels from either the Customized VPD object class or platform specific areas. Not all devices contain VPD data.

VPD data that is preceded by ME signifies that the VPD data was entered manually using a diagnostic service aid. For some devices, the vital product data is collected automatically from the devices through methods and added to the Customized VPD object class.

If you run the lscfg command with the -p flag, it displays device information stored in the platform specific data areas. When used with the -v flag, VPD data stored for these devices is also displayed. This information is obtained on a ISA bus-based (rspc) system from residual data or the open firmware device tree. This information is obtained on a Common Hardware Reference Platform (CHRP) system from the open firmware device tree.

-l Name	Displays device information for the named device.
-p	Displays the platform-specific device information. This flag only applies to AIX Version 4.2.1 or later.
-r	Displays the platform-specific device information found in residual data only on rspc systems.
-v	Displays the VPD found in the Customized VPD object class. Also, on AIX Version 4.2.1 or later, displays platform specific VPD when used with the -p flag.

Examples

To display the system configuration, enter:

lscfg

The system displays a message similar to the following:

INSTALLED RESOURCE LIST
 
The following resources are installed on your machine. 
 
+/- = Added/Deleted from Diagnostic Test List. 
*   = NOT Supported by Diagnostics. 
   
+       sysplanar0       00-00           System Planar
+       fpa0             00-00           Floating Point Processor
+       mem0             00-0A           Memory Card
+       mem1             00-0B           Memory Card
  
+       ioplanar0        00-00           I/O Planar
*       f2bus0           00-00           Micro Channel Bus
+       rs2320           00-01           RS232 Card
+       tty0             00-01-0-01      RS232 Card Port
-       tty1             00-01-0-02      RS232 Card Port
        ..
        ..
        ..

To display the name, location, and description for devices specified by the logical name mem without VPD, enter:
```
lscfg -l mem\*
```
The system displays information for all devices with logical names beginning with mem, as follows:
```
Device           Location        Description 
 
mem0             00-0A           Memory Card
mem1             00-0B           Memory Card
```

To display the VPD for all physical devices in the Customized database, enter:

lscfg -v

The system displays a message similar to the following:

INSTALLED RESOURCE LIST WITH VPD
 
The following devices are installed in your system. 
 
sysplanar0     00-00       System Planar
 
        Part Number.........342522
        EC Level............254921
        Serial Number.......353535
 
fpa0    00-00    Floating Point Processor
mem0    00-0A    Memory Card
 
        EC Level............990221
..
..

To display the VPD for a specific device specified by the logical name mem0, enter:

lscfg -l mem0 -v

The system displays information for the device mem0, as follows:

Device          Location         Description
 
mem0            00-0A            Memory Card
 
        Device Specific (Z3)...........04
        EC Level.......................00
        Device Specific (Z0)...........00
        Device Specific (Z1)...........00
        Device Specific (Z2)...........01
        Size...........................64

To display the VPD in residual data for a specific device specified by the logical name procF0 enter:

lscfg -p -l procF0 
 
procF0 
 
   Part Number                       xxxxxxx
   EC Level                          xxxxxxx
   Serial Number                     xxxxxxx
   FRU Number                        xxxxxxx
   Device Specific (ZA)              xxxxxxx
   Displayable Message               Processor
   Device Specific (PL)              xxxxxxx
   Device Specific (RM)              xxxxxxx
   ROS Level and ID                  xxxxxxx

To display the VPD in open firmware device tree for the corresponding node to the sysplanar0 device, enter:

lscfg -pv1 sysplanar0
 
Device          Location         Description
 
sysplanar0      00-00             System Planar
 
Platform Specific
 
Name:     xxxxxxx
  Model:     xxxxxxx
  Nodel:    /
  Physical location:   L1
  Device type:  xxxx
 
   System:
     Machine/Cabinet Serial No.      xxxxxxx
     Machine Type/Model              xxxxxxx
     Version                         xxxxxxx
   I/O Planar:
     Part Number                     xxxxxxx
     EC Level                        xxxxxxx
     Serial Number                   xxxxxxx
     FRU Number                      xxxxxxx
     Manufacture ID                  xxxxxxx
     Version                         xxxxxxx
   System Planar:
     Part Number                     xxxxxxx
     EC Level                        xxxxxxx
     Serial Number                   xxxxxxx
     FRU Number                      xxxxxxx
     Manufacture ID                  xxxxxxx
     Version                         xxxxxxx
     Product Specific (ZM)           xxxxxxx

Files

/usr/sbin/lscfg

Contains the lscfg command.

Related Information

The lsattr command, lsconn command, lsdev command, lsparent command.