QUERY LPARS
Authorization
Privilege Class: B
Purpose
Use QUERY LPARS to list all the logical partitions (LPARs) defined on your machine and to display which LPAR is currently active, to list all of the LPARs that have access to a particular channel-subsystem image, to list all of the reserved LPARs in the system or in a particular channel-subsystem image, to display the network name associated with your processor, or to display the CPC name associated with your processor.
Operands
- CSS nn
- is the channel-subsystem ID for which you want partition access information. The variable
nn must be a 1- to 2-digit hexadecimal number between X'00' and
X'0F'. Your machine is likely to support less than 16 channel-subsystem images. Note: This operand requires that the logical channel-subsystem facility be installed.
- REServed
- indicates that only reserved partition slots be displayed. Note: This operand requires that the logical-partition-configuration facility be installed.
- CPCname
- indicates that the CPC name associated with your processor should be displayed.
- NETworkname
- indicates that the network name associated with your processor should be displayed.
Usage Notes
- If your system is not enabled for dynamic I/O capabilities, then this command will not complete successfully. However, it will issue a response that indicates the name of the logical partition where your system is running.
- For more information about logical partitions (LPARs), see z/VM: CP Planning and Administration.
- The network name and CPC name that can be displayed by this command are user-defined names that are created and modified by the Hardware Management Console (HMC) and the Service Element (SE).
Responses
Response 1 (non-LCSS system):
query lpars
Partitions on your machine:
Active partition: ZVMLPAR1 Partition number: 1
Partition name: ZVMLPAR2 Partition number: 2
Partition name: ZOSLPAR1 Partition number: 3
Partition name: ZOSLPAR2 Partition number: 4
Ready;
This response tells you that you have 4 partitions and that the partition processing this command is
ZVMLPAR1. Response 2 (LCSS system):
query lpars
Partitions on your machine:
Active partition: ZVMLPAR1 CSS: 0 MIF-ID: 1
Partition name: ZOSLPAR1 CSS: 0 MIF-ID: 2
Partition name: ZVMLPAR2 CSS: 1 MIF-ID: 1
Partition name: ZOSLPAR2 CSS: 1 MIF-ID: 2
Ready;
This
response tells you that you have 4 partitions, two that have access to channel-subsystem image 0 and
two that have access to channel-subsystem image 1. The partition processing this command is
ZVMLPAR1.Response 3 (LCSS system with reserved partitions):
query lpars
Partitions on your machine:
Active partition: ZVMLPAR1 CSS: 0 MIF-ID: 1
Partition name: ZOSLPAR1 CSS: 0 MIF-ID: 2
Reserved: * CSS: 0 MIF-ID: 4
Partition name: ZVMLPAR2 CSS: 1 MIF-ID: 1
Partition name: ZOSLPAR2 CSS: 1 MIF-ID: 2
Reserved: * CSS: 1 MIF-ID: 3
Ready;
This response tells you that you have 4 partitions, two that have access to channel-subsystem image 0 and two that have access to channel-subsystem image 1. The response also tells you that you have two reserved partition slots, one available in channel-subsystem image 0 and one available in channel-subsystem image 1. The partition processing this command is ZVMLPAR1.
Response 4 (Query for a defined CSS):
query lpars css 0
Partitions with access to CSS 0:
Active partition: ZVMLPAR1 CSS: 0 MIF-ID: 1
Partition name: ZOSLPAR1 CSS: 0 MIF-ID: 2
Ready;
This response tells you that you have 2 partitions that have access to channel-subsystem image 0.
The partition processing this command is ZVMLPAR1. Response 5 (Query for a defined CSS with reserved partitions):
query lpars css 0
Partitions with access to CSS 0:
Active partition: ZVMLPAR1 CSS: 0 MIF-ID: 1
Partition name: ZOSLPAR1 CSS: 0 MIF-ID: 2
Reserved: * CSS: 0 MIF-ID: 4
Ready;
This
response tells you that you have 2 partitions that have access to channel-subsystem image 0 and that
you have 1 reserved partition slot available in channel-subsystem image 0. The partition processing
this command is ZVMLPAR1.Response 6: (Reserved partitions in LCSS system):
query lpars reserved
Reserved partitions on your machine:
Reserved: * CSS: 0 MIF-ID: 4
Reserved: * CSS: 1 MIF-ID: 3
Ready;
This
response tells you that you have 2 reserved partition slots available on your machine, one in
channel-subsystem image 0 and one in channel-subsystem image 1.Response 7: (Reserved partitions in a CSS):
qyery lpars css 1 reserved
Reserved partitions in CSS1:
Reserved: * CSS: 1 MIF-ID: 3
Ready;
This
response tells you that you have 1 reserved partitions slot available in channel-subsystem image
1.Response 8 (Query for an undefined CSS):
query lpars css 5
There are no partitions that have access to CSS 5.
Ready;
Response 9 (Query when no reserved partitions in system):
query lpars reserved
There are no reserved partitions available on your machine.
Ready;
Response 10 (Query when no reserved partitions in CSS):
query lpars css 5 reserved
There are no reserved partitions in CSS 5.
Ready;
Response 12 (No LPAR Data - Dynamic I/O not enabled):
query lpars
No LPAR data is available.
Active partition: ZVMLPAR1
Ready;
Response 13 (CPC name):
query lpars cpcname
The CPC name for this processor is FSISKIS9.
Ready;
Response 14 (No CPC name):
query lpars cpcname
There is no CPC name assigned to this processor.
Ready;
Response 15 (Network name):
query lpars network
The network name assigned for this processor is IBM390PS.
Ready;
Response 16 (No Network name):
query lpars network
There is no network name assigned to this processor.
Ready;
Messages
- HCP003E Invalid option - command contains extra option(s) starting with option
- HCP1006E Command processing cannot complete because the system does not support the logical-channel-subsystem facility.
- HCP1006E Command processing cannot complete because the system does not support the logical-partition-configuration facility.
- HCP6809E Dynamic I/O configuration is not supported.