CLRHWMSG

Purpose

The CLRHWMSG command deletes one message from the list of messages shown in the Hardware Messages window of the Support Element or Hardware Management console, sent to ProcOps FP system as an AOFA0400 HW message event report. The message selector is the timestamp, preceding the message text. This allows you to perform automated/manual housekeeping of the hardware messages sent to ProcOps.

Read syntax diagramSkip visual syntax diagram ISQCCMD target_system_ProcOps_nametarget_hardware_name.LPAR_nametarget_hardware_name CLRHWMSG MTS ( msg_timestamp )

Requirements

The requirements for the CLRHWMSG command to complete successfully are:

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_hardware_ProcOps_name, target_hardware_name.LPAR_name, and target_hardware_name, see ISQCCMD.

MTS
msg_timestamp
Date and Time when the message occurred. The timestamp format is as follows:

mm-dd-yyyy hh:mn:ss:mis

Date
mm
month of the year 01-12
dd
day of the month 01-31
yyyy
four digit year
Time
hh
hour of day 00-23
mn
minute of the hour 00-59
ss
second of the minute 00-59
mis
millisecond 000-999
Note: Depending on the processor type a two digit hundredths of seconds value may also be specified.

Date and Time information must be separated by a blank character.

Hardware message example:
07-21-2015 12:37:59:581 A logically partitioned mode event occurred.

Defaults

None.

Usage

Use this command to delete a hardware message from either the HMC or SE of the addressed CPC, depending on its ProcOps SNMP connection address. After successful deletion, the hardware message is no longer visible in the console hardware message window. On completion, a AOFA0028 report is issued.

Additional Programming Information

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

Restrictions and Limitations

The CLRHWMSG common command is only supported for SNMP connections. You cannot use CLRHWMSG to perform housekeeping of multiple messages at once. In order to delete a message you must specify the complete timestamp, including the millisecond value.

Return Codes

The ISQCCMD command generates the return codes for common command processing.