Completing a console change by using the command line when the logical partition is powered on

After making the necessary hardware changes, use this information to complete the console change by using the command line, when the logical partition powered on. This procedure does not require an IPL.

Before you begin

Before you begin, ensure that the current configuration meets the following requirements:

The QAUTOCFG system value is set to On. Use the WRKSYSVAL QAUTOCFG (Work with System Value command) to verify.
If you want to access the HMC command line by using a local terminal connection, start an xterm shell on the HMC. To start the shell, open a terminal by right-clicking the background and selecting Terminals > rshterm.
If you want to access the HMC command line by using a remote terminal connection such as PuTTY, first set up secure script processing between SSH clients and the HMC. Then, start your remote terminal by specifying the name of the HMC that is managing the logical partition with which you want to work.

About this task

The following procedure contains examples within the steps to help you complete a console change. In these examples, the system that is named sysname with logical partition identification number 1 is changing from the HMC to Operations Console (LAN) by using an embedded Ethernet port. These are variables for the actual system name and logical partition ID number. In the following instructions, replace sysname with your system name and replace 1 with your logical partition identification number.

To make a console change by using the command line and without powering off the logical partition, complete the following steps:

Procedure

List the current I/O configuration for the logical partition and locate the device that you want to make the system console device. If you do not know the resource that is being used for the console, continue with step 1.a. If you already know which resource is being used for the console, continue with step 1.c. Otherwise, complete step 1.b to list the currently tagged resource for the console.
1. Type the following command on the HMC command line:
```
 lssyscfg -r sys -F name
```
  This command returns a list of managed systems. Select the system for which you want to change the console and use the system name as the sysname value in the next steps.
2. Type the following command on the HMC command line:
```
lshwres -m sysname -r io --rsubtype taggedio --filter lpar_ids=1 -F console_slot
```
  This command returns none, hmc, or an 8-character hexadecimal string that represents the dynamic reconfiguration connector (DRC) index of the current console adapter.
3. Complete either of the following steps to determine the resource ID. The step that you select depends on whether you have an input/output adapter (IOA) or are using a host Ethernet adapter (also referred to as the Integrated Virtual Ethernet) logical port.
  - To list the IOAs that are owned by the logical partition, type the following command on the HMC command line:
```
lshwres -m sysname -r io --rsubtype slot --filter lpar_ids=1 -F drc_index,drc_name,description
```
    The system returns data in the following format:
```
21010003,U1234.001.123456A-P1-T12,PCI RAID Controller ...  

21010004,U1234.001.123456A-P1-C2,PCI 10/100/1000Mbps Ethernet UTP 2-port  

21010005,U1234.001.123456A-P1-C3,PCI 2-Line WAN w/Modem
```
    The location of resource DRC 21030003 is listed as P1-T12 and not P1-Cn (where n is a slot number). The Tn designation represents embedded resources. If you designate an actual adapter, the location is a value similar to P1-C2. This enables you to get the DRC index of the IOA, which becomes the new console device.
  - To list the logical ports that are owned by the logical partition, type the following on the HMC command line:
```
lshwres -m sysname -r hea --rsubtype logical --level port --filter lpar_ids=1 -F drc_index,drc_name
```
    The system returns data in the following format:
```
23e01000,Port 17 

23e01100,Port 18 

23e00000,Port 1 

23e00100,Port 2
```
4. Identify the DRC index of the console IOA or the logical port of the host Ethernet adapter that you want. In the previous output example, the first entry is a logical port of the host Ethernet adapter with a DRC index of 23e01000. This is the first logical port for physical port T1 (top connector).
Change the console tag of the logical partition to the device that you want to become the next console device.
1. Complete one of the following steps to change the console type:
  - Change your console to the HMC.
    To set the new console tag to the HMC 5250 console, type the following command:
```
chhwres -m sysname -r io --rsubtype taggedio --id 1 -o s -a console_slot=hmc 
```
  - Change your console to Operations Console (LAN).
    To set the new console tag to an IOA with a DRC index of 21010004 (the DRC index can be obtained using step 1.c), type the following command:
```
chhwres -m sysname -r io --rsubtype taggedio --id 1 -o s -a console_slot=21010004 
```
  - Change your console to Operations Console (LAN) by using a logical port of the host Ethernet adapter.
    To set the new console tag to a logical port of the host Ethernet adapter with a DRC index of 23e01000 (the DRC index can be obtained using step 1.c), type the following command:
```
chhwres -m sysname -r io --rsubtype taggedio --id 1 -o s -a console_slot=23e01000 
```
2. To verify your changes, repeat step 1.c.
  Notes:
  - To clear the console tag, type the following command:
```
chhwres -m sysname -r io --rsubtype taggedio --id 1 -o s -a console_slot=none
```
  - To clear the Operations Console tag, type the following command:
```
chhwres -m sysname -r io --rsubtype taggedio --id 1 -o s -a op_console_slot=none
```
  - If specifying none in the previous command results in an error message, try entering eight zeros (00000000) instead.
Search for the console device by performing the following sequence of console service functions against the logical partition: 65+21+21. Perform this sequence of three console service functions within 45 seconds for each function to start a new search for the console device.
1. To perform function 65 (remote DST off), type the following command:
```
chsysstate -m sysname -r lpar --id 1 -o remotedstoff
```
2. To perform function 21 (force DST), type the following command:
```
chsysstate -m sysname -r lpar --id 1 -o dston
```
3. Repeat step 3.b.
Connect with the newly selected console device, and monitor the system reference codes (SRCs) for the logical partition. It might take up to 3 minutes for the console adapter change to be completed.
Note: To monitor the SRCs for the logical partition, type the following to list the last 10 SRCs:
```
lsrefcode -m sysname -r lpar -n 10 --filter "lpar_ids=1" 
```
SRCs are listed in order from newest to oldest. To list a different number, replace 10 in the command with the number of SRCs that you want returned.
Update the logical partition profile on the HMC to match the dynamic console change:
1. In the navigation area, click Systems Management > Servers.
2. In the navigation area, select the managed system.
3. In the contents area, select the logical partition that you want to change.
4. Select Actions > Profiles > Manage Profiles.
5. Select the logical partition profile that you want to change.
6. Click Actions > Edit.
7. Click Tagged I/O, and then click Select in the Console area.
8. Select the resource if it is an IOA, or switch from I/O device to Logical Port to use a host Ethernet adapter logical port.
9. Click OK.
10. Click OK > Close.

Last updated: Tue, November 14, 2017