QUERY LPARS

Read syntax diagramSkip visual syntax diagram Query LPARs CSSnn1REServed2CPCnameNETworkname
Notes:
  • 1 This operand is valid only when the logical channel-subsystem facility is installed on your machine.
  • 2 This operand is valid only when the logical-partition-configuration facility is installed on your machine.

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

  1. 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.
  2. For more information about logical partitions (LPARs), see z/VM: CP Planning and Administration.
  3. 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):

The response appears as follows when there is no logical channel-subsystem facility installed.
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):

The response appears as follows when the logical-channel-subsystem facility is installed and there are no reserved partition slots.
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):

The response appears as follows when both the logical-channel-subsystem facility and the logical-partition-configuration facility are installed, and there are reserved partition slots defined.
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):

To display information about the logical partitions that have access to channel-subsystem image 0 when the logical channel-subsystem facility is installed, enter the following:
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):

To display information about the logical partitions that have access to or are reserved in channel-subsystem image 0 when the logical-channel-subsystem facility and the logical-partition-configuration facility are installed, enter the following:
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):

To display information about the reserved logical partitions on your machine, enter the following:
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):

To display information about the reserved logical partitions in a channel-subsystem image, enter the following:
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):

If no logical partitions have access to the specified channel-subsystem image, the response appears as follows.
query lpars css 5
There are no partitions that have access to CSS 5.
Ready;

Response 9 (Query when no reserved partitions in system):

If no reserved logical partition slots are available on your machine, the response appears as follows.
query lpars reserved
There are no reserved partitions available on your machine.
Ready;

Response 10 (Query when no reserved partitions in CSS):

If no reserved logical partition slots are available in the specified channel-subsystem image, the response appears as follows.
query lpars css 5 reserved
There are no reserved partitions in CSS 5.
Ready;

Response 12 (No LPAR Data - Dynamic I/O not enabled):

If your logical partition is not enabled for dynamic I/O changes, the response appears as follows.
query lpars
No LPAR data is available.
Active partition: ZVMLPAR1
Ready;

Response 13 (CPC name):

To display the CPC name associated with your processor, enter the following:
query lpars cpcname
The CPC name for this processor is FSISKIS9.
Ready;

Response 14 (No CPC name):

If there is no CPC name associated with your processor, you would see:
query lpars cpcname
There is no CPC name assigned to this processor.
Ready;

Response 15 (Network name):

To display the network name associated with your processor, enter the following:
query lpars network
The network name assigned for this processor is IBM390PS.
Ready;

Response 16 (No Network name):

If there is no network name associated with your processor, you would see:
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.