GETSDGR
Purpose
The command returns the reason details available from target hardware processors that operate in DEGRADED state.
Use the GETSDGR command if you need information about the reason of the DEGRADED status.
Syntax
Requirements
- Processor Operations environment
-
- 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.
ISQVARS Keywords
- NOT_DEGRADED
- System is not in DEGRADED mode
- MEM_REDUCED
- Loss of memory
- MEM_BUS_FAILURE
- Loss of channels due to CPC hardware failure
- NODE_NOT_RUNNING
- One or more books are no longer functioning
- RING_OPEN
- The ring connecting the books is open
- CBU_EXPIRATION
- Capacity backup resources have expired
- MRU_FAILURE
- Modular Refrigeration Unit (cooling) problem
- TEMPERATURE_PROBLEM
- Processor frequency reduced due to temperature problem
- IML_WAS_IN_DEGRADED_MODE
- CPC was IMLed during temperature problem
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 GETSDGR common command is only supported for SNMP connections When issuing this request for another ProcOps connection type, it will be rejected.
Not all processor types provide DEGRADED support. If you issue GETSDGR for such target hardware, the GETSDGR command will fail with a condition code of 0B100001, object not defined, which means that the HW does not provide this function.
Return Codes
The ISQCCMD command (see ISQCCMD Return Codes) generates the return codes for common command processing.