Asynchronous Response Messages (AOFA0100–AOFA9999)

Events from CPCs or CPC images arrive as asynchronous messages in NetView.

The following event types are supported by the INGHWCMD interface:

  • Messages from the Operating System (BCP messages)
  • Status Changes of CPC or CPC image objects
  • Hardware Messages from the CPC and its associated CPC images
  • SNA Alert data from the CPC and its associated CPC images

AOFA0100 NEWSTATUS(obj_status_number) OLDSTATUS(obj_status_number)

Explanation

This message indicates a status change event of a CPC or CPC image object. Before you can receive this type of message, you must have successfully initialized an asynchronous session. Secondly, you must have specified a FILTER command with a NetView operator or group name as the receiver for each image or CPC that you target. See Hardware Object Status Summary for a list of the supported object status numbers and their meaning.

Example

Partition KEY4 of FREEWAY was successfully CP stopped. The status changed from OPERATING (0001) to NOT_OPERATING (0002).

After the LPAR was CP started again, its status went back to OPERATING. Note that Prefix message AOFA0900 was used, because the FILTER command was specified without a PFX. No operating system messages are shown either, because the event notification that was enabled with the FILTER request was only ST, for object status change events. 
   INGHWCMD FREEWAY INITCOM ASYNC
   INGHWCMD FREEWAY.KEY4 FILTER SET(ST) OP(TIL)
   INGHWCMD FREEWAY.KEY4 STOP

   AOFA0001 STOP FREEWAY.KEY4 STATUS(ACCEPTED) CPCINAME(KEY4) CPCSNAME(DEIBMD1.X7F1E30A)
                 TSTIME(030208143117)

   AOFA0900 FREEWAY.KEY4 SC AOFA0100 NEWSTATUS(0002) OLDSTATUS(0001)

   INGHWCMD FREEWAY.KEY4 START

   AOFA0001 START FREEWAY.KEY4 STATUS(ACCEPTED) CPCINAME(KEY4) CPCSNAME(DEIBMD1.X7F1E30A)
                  TSTIME(030208143134)

   AOFA0900 FREEWAY.KEY4 SC AOFA0100 NEWSTATUS(0001) OLDSTATUS(0002)

AOFA0200 CpcName.ImageName ConID Command_completion_response

Explanation

This event report message returns the command completion information of the asynchronously executed hardware commands. This type of command does not return results before all related work in the hardware has completed. After that, a command completion event is emitted which provides the final completion information of the command.
CpcName.ImageName
Specifies the name of the processor as defined in the SA z/OS policy and the image or LPAR name that this asynchronous command completion message originates from.
ConID
Always SC for System Console.
Command_completion_response
Format is CC(xxxxxxxx), where xxxxxxxx is a completion code in hex or decimal notation.
00000000
The asynchronous command, specified in this report, completed successfully.
00000026 - 00000070 (value range)
Completion responses specific to CBU, OOCOD, TCM, and STP commands. For details, see section HWMCA_EVENT_COMMAND_RESPONSE return codes of this response. It is documented in the appendix of hardware manual IBM Z® SNMP Application Programming Interfaces.
0806000A (134610954) - 80180002 (2149056514) (value range)
General hardware command completion responses. For details, see section HWMCA_EVENT_COMMAND_RESPONSE return codes of this response. It is documented in the appendix of hardware manual IBM Z SNMP Application Programming Interfaces.

System programmer response

If the completion code details suggest to retry the request after the noted conditions are met, do so. If it's stated that a hardware error may cause this condition, perform the HMC task 'Report a Problem' to inform IBM about the problem.

AOFA0300 Power® Mode Change occurred, Old Status (Old-value) New Status (New-value) Object (CpcName)

Explanation

This message indicates a change related to the CPC's Power Mode settings. This message uses the following variables:
Old-value
Value before Power Mode was changed.
New-value
New Power Mode value.
CpcName
Specifies the name of the processor as defined in the SA z/OS policy.

AOFA0400 CpcName ConID HW_message

Explanation

This response message uses the following variables:
CpcName
Specifies the name of the processor as defined in the SA z/OS policy.
ConID
Always SC for System Console.
HW_message
The message text is identical to the short message text displayed on the SE or HMC that an HW message is waiting for, when a CPC object has been marked. Note that the message detail information can only be accessed using the HMC or SE GUI.

AOFA0444 CpcName.ImageName Cons_designator DISABLED WAIT CP (num) PSW (xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx)

Explanation

CpcName.ImageName
Specifies the name of the processor as defined in the SA policy and the partition name where the WAIT occurred.
Cons_designator
Always SC for System Console.
num
Number of central processor that entered the disabled wait state.
xxx...xxx
The current Program Status Word (PSW) of the central processor num, displayed as 32 hex characters. For information about the wait state code shown in the PSW, refer to the appropriate OS documentation.

AOFA0500 CpcName ConID Temporary Capacity Record record_id Change occurred (change_code)

Explanation

This message indicates a change related to a Temporary Capacity record. It uses the following variables:
CpcName
Specifies the name of the processor as defined in the SA z/OS policy.
ConID
Always SC for System Console.
record_id
An 8 digit record number of the temporary capacity record.
change_code
A numeric code that indicates the type of change. Possible values are:
0
Capacity Record 'Add' occurred
1
Capacity Record: Delta
2
Capacity Record 'Delete' occurred
3
Capacity Record Accounting Data change
4
Capacity Record Activation Level change
5
Capacity Record: Priority Pending
6
Capacity Record: Other changes

AOFA0600 CpcName Cons_designator Temporary Capacity Change occurred(change_code)

Explanation

This message indicates a change related to Temporary Capacity management of the Target Hardware. It uses the following variables:
CpcName
Specifies the name of a processor as defined in the SA z/OS policy.
Cons_designator
Is always SC for System Console.
change_code
A numeric code that indicates the type of change. Possible values are:
0
Capacity: Fenced Book
1
Capacity: Defective Processor
2
Capacity: Concurrent Book Replace
3
Capacity: Concurrent Book Add
4
Capacity: Capacity Check Stop
5
Temporary Capacity Changes Allowed
6
Temporary Capacity Changes Not Allowed

AOFA0700 APPL_ENDED CONSOLE(con_name) REASON(reason) TYPE(type) COMPONENT(comp)

Explanation

This message indicates the end of the console application operation. This is the software on the Support Elements (SEs)/ Hardware Management Consoles (HMCs) that permits Operations Management tasks. SA z/OS requires this component to be operational in order to communicate with the SE/HMC.
con_name
Name of the affected console. For SE connections, this name is identical to the NAU name part of the CPC network address. For HMC connections this name is identical to the Console Name defined with the Customize Network Settings task from the HMC Console Settings Work Area.
reason
Issuer that caused the console application to end.
USER
A logged on user
AUTOMATION
An automation application.
OTHER
Remote action such as SE reboot from an HMC.
UNKNOWN
The reason code in the event data is unknown.
type
Specifies the action that caused the console application to end. Depending on the type given, a possible console application outage time can be predicted.
SHUTDOWN_CONSOLE
Long outage, manual intervention is required to recover.
RESTART_APPLICATION
Medium outage of 10 - 20 minutes can be expected until the console application is fully operational again.
RESTART_CONSOLE
Medium outage of 10 -20 minutes can be expected until the console application is fully operational again.
UNKNOWN
The type code in the event data is unknown. Long outage, manual intervention may be required to cover.
comp
Names the component that is involved in this event. In the case of reason code AUTOMATION, the involved component may be API. Note that the component information given in this report does not exceed more than 20 characters.

AOFA0800 CONSOLE(con_name) SECLOG REPORT date_time_stamp security_log_message

Explanation

This message report is issued each time a new message is written to the Security Log of the Support Element (SE)/ Hardware Management Console (HMC) that is in session with SA z/OS. Depending on the length of the security_log_message, this report may have more than three AOFA0800 report lines. With a processor operations SNMP connection, you can use the ISQCCMD SECLOG common command to turn this function on or off.
con_name
Name of the affected console. For SE connections, this name is identical to the NAU name part of the CPC network address. For HMC connections this name is identical to the Console Name defined with the Customize Network Settings task from the HMC Console Settings Work Area.
date_time_stamp
Indicates the date and time, the record was written in the log. Date format is month-day-year and time format is hh:mm:ss:hss.
security_log_message
For more information about what types of messages are written to the console security log, use the 'View Security Logs' task of your SE/HMC console.

AOFA0900 CpcName.ImageName ConID Event_message_string

Explanation

This response message uses the following variables:
CpcName.ImageName
Specifies the name of the processor as defined in the SA z/OS policy and the image or LPAR name that this event message originates from.
ConID
For BCP message events the ID is OC, indicating a message from the operator console. For all other event messages, the ID is SC, indicating a message from the system console.
Event_message_string
Specifies the message text from the operating system as shown on the SE or HMC, or the message string specific to the other events type.

AOFA0996 WAIT sec SECOND FOR TERMINATION OF A COMMAND SESSION: OPID(opid) CPCSNAME(cpc) TSTIME(time) COMMAND(command).

Explanation

The HW event handler for the CPC (cpc) session returned an error and the asynchronous session terminates. To perform a save memory cleanup, an HW command that is still active for the CPC running in task (opid) must be terminated first. Wait for (sec) seconds for normal command termination.

AOFA0997 EVENT HANDLER ERROR, CORRUPTED TCPIP PACKET RECEIVED REASON (reason), SESSION IS TERMINATING.

Explanation

The HW handler for this SE or HMC session has received a corrupted or uncompleted TCPIP packet. The asynchronous session terminates.

This report might be issued in case of disruption of the IP connection to the hardware management console (SE or HMC). Possible reason codes:

HWMCA_INCOMPLETE_TRAP                          0
HWMCA_BADTRAP_NO_SEQUENCE                  10001
HWMCA_BADTRAP_BAD_INITIAL_LENGTH 	         10002
HWMCA_BADTRAP_BAD_VERSION_LENGTH 	         10003
HWMCA_BADTRAP_BAD_COMMUNITY_LENGTH 	       10004
HWMCA_BADTRAP_BAD_PDUTYPE 	                10005
HWMCA_BADTRAP_BAD_PDU 	                    10006
HWMCA_BADTRAP_BAD_PDU_LENGTH 	             10007
HWMCA_BADTRAP_BAD_ENTERPRISE_LENGTH 	      10008
HWMCA_BADTRAP_BAD_ADDRESS_LENGTH    	      10009
HWMCA_BADTRAP_BAD_GENERIC_LENGTH 	         10010
HWMCA_BADTRAP_BAD_TIMESTAMP_LENGTH 	       10011
HWMCA_BADTRAP_BAD_VARBIND_LENGTH 	         10012
HWMCA_BADTRAP_BAD_VARBIND_SEQUENCE 	       10013
HWMCA_BADTRAP_BAD_VARBIND_SEQ_LENGTH 	     10014
HWMCA_BADTRAP_BAD_VARBIND_OID_LENGTH 	     10015
HWMCA_BADTRAP_BAD_VARBIND_DATA_LENGTH 	    10016
HWMCA_BADTRAP_BAD_SPECIFIC_LENGTH 	        10017

AOFA0998 EVENT HANDLER WARNING: ASYNCHRONOUS SESSION HAS BEEN REESTABLISHED

Explanation

The HW event handler for this SE/HMC recovered a missing heartbeat condition signaled by the BCP Internal Interface. Some events might have been lost. Applications should query status information of the CPC or image in order to determine the current status. Note that BCP messages that are transported as HW events are not buffered and cannot be recovered if they are lost.

AOFA0999 EVENT HANDLER ERROR RC(rc) , ASYNCHRONOUS SESSION IS TERMINATING.

Explanation

The HW event handler for this SE or HMC session returned an error return code (rc). The asynchronous session terminates. An INITCOM ASNC must be issued to reactivate the session. Refer to Data Exchange Services "0B100xxx" if the return code number is less than 100. Refer to Internal Transport Services "0Bx00xxx" for return codes greater than 100. Note that only if you set a CPC event filter will you receive this event handler termination report.

This report might be issued in case of an unplanned or planned outage of the hardware management console (SE or HMC). For planned outages (maintenance), it is strongly recommended to first close the ongoing active target hardware connections to that hardware management console using command TERMCOM, or for Processor Operations users, command ISQXCLS.

Note: For Processor Operations connections, INITCOM is executed as part of host-based command ISQXIII (Initialize target connection).

AOFA9999

Explanation

This report is written to the netlog only. It is generated by an SA-BCPii session after it is set in HOLD mode. For ProcOps ISQET32 SNMP sessions, this can be done manually using command ISQXCON SUSPEND HOLD. For INTERNAL connections, the general SA-BCPii service command INGHWSRV SUSPEND HOLD is available.

SA-BCPii sessions in HOLD mode might still receive event data from target processors and LPARs, but can no longer be used for manual or automated responses. Each event report is prefixed with an AOFA9999 report token to indicate this.

For manual recovery from HOLD mode, you can use the RESUME function of the ISQXCON or INGHWSRV commands. Note that the HOLD mode might also be part of a ProcOps or GDPS product automation and that a manual intervention may disrupt session management automation in progress. Note that the session HOLD mode is not available with SA ProcOps TCP/IP based SNMP sessions.

Examples

LOG  IPSFO 19:09:12 U AOFA9999 T313.KEY3 OC 
                      IEF404I BPXAS -
                      ENDED - TIME=19.09.10

The SA-BCPii session to processor T313 is currently in HOLD mode. The z/OS job ended message IEF404I, displayed on the SYSCONS of LPAR KEY3 is still transferred to the receiving SA domain IPSFO and written to the netlog for audit purposes only. Automation of AOFA9999 prefixed messages is prohibited by SA z/OS.