DEFINE LPAR

Read syntax diagramSkip visual syntax diagram DEFine LPAR pname CSS 0CSS nn MIF_id mm

Authorization

Privilege Class: B

Purpose

Use the DEFINE LPAR command to define a logical partition to the I/O configuration.

Operands

pname
specifies the name of the logical partition to be defined. pname must be a 1-character to 8-character alphanumeric string.
Note: The first character of pname must be alphabetic and the following names cannot be used: PHYSICAL, REC, SYSTEM, PRIMnnn (where nnn are decimal digits).
CSS nn
is the channel-subsystem ID associated with the logical partition that is being defined. The variable nn must be a 1-digit to 2-digit hexadecimal number between X'00' and X'0F.'
MIF_id mm
is the MIF-ID within the specified CSS associated with the logical partition that is being defined. The variable mm must be a 1-digit to 2-digit hexadecimal number between X'01' and X'0F.'

Usage Notes

  1. The specified CSS and MIF-ID combination must be an available reserved slot in the configuration in order for a logical partition to be defined to it. An available reserved logical partition slot is created by:
    • Specifying it with the RESOURCE statement in the IOCP file.
    • Deleting a logical partition definition with the DELETE LPAR command.
  2. This command requires that the logical-channel-subsystem facility and logical-partition-configuration facility be installed on your system.

Examples

To define logical partition VMSYSONE to CSS 1 with a MIF-ID of 3, enter the following:
define lpar vmsysone css 1 mif 3
Logical partition configuration change completed successfully
Ready;

Messages

For the list of general messages for the DEFINE command, see Messages.