Using the OPSCONSOLE macro

The OPSCONSOLE macro is the system-side debugging and analysis tool for collecting data for or managing console-related work.

IBM-supplied macros are advanced debug and analysis tools resident on the system. 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, you should 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 or DST).

Note: Improper use of IBM-supplied macros could result in a change requiring a complete system reload. It is strongly suggested that you use these IBM-supplied macros only at the request of a support representative.

To use the Operations Console IBM-supplied macro support, follow these steps:

  1. Access Service Tools using SST or DST.
  2. Select Start a service tool.
  3. Select Display/Alter/Dump.
  4. Select Display/Alter storage.
  5. Select Licensed Internal Code (LIC) data.
  6. Select Advanced analysis. (You will have to page down to see this option.)
  7. Page down until you find the OPSCONSOLE option. Then, place a 1 next to the option and press Enter. You should be on the Specify Advanced Analysis Options window. The command should show as OPSCONSOLE.
  8. Enter the appropriate option and any required parameters in the Options field.
    Use the following options based on the function you are running:
    • Start of changeChange the console type = cnsltype x (where x is 3 or 4) End of change
    • 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 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 remove the current console from service and allow the system to determine whether to 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 are take over Console Information Status window commands:

    • To show the Console Information Status window, use the showstatus command.
    • To not show the Console Information Status window, use the skipstatus command.
    • To allow the F18 console take over, use the takeon command.
    • To not allow the F18 console take over, use the takeoff command.

    The following options are only used when the system is not managed by a Hardware Management Console (HMC):

    • Enable the embedded Ethernet port = enbintlan. Use this command if you want to use the embedded port for the console.
    • Disable the embedded Ethernet port = disintlan. Use this command if you want to use a LAN console resource other than the embedded port. You must have enabled support to use the external resource, such as running the macro enbextlan.
    • Enable an add-on adapter = enbextlan. Use this command to take advantage of the faster network capability from one of these adapters instead of your current network adapter.
    • Select a specific LAN adapter location = enblslot x(x is 1 thru 10 depending on model)
    • Clear the LAN adapter location = clrlslot
    • Disable an add-on adapter = disextlan. Use this command if you want to prevent the use of this LAN adapter for use as a console.
    • Enable both the embedded port and the add-on adapter = enbboth. Use this command if you want to make your current model use these resources as the default settings for a new model.
    • Disable both the embedded port and the add-on adapter = disboth. Use this command if you have a IBM® i model and do not want the adapters used for the console.
    • Display configuration flags = dspcfg. Use this command if a service and support representative requested this information. This macro returns the state of the embedded port, the state of the add-on LAN adapter, the selected LAN adapter slot, and other configuration settings.