[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 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

  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.


[ Previous | Next | Contents | Glossary | Home | Search ]