CTRLCONS

Purpose

The CTRLCONS common command allows you to:

  • RESTART the console application of the addressed HMC or SE (for an SE, either the primary or the alternate application can be restarted)
  • RESTART or SHUTDOWN the addressed HMC or SE console (for an SE, either the primary or the alternate console can be restarted or shut down)

Syntax

Read syntax diagramSkip visual syntax diagramISQCCMDtarget_system_ProcOps_nametarget_hardware_name.LPAR_nametarget_hardware_nameCTRLCONSCMD(SHUTDOWN)ITEM(CONS)CMD(RESTART)ITEM(CONS)ITEM(APPL)TYPE(PRIMARY)TYPE(ALTERNATE)

Requirements

The requirement for the CTRLCONS command to complete successfully is:

  • Processor operations must be active.

Parameters

For a definition of target_system_ProcOps_name, target_hardware_name.LPAR_name, and target_hardware_name, see ISQCCMD.

CMD
The command to be executed. Can be either RESTART or SHUTDOWN.
Note: SHUTDOWN is only allowed with ITEM(CONS). If it used with ITEM(APPL), the CTRLCONS command will be rejected.
ITEM
The target of the command. Specify either:
  • CONS for the SE or HMC console
  • APPL for the SE or HMC console application
TYPE
The type of console or console application.
PRIMARY
Refers to the primary SE or HMC console or console application.
ALTERNATE
Refers to the secondary SE console or console application.
Note: ALTERNATE can only be used for SE connections; if it is used for an HMC connection, the CTRLCONS command will fail.

Defaults

The CTRLCONS command defaults to TYPE(PRIMARY).

Usage

Use this command to shut down or restart the HMC or SE Console or to restart the HMC or SE console application. On command execution, all ProcOps connections to that console or console application that are still active will be closed before executing the Shutdown or Restart itself in order to avoid uncontrolled connection loss as a consequence of the Shutdown or Restart command.

Note: If a console SHUTDOWN is performed, the console must be restarted manually.

Restrictions and Limitations

The CTRLCONS common command is only supported for SNMP connections. When issuing a CTRLCONS request for another ProcOps connection type, it will be rejected.

All required command parameters are checked if provided with the CTRLCONS command. All command parameters are checked for valid content.

Due to technical limitations on the SE console side, an SE Application Restart will actually be executed as a SE Console Restart.

Condition Codes

The following condition code is returned in the form 00B000xx, where xx is the condition code:
82
Invalid Session Type of ASYNC encountered. It must be SYNC.

Return Codes

The ISQCCMD command (see ISQCCMD) generates the return codes for common command processing.