IBM AS/400e User manual

AS/400e
Logical Partitions:
Managing


AS/400e
Logical Partitions:
Managing


© Copyright International Business Machines Corporation 1998,2000. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.

Contents
Part 1. Managing logical partitions.......................1
Chapter 1. Controlling logical partitions with DST and SST ................3
Starting SST and DST for logical partitions .......................4
Chapter 2. Displaying and printing logical partition information ..............7
Displaying logical partition status ...........................7
Displaying logical partition processing configuration ....................8
Displaying allocated I/O resources for logical partitions ...................9
Displaying available I/O resources for logical partitions...................10
Displaying system I/O resources for logical partitions ...................10
Displaying logical partition release levels ........................11
Displaying communication options for logical partitions...................12
Displaying reference code history for secondary partitions .................12
Printing system configuration for logical partitions.....................13
Chapter 3. Restarting and powering down a system with logical partitions .........15
Changing logical partition power schedule .......................15
Powering down a system with logical partitions .....................15
Restarting a system with logical partitions .......................16
Changing operating mode for a logical partition .....................17
Changing the IPL source for a logical partition ......................18
Restarting a secondary partition on system IPL .....................18
Holding a secondary partition from restarting on system IPL.................19
Chapter 4. Changing logical partition processing resources ...............21
Changing logical partition interactive performance ....................21
Changing logical partition main storage ........................22
Changing logical partition processors .........................23
Chapter 5. Changing logical partition configuration...................25
Changing a secondary partition name .........................25
Changing bus ownership type for logical partitions ....................25
Changing and switching I/O resources.........................26
Removing I/O resources for logical partitions .....................26
Adding I/O resources for logical partitions ......................28
Switching I/O processors for logical partitions .....................28
Changing a logical partition load source resource.....................29
Changing a logical partition console resource ......................30
Selecting or changing an alternate IPL resource for logical partitions .............30
Selecting or changing default electronic customer support resource for logical partitions ......31
Installing new hardware for logical partitions ......................31
Adding a new logical partition ............................31
Changing communication options for logical partitions ...................34
Deleting a secondary partition ............................34
Chapter 6. Managing security for logical partitions ...................35
Chapter 7. Installing program temporary fixes on a system with logical partitions.......37
© Copyright IBM Corp. 1998,2000 iii
||
||
||
||

iv AS/400e: Logical Partitions: Managing

Part 1. Managing logical partitions
When you create logical partitions, you essentially create two or more smaller logical AS/400 systems.
Each logical partition has its own processors, input/output (I/O) devices, Licensed Internal Code, operating
system, and optional software applications.
For these reasons most of the tasks you perform on each individual logical partition are the same as on a
system without logical partitions. In other words, you should approach each logical partition as an
independent system.
The following list contains the information and tasks you will need to manage a system with logical
partitions:
vControl your logical partitions by using dedicated service tools (DST) or system service tools (SST).
vDisplay and print logical partition information.
vRestart and power down your partitioned system (initial program loads).
vChange processing resources to improve system performance.
vChange the configuration of a logical partition.
vManage security on your system.
vInstall program temporary fixes to keep your software current.
For more information on logical partitions, go to Learning about Logical Partitions. Go to the Backup and
Recovery pages for information on backing up your system.
Refer to the book, AS/400 Basic System Operation, Administration, and Problem Handling for more
information about starting and managing your system.
© Copyright IBM Corp. 1998,2000 1

2AS/400e: Logical Partitions: Managing

Chapter 1. Controlling logical partitions with DST and SST
On a system without logical partitions, you can use the control panel to perform many tasks. However, for
systems with logical partitions, secondary partitions do not have physical control panels. To control your
logical partitions you can use menu options in dedicated service tools (DST) and system service tools
(SST). These menu options act as a virtual control panel.
Security considerations
You can restart and reconfigure logical partitions from the primary partition by using DST. Therefore, an
unqualified person with access to DST could unintentionally cause severe damage to your system. For this
reason you should limit the number of people who have the password to DST and who have access to the
control panel.
DST versus SST
You control logical partitions essentially the same way in DST and SST. You can perform some logical
partition configuration actions only in DST. However, since SST is easier to access than DST, you should
use SST whenever possible.
To use SST or DST go to Starting SST and DST.
This table describes the capabilities that are available to logical partitions from the Work with system
partitions display (option 11, DST), or (option 5, SST).
Primary Partition Secondary Partition
DST Display all logical partition information
Change IPL status on primary and secondary logical
partitions
Change operating mode on primary and secondary logical
partitions
Perform main store dumps
Power on or off primary and secondary logical partitions
Change processing and I/O configuration of primary and
secondary logical partitions
Perform recovery functions for secondary partitions
Create and delete secondary partitions
Display its own logical partition
information
Perform limited recovery functions on
itself
When the secondary partition is not in
secure mode it can:
vChange IPL status on itself
vChange operating mode on itself
vPerform main store dumps on itself
vPower itself off
SST Display all logical partition information
Change I/O configuration of primary and secondary partitions
When the system is not in secure mode it can:
vChange operating mode
vChange logical partition status
vPerform main store dumps
vPower on and off secondary partitions
vForce DST on the primary partition or secondary partitions
Display its own logical partition
information
When the secondary partition is not in
secure mode it can:
vChange IPL status on itself
vChange operating mode on itself
vPerform main store dumps for itself
vPower itself off.
vForce DST on itself
© Copyright IBM Corp. 1998,2000 3
|

Starting SST and DST for logical partitions
Starting SST on the primary partition or a secondary partition
You can start system service tools (SST) by typing the start system service tools (STRSST) command and
pressing Enter at a command line. You can start SST on any primary or secondary partition workstation.
You must have proper authority to use this command.
Starting DST on the primary partition
When you start dedicated service tools (DST), make sure that the primary partition console is at a sign on
display to prevent jobs from ending abnormally. As an alternative, you can perform the following steps on
the logical partition. You only need to perform these steps once since they system maintains changes
across initial program loads (IPLs):
1. At a command line, type the Work with System Value (WRKSYSVAL) command.
2. Set the QDEVRCYACN system value to *ENDJOBNOLIST or *ENDJOB.
3. Set the QDSCJOBITV system value to 5 minutes.
For more information on system values, see the System Values chapter of OS/400 Work Management.
To start DST on the primary partition use the system control panel to put the system in manual mode and
select option 21. The system will prompt you for the DST user ID and password.
Starting DST on a secondary partition from DST on the primary partition
Follow these steps to start dedicated service tools (DST) on a secondary partition:
1. Start DST on the primary partition.
2. Select option 11 (Work with system partitions).
3. Select option 2 (Work with partition status).
4. Use your cursor to select the secondary partition for which you want DST.
5. Select option 10 (Mode manual) if the secondary partition is not already in manual mode.
6. Press F23 for more options.
7. Select option 21 (Force Dedicated Service Tools). The secondary partition console will experience a
device I/O error and end abnormally. This is normal.
8. The DST display will appear on the workstation that is acting as console for the secondary partition.
Sign on to DST.
9. Before you leave DST, set the secondary partition back to normal mode if you want the next IPL to be
unattended.
Forcing DST from SST
You can force DST to start from SST if the logical partition is not in secure mode. On the primary partition,
you can force DST for itself or any of the secondary partitions. On a secondary partition you can force
DST to start on itself.
When you force DST from the system control panel of the Work with Partition Status display, you cancel
the current job on the partition console.
Note: If you perform an IPL on the logical partition before you exit DST, the next OS/400 IPL will be
abnormal. To avoid an abnormal OS/400 IPL, exit DST before you perform the IPL. Then sign on to
that logical partition and perform the IPL.
4AS/400e: Logical Partitions: Managing
|
|
|
|
|
|

These steps affect how they system stops active jobs when you start DST, including the system partition’s
service function. You may need to wait five minutes before starting service functions in DST that were
active in SST when you entered option 21.
To force DST from SST follow these steps:
1. Use the STRSST command to start SST.
2. Select option 5 (Work with system partitions).
3. Select option 2 (Work with partition status).
4. Use the cursor to select the logical partition on which you want DST.
5. If the partition is not in manual mode, select option 10 (Mode manual).
6. Select option 21 (Force DST). If you are forcing DST from the logical partition workstation where you
want DST, the workstation will experience a device I/O error and end abnormally. This is normal.
7. Sign on to DST.
8. Before you exit DST, set the logical partition back to normal mode if you want the next IPL to be
unattended.
Chapter 1. Controlling logical partitions with DST and SST 5
|

6AS/400e: Logical Partitions: Managing

Chapter 2. Displaying and printing logical partition
information
Use the Work with System Partitions display to find out whether or not your system has logical partitions,
which partition you are on, and how many partitions your system has. To start the Work with System
Partitions display, follow the procedure below to step two.
For more detailed information about your logical partitions, use the Display Partition Information display. If
you are at a secondary partition workstation, you can only find information about that logical partition. To
find information about the entire system, use the primary partition.
Only the Display Partition Information display on the primary partition provides the total system hardware
view. If you have changed the configuration of your system, this data may at times be incomplete or
obsolete. It can also reflect changes that will take effect on the next system initial program load (IPL).
To have an accurate view of the hardware, ensure that you performed an IPL on all secondary partitions
since the last primary partition IPL. Also ensure that the Work with Partition Configuration display does not
reflect a need for subsequent IPLs.
When a logical partition needs an IPL, a <flag appears in the Work with Partition Configuration display.
The <appears in the field to the right of the logical partition Name field. If the logical partition configuration
information reflects hardware no longer present in the system, you should clear non-reporting resources
from the logical partition.
You can get a printout of your system configuration by performing the steps in the Printing system
configuration page.
You start up the Display partition information display from system service tools (SST) or dedicated service
tools (DST). Follow these steps to start up the Display partition information display:
1. Start SST or DST.
2. From SST select option 5 (Work with system partitions); from DST select option 11 (Work with system
partitions) and press Enter.
3. Select option 1 (Display partition information) and press Enter.
You can perform the following tasks from the Display Partition Information display:
vDisplay logical partition status.
vDisplay logical partition processing configuration.
vDisplay allocated I/O resources.
vDisplay available I/O resources.
vDisplay system I/O resources.
vDisplay logical partition release level.
vDisplay communication options.
vDisplay reference code history for secondary partitions.
vPrint system configuration.
Displaying logical partition status
Use the Display Partition Status display to find much of the same information about logical partitions as
you would on the control panel of a system without logical partitions. If you start this display from the
primary partition, you get information about the primary partition and all the secondary partitions. If you
start this display from a secondary partition, you get information only for that secondary partition.
© Copyright IBM Corp. 1998,2000 7
|
|
|
|
|
|
|

You can perform this procedure from system service tools (SST) or dedicated service tools (DST).
To find the Display Partition Status display, follow these steps:
1. Start SST or DST.
2. From SST select option 5 (Work with system partitions); from DST select option 11 (Work with system
partitions) and press Enter.
3. Select option 1 (Display partition information) and press Enter.
4. Select option 1 (Display partition status) and press Enter.
Once you arrive at the Display Partition Status display, you can use the function keys that are listed below
to display the following information:
vF1– This key will bring you to the Help display. Go here for a detailed explanation of the fields on this
display.
vF9– This key toggles between Exclude reference code detail and Include reference code detail. This
option allows you to choose whether or not you can see the details of secondary partition reference
codes.
vF10– This key brings up the Monitor Partition Status display. This display refreshes automatically as the
system updates system reference codes for secondary partitions.
vF11– This key brings up the Display Partition Processing Configuration display.
Displaying logical partition processing configuration
You can find out how much main storage, how many processors, and how much interactive performance
assigned to each logical partition with the Display Partition Processing Configuration display. If you start
this display from the primary partition, you get information about the primary partition and all the secondary
partitions. If you start this display from a secondary partition, you get information only for that secondary
partition.
You can print the information in this display by pressing F6.
You can use the Display Partition Processing Configuration display from system service tools (SST) or
dedicated service tools (DST). To start the Display Partition Configuration display follow these steps:
1. Start SST or DST.
2. From SST select option 5 (Work with system partitions); from DST select option 11 (Work with system
partitions) and press Enter.
3. Select option 1 (Display partition information).
4. Select option 2 (Display partition processing configuration).
Displaying more processing information
Once you arrive at the Display Partition Processing Configuration display, you can use the F10 function
key to display the following information:
Total Processors
This field shows you:
vThe current and pending (updated after the next initial program load) number of processors.
vThe minimum and maximum number of processors allowed for each logical partition.
Main Storage Size (MB)
This field shows you the current and pending amount of memory for each logical partition. It also
shows you the minimum and maximum amount of memory available for each logical partition. Only
current information shows if SST or DST is running in a secondary partition. To find this field,
8AS/400e: Logical Partitions: Managing
|

press F10 (Display main storage information) when the Total Processors field shows on the
Display Partition Processing Configuration display.
Interactive Performance Percentage
This field shows you the current and pending amount of interactive performance for each logical
partition. It also shows you the minimum and maximum percentage of interactive performance
available for each logical partition. Only current information shows if SST or DST is running in a
secondary partition. To find this field, press F10 (Display interactive information) when the Main
Storage Size (MB) field shows on the Display Partition Processing Configuration display.
Processor Identifiers
This field shows you which processors you assigned to each logical partition. Only current
information shows if SST or DST is running in a secondary partition. To find this field, press F10
(Display processor identifiers) when the Interactive Performance Percentage field shows on the
Display Partition Processing Configuration display.
Displaying allocated I/O resources for logical partitions
An allocated I/O resource is an input/output (I/O) device that is assigned to a logical partition. You allocate
I/O resources at the I/O processor (IOP) level. In other words, you assign IOPs and all of their devices to
a logical partition.
If you start this display from the primary partition, you get information about the primary partition and all
the secondary partitions. If you start this display from a secondary partition, you get information only for
that secondary partition.
You can print the information in this display by pressing F6.
You can perform this procedure from system service tools (SST) or dedicated service tools (DST).
To display allocated I/O resources, follow these steps:
1. Start SST or DST.
2. From SST select option 5 (Work with system partitions); from DST select option 11 (Work with system
partitions) and press Enter.
3. Select option 1 (Display partition information).
4. Select option 3 (Display allocated I/O resources).
Once you arrive at the Display Allocated I/O Resources display, you can choose to view either one
particular logical partition or all logical partitions.
If you have restarted the primary partition, but not the secondary partitions the display will not be up to
date. You will only see the last buses and IOPs which reported for the secondary partitions. You will not
see IOAs and devices until you start the secondary partitions.
You can choose to view the resources at these levels of detail:
*ALL (everything on the system or allocated to a logical partition).
*BUS (display by system I/O bus).
*IOP (display by IOP and bus).
*IOA (display by I/O adapter (IOA), IOP, and bus).
*DEV (display by device, IOA, IOP, and bus).
Chapter 2. Displaying and printing logical partition information 9
|

Displaying serial and part number and logical address
You can use the F10 function key to toggle between the Serial Number and Part Number fields and the
Logical Address field. You can use the F1 function key on your workstation for more information about
these fields.
Displaying available I/O resources for logical partitions
An available input/output (I/O) resource is an I/O processor (IOP) or a system I/O bus that you can assign
to a logical partition. You cannot assign an I/O adapter or a single device (such as a tape drive) to a
partition without its IOP. When you assign an IOP to a partition, you assign all of its devices to a logical
partition.
You can print the information in this display by pressing F6.
You can perform this procedure from system service tools (SST) or dedicated service tools (DST).
To display available I/O resources, follow these steps:
1. Start SST or DST.
2. From SST select option 5 (Work with system partitions); from DST select option 11 (Work with system
partitions) and press Enter.
3. Select option 1 (Display partition information).
4. Select option 4 (Display available I/O resources).
If you have restarted the primary partition, but not the secondary partitions, the diplay will not be up to day.
You will only see the last buses and IOPs which reported for the secondary partitions. You will not see
IOAs and devices until you start the secondary partitions.
Once you have arrived at the Display Available I/O Resources display, you can view the resources at
these levels of detail:
*ALL (everything on the system or allocated to a logical partition).
*BUS (display by system I/O bus).
*IOP (display by IOP and bus).
*IOA (display by I/O adapter (IOA), IOP, and bus).
*DEV (display by device, IOA, IOP, and bus).
Displaying serial and part number and logical address
You can use the F10 function key to toggle between the Serial Number and Part Number fields and the
Logical Address field. You can use the F1 function key on your workstation for more information about
these fields.
Displaying system I/O resources for logical partitions
You can display all resources (allocated and available) on the system. This display sorts the resources by
address and shows resource status. It also shows the details of its logical partition characteristics.
You can print the information in this display by pressing F6.
10 AS/400e: Logical Partitions: Managing
|
|

You can perform this procedure from system service tools (SST) or dedicated service tools (DST) on the
primary partition.
To display system I/O resources, follow these steps:
1. From the primary partition start SST or DST.
2. From SST select option 5 (Work with system partitions); from DST select option 11 (Work with system
partitions) and press Enter.
3. From the Work With System Partitions menu select option 1 (Display partition information)
4. From the Display Partition Information menu select option 5 (Display system I/O resources).
If you have restarted the primary partition, but not the secondary partitions, the display will not be up to
date. You will only see the last buses and IOPs which reported for the secondary partitions. You will not
see IOAs and devices until you start the secondary partitions.
Once you have arrived at the Display System I/O Resources display, you can choose to view the
resources at these levels of detail:
*ALL (everything on the system or allocated to a logical partition).
*BUS (display by system I/O bus).
*IOP (display by IOP and buses).
*IOA (display by I/O adapter (IOA), IOP, and buses).
*DEV (display by device, IOA, IOP, and bus).
The system remembers your last choice so the default displays the level of detail you last selected.
Displaying more system I/O information
You can use the F10 function key to display this information:
vDisplay serial/part numbers- This view shows the serial and part numbers for the displayed resources
on every logical partition.
vDisplay logical address- This view shows the logical address for the displayed resources on every
logical partition. For more information on logical address, use the F1 function key on your workstation.
vDisplay status/ownership information- This view shows the hardware status and ownership
information.
–Hardware status- This field shows the state of the bus and IOP resources. Valid status values are:
Available, Failed, Unavailable, Unknown, and Other. Use the F1 function key on your workstation for
more information on these values.
–Ownership information- This information consists of two fields, Owning Par ID and Ownership
Type. Owning Par ID, shows which logical partition owns which resource. Ownership Type shows
whether each logical partition owns the resource Own bus dedicated or Own bus shared.
vDisplay using partitions- This field shows which logical partition uses the resource (with or without
ownership).
Displaying logical partition release levels
You can use the Display Partition Release Level display to see which release of the operating system
each logical partition is running.
Chapter 2. Displaying and printing logical partition information 11

The Delta field indicates the release a secondary partition is running in relation to the primary partition. A
positive value indicates a newer secondary operating system; a negative value indicates an older version.
You can perform this procedure from system service tools (SST) or dedicated service tools (DST) on the
primary partition. To use the Display Partition Release Level display, follow these steps:
1. On the primary partition, start SST or DST.
2. From SST select option 5 (Work with system partitions); from DST select option 11 (Work with system
partitions) and press Enter.
3. Select option 1 (Display partition information).
4. Select option 6 (Display partition release level).
Once you are in Display Partition Release Level, you can see what version of the operating system each
logical partition is running.
Displaying communication options for logical partitions
The Display communications options display shows whether or not you have connected each logical
partition to virtual OptiConnect and High Speed Link. This display shows the information below:
vThe Partition Identifier which is the number the system assigns to the partition.
vThe Name you gave the partition.
vWhether or not you connected the partition to Virtual OptiConnect.
vIf you have V4R5 hardware, whether or not you connected the partition to HS-Connect (High Speed
Link).
To get to the Display communication options display, follow the steps below:
1. On the primary partition, start SST or DST.
2. From SST select option 5 (Work with system partitions); from DST select option 11 (Work with system
partitions) and press Enter.
3. Select option 1 (Display partition information).
4. Select option 7 (Display communications options).
Displaying reference code history for secondary partitions
A reference code indicates a status or an error condition. The system records the reference code history
(the last 200 reference codes) for secondary partitions.
You can use the Display Secondary Partition Reference Code History display to view the reference code
history for secondary partitions.
You can perform this procedure from system service tools (SST) or dedicated service tools (DST) on the
primary partition. To display logical partition reference codes, follow these steps:
1. From the primary partition start SST or DST.
2. From SST select option 5 (Work with system partitions); from DST select option 11 (Work with system
partitions) and press Enter.
3. Select option 1 (Display partition information).
4. Select option 8 (Display secondary partition reference code history).
Once you arrive at the Display Secondary Partition Reference Code History display, you can choose to
display the information in a number of ways. At the Secondary partition(s) to display field, you can choose
to display one secondary partition or all secondary partitions.
12 AS/400e: Logical Partitions: Managing
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|

At the Number of reference codes to display field, you can choose to display any number of reference
codes between one and 200. For example, if the display reports 200 reference codes, you could choose to
view the last 50 or 150 reference codes.
Printing system configuration for logical partitions
You can perform this procedure from system service tools (SST) or dedicated service tools (DST) on the
primary partition. If you print from SST, the system will print the data to a spooled file. When you finish, go
to an OS/400 command line and print the spooled files. If you print from DST, you will get the Work with
Printers display if you have not selected a DST printer. If this happens, select a printer, then continue with
the procedure.
Follow these steps to print the system configuration:
1. From the primary partition start SST or DST.
2. From SST select option 5 (Work with system partitions); from DST select option 11 (Work with system
partitions) and press Enter.
3. Select option 1 (Display partition information).
4. For a complete list of all the I/O resources, go to the Display System I/O Resources display. For a list
of allocated I/O resources, go to the Display Allocated I/O Resources display.
5. At the Level of detail to display field, type *ALL to set the level of detail to ALL.
6. Press F6 to print the system I/O configuration.
7. Select option 1 (132 characters wide) and press Enter to print to a spooled file.
8. Press F12 to return to the Display Partition Information display.
9. Select option 2 (Display partition processing configuration).
10. Press F6 to print the processing configuration.
11. Select option 1 (132 characters wide) and press Enter to print to a spooled file.
12. Return to an OS/400 command line and print these two spooled files.
Chapter 2. Displaying and printing logical partition information 13
|
|
|

14 AS/400e: Logical Partitions: Managing