DEFINE LPAR
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
- 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.
- 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.