GETCLUSTER

Purpose

The command returns a list of the CPC addresses that are in the scope of control in the current CPC environment. If the ProcOps SNMP connection is to a Support Element, the list represents the defined CPCs of the so called Master HMC, which has the LIC Change function enabled. If the ProcOps SNMP is to a HMC, the GETCLUSTER command returns the CPC addresses of the Defined CPCs Group of this HMC.

Use the GETCLUSTER command to get basic information about all CPCs in the neighborhood of your CPC, regardless if the processors are defined to System Automation, or not.

Syntax

Read syntax diagramSkip visual syntax diagramISQCCMDtarget_system_ProcOps_nametarget_hardware_name.LPAR_nametarget_hardware_nameGETCLUSTER

Requirements

The requirements for the GETCLUSTER command to complete successfully are:
  • Processor Operations must be active.
  • The addressed target system or target hardware.lpar must have been initialized using the ISQXIII command.

Parameters

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

Defaults

None.

Additional Programming Information

On command completion, the immediate HW response report messages are also available in a Pipe KEEP with the name 'ISQ.SNMP'. When using this KEEP as your first Pipe stage, you can directly access this HW data.

Restrictions and Limitations

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

Return Codes

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