lscfg Command

Purpose

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

Syntax

To Display Specific Data on all Systems

lscfg [ -v ] [ -p ] [ -s ] [ -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. It will not display any device that has been marked missing in the Customized Device Object Class. 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 Common Hardware Reference Platform (CHRP) system from the open firmware device tree.

Item Description
-l Name Displays device information for the named device.
-p Displays the platform-specific device information. This flag only applies to AIX® 4.2.1 or later.
-v Displays the VPD found in the Customized VPD object class. Also, on AIX 4.2.1 or later, displays platform specific VPD when used with the -p flag.
-s Displays the device description on a separate line from the name and location.

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 the machine:
    +/- = Added or deleted from Resource List.
    *   = Diagnostic support not available.
    
    
    + indicates the resource has been added to the Diagnostic Resource List. The resource is
    added to the Diagnostic Resource list by default when the diagnostic fileset is installed. A
    resource must be in the Diagnostic Resource List before diagnostics tasks can be
    performed on the resource. 
    
    - indicates the resource was deleted from the Diagnostic Resource List. 
    
    The resource can be added or deleted from the Resource List by running the diag
    command, and using the Task Selection menu to select either Add Resource to Resource
    List, or Delete Resource from Resource List. 
    
    Diagnostic support for a resource, indicated by the + character is not necessarily
    inclusive of all diagnostic tasks. Some resources are only supported with a subset of
    diagnostic task, and that subset might or might not include the Run Diagnostics Task. 
    
      Model Architecture: chrp
      Model Implementation: Multiple Processor, PCI bus
    
    + sys0                             System Object
    + sysplanar0                       System Planar
    + mem0                             Memory
    + L2cache0                         L2 Cache
    + proc0            U1.1-P1-C1      Processor
    * pci3             U0.2-P1         PCI Bus
    + scsi0            U0.1-P1/Z1      Wide/Ultra-2 SCSI I/O Controller
    + rmt0             U1.1-P1/Z1-A3   SCSI 4mm Tape Drive (12000 MB)
    + cd0              U1.1-P1/Z1-A5   SCSI Multimedia CD-ROM Drive (650 MB)
    + hdisk0           U1.1-P1/Z1-A9   16 Bit LVD SCSI Disk Drive (4500 MB)
    + fd0              U0.1-P1-D1      Diskette Drive
    ..
    ..
  2. To display the system configuration with the device description on a separate line, enter:
             lscfg  -s
    The system displays a message similar to the following:
    INSTALLED RESOURCE LIST
    The following resources are installed on the machine:
    +/- = Added or deleted from Resource List.
    *   = Diagnostic support not available.
            
      Model Architecture: chrp
      Model Implementation: Multiple Processor, PCI bus
            
    + indicates the resource has been added to the Diagnostic Resource List. The resource is
    added to the Diagnostic Resource list by default when the diagnostic fileset is installed. A
    resource must be in the Diagnostic Resource List before diagnostics tasks can be
    performed on the resource. 
    
    - indicates the resource was deleted from the Diagnostic Resource List. 
    
    The resource can be added or deleted from the Resource List by running the diag
    command, and using the Task Selection menu to select either Add Resource to Resource
    List, or Delete Resource from Resource List. 
    
    Diagnostic support for a resource, indicated by the + character is not necessarily
    inclusive of all diagnostic tasks. Some resources are only supported with a subset of
    diagnostic task, and that subset might or might not include the Run Diagnostics Task. 
    
    + sys0             
            System Object
    + sysplanar0                       
            System Planar
    + mem0                             
            Memory
    + L2cache0                         
            L2 Cache
    + proc0            U5734.100.1234567-P1-C1
            Processor
    + proc1            U5734.100.1234567-P1-C2
            Processor
    +hdisk0            U5734.100.1234567-P1-D9
          16 Bit LVD SCSI Disk Drive (4500 MB)
    +fd0               U5734.100.1234567-P1-D1
          Diskette Drive
    
    ..
    ..
  3. To display the name, location, and description for devices specified by the logical name proc without VPD, enter:
    lscfg -lproc\*
    The system displays information for all devices with logical names beginning with proc, as follows:
      proc0            U1.1-P1-C1  Processor
      proc1            U1.1-P1-C1  Processor
      proc2            U1.1-P1-C1  Processor
      proc3            U1.1-P1-C1  Processor
      proc4            U1.1-P1-C2  Processor
      proc5            U1.1-P1-C2  Processor
      proc6            U1.1-P1-C2  Processor
      proc7            U1.1-P1-C2  Processor
  4. To display the VPD for a specific device specified by the logical name ent0, enter:
             lscfg  -v -l ent0
    The system displays the following:
     ent0             U0.1-P1-I2/E1   Gigabit Ethernet-SX PCI Adapter (14100401)
    
            Network Address.............0004AC7C00C4
            Displayable Message.........Gigabit Ethernet-SX PCI Adapter (14100401)
    
            EC Level....................E77998
            Part Number.................07L8916
            FRU Number..................07L8918
            Device Specific.(YL)........U0.1-P1-I2/E1
  5. To display the VPD in the open firmware device tree for the corresponding node to the ent0 device, enter:
     lscfg -vp -lent0
    The following is displayed:
      ent0             U0.1-P1-I2/E1  Gigabit Ethernet-SX PCI Adapter (14100401)
    
            Network Address.............0004AC7C00C4
            Displayable Message.........Gigabit Ethernet-SX PCI Adapter (14100401)
    
            EC Level....................E77998
            Part Number.................07L8916
            FRU Number..................07L8918
            Device Specific.(YL)........U0.1-P1-I2/E1
    
    
      PLATFORM SPECIFIC
    
      Name:  ethernet
        Model:  Galaxy, EtherLink 1000-SX-IBM
        Node:  ethernet@1
        Device Type:  network
        Physical Location: U0.1-P1-I2/E1

Files

Item Description
/usr/sbin/lscfg Contains the lscfg command.