HFZEventInfo command

The HFZEventInfo command can be used to by a Formatting user exit to obtain information about any event in the current fault.

Since the UFM data area only contains one set of fields for PSW, registers, and so on, it is necessary to use the HFZEventInfo command to change the values in the UFM data area from the values representing one event to those of another.

Read syntax diagramSkip visual syntax diagram
Syntax

>>-HFZEventInfo-+----------+-----------------------------------><
                '-var_name-'   

Parameters

var_name
Specifies the name of a REXX variable containing the event number for which information is to be retrieved.

If a variable containing the desired event number is not provided in var_name, then UFM.EVENT_NO is used instead.

The information retrieved is placed in the UFM data area.

Return codes

The HFZEventInfo command provides the following return codes:
0
Information was retrieved successfully.
4
No information available for the specified event number. An explanation of the error is written to the HFZTRACE DDname.
8
Command syntax error. An explanation of the error is written to the HFZTRACE DDname.

Example

Figure 1. HFZEventInfo command example
/* REXX */

/* Process all events */
do event=1 to UFM.NUM_EVENTS
  "HFZEventInfo event"
  if RC<>0 then iterate
  ⋮
end