IDIEventInfo command

The IDIEventInfo 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 IDIEventInfo command to change the values in the UFM data area from the values representing one event to those of another.

Figure 1. Syntax

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 IDIEventInfo 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 IDITRACE DDname.
8: Command syntax error. An explanation of the error is written to the IDITRACE DDname.

Example

Figure 2. IDIEventInfo command example

/* REXX */

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