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.
=================================================================
=================================================================
Listing the Devices in Your System (lscfg Command)
You use the lscfg command to display the name, location, and description
of each device found in the current configuration. The list is sorted
by device location.
For example, to list the devices configured in your system, at the
prompt, 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 CPU 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 information about a specific device, you can use the -l
flag. For example, to list the information on device sysplanar0, at
the prompt, enter:
lscfg -l sysplanar0
The system displays a message similar to the following:
DEVICE LOCATION DESCRIPTION
sysplanar0 00-00 CPU Planar
You can also use the lscfg command to display vital product data (VPD),
such as part numbers, serial numbers, and engineering change levels.
For some devices, the vital product data is collected automatically
and added to the system configuration. For other devices, the VPD
information is entered manually. An ME preceding the data signifies
that the data was entered manually.
For example, to list the devices configured in your system with vital
product data, at the prompt, 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 CPU Planar
Part Number.........342522
EC Level............254921
Serial Number.......353535
fpa0 00-00 Floating Point Processor
mem0 00-0A Memory Card
EC Level............990221
.
.
.
See the lscfg command in the AIX Version 4 Commands Reference for
the exact syntax.