lscfg

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.

Flags

-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

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

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

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

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

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

6.	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/lpp/msg/En_US/lscfg.cat	Contains the message catalog file.

/usr/sbin/lscfg	Contains the lscfg command.

Related Information

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