Using the OPSCONSOLE macro

Learn how to use the OPSCONSOLE macro, which is the system-side debugging and analysis tool for managing or collecting data for console-related procedures.

Native macros are advanced debug and analysis tools resident on the server. These tools are intended to be used only with the direction of support personnel because inappropriate use of these tools can cause unpredictable problems with your system. If you are not comfortable in the service tools area, call your service provider for assistance before using these tools. These instructions assume you do not have a console device, but do have another workstation capable of using the system service tools (SST).

Important: Incorrect use of native macros can result in a change requiring a complete system reload. Use these native macros only at the request of a support representative.

To use the Operations Console native macro support, follow these steps:

Access service tools using SST.
Select Start a service tool.
Select Display/Alter/Dump.
Select Display/Alter storage.
Select Licensed Internal Code (LIC) data.
Select Advanced analysis. (Page down to see this option.)
Page down until you find the OPSCONSOLE option.
Type a 1 next to the option and press Enter. The Specify Advanced Analysis Options window is displayed and the command displays as OPSCONSOLE.
Enter the appropriate option and any required parameters in the Options field. Use the following options based on the function you are running:
- Change the console type = cnsltype x (where x is 1, 2, 3, or 4)
- Clear the resource and configuration for the Operations Console LAN adapter = cnfglan -clear
- Dump Operations Console-related flight recorders to vlogs = dump -vlog
- Deactivate the communications adapter for a local console that is directly attached = deactdirect
- Activate the communications adapter for a local console that is directly attached= actdirect
- Deactivate the LAN adapter for a local console on a network (LAN) = deactlan
- Activate the LAN adapter for a local console on a network (LAN) = actlan
- Restart the console device (any console) = restart
  Note: Use the restart option when you need to deactivate the current console and allow the server to determine and start or restart a console. You can use the restart option to correct a problem with the original console or when switching from one console type to another.

The following codes are only used when the server is not managed by an HMC:

Enable the embedded Ethernet port = enbintlan You might want to run this command if you have an IBM® System i5® and eServer™ i5 model manufactured before V5R4 and you want to use the embedded port for the console.
Disable the embedded Ethernet port = disintlan You might want to run this command if you have an IBM System i5 and eServer i5 model manufactured at V5R4 as the default LAN console resource and you want to use the resource for another purpose.
Enable a 5706/5707 or 5767/5768 adapter = enbextlan You might want to run this command if you have an IBM System i5 and eServer i5 model manufactured prior to V5R4 to take advantage of the faster network capability from one of these adapters instead of your current network adapter.
Disable a 5706/5707 or 5767/5768 adapter = disextlan You might want to run this command if you have an IBM System i5 and eServer i5 model and want to prevent the use of this LAN adapter for use as a console.
Enable both the embedded port and the 5706/5707 or 5767/5768 adapter = enbboth You might want to run this command if you have an IBM System i5 and eServer i5 model manufactured prior to V5R4 to make your current server use these resources as the default settings for new models being built.
Disable both the embedded port and the 5706/5707 or 5767/5768 adapter = disboth You might want to run this command if you have an IBM System i5 and eServer i5 model and do not want the adapters used for the console.
Display both the embedded port and the 5706/5707 or 5767/5768 adapter configuration flags = dspcfg You might want to run this command if you have an IBM System i5 and eServer i5 model and a service and support representative asked you for this information. This macro returns the state of the embedded port and Gigabit LAN adapter support.
Select an individual asynchronous adapter for console and remote service = enbslot x (x is 1 thru 6 depending on model). See note 1 for models 515, 520, and 525 running V5R3M5 or V5R4M0.
Notes:
1. This option applies to the IBM System i5 520, 525, and 515 models that are not managed by an HMC and have an IOA that does not require an IOP. For the 520, you can install PTF MF39303 (V5R3M5) or PTF MF39304 (V5R4M0). For the 525 and 515, these PTFs should already be installed.
2. If you are running LIC prior to V5R4M5 and you have moved the 2793/2794 asynchronous adapter from its manufacturing default location to use Operations Console (Direct), you must first activate the communications adapter for a local console that is directly attached (actdirect).
3. If you no longer want to select an individual asynchronous adapter, you can clear your current selection by using clrslot.

The following options are available with V5R4M5 :

Select a specific LAN adapter location = enblslot x (x is 1 thru 6 depending on model)
Clear the LAN adapter location = clrlslot