DISPLAY EVENT HISTORY - USAP Command

Description

The DISPLAY EVENT HISTORY command displays a list of events that were logged in an SAP system's event history. The retrieved events optionally can be set to CONFIRMED.

Command Line Syntax

The following figure illustrates the command line syntax of the DISPLAY EVENT HISTORY command, using the command line, long form of its configuration options.

-display event_history

-event_id

id

-event_parm

parm

-event_select_state

state

-event_action

action

Command Argument

The DISPLAY CM PROFILES command can be expressed as either:

  • -D: Short form
  • -display: Long form

The DISPLAY EVENT HISTORY command argument, event_history, requests the display of a list of SAP events that match the specified id and parm values. The '*' wild card is permitted for both event_id and event_parm criteria.

Configuration Options

The following table describes all DISPLAY EVENT HISTORY configuration options and provides the command line, long form of each option illustrated in the DISPLAY EVENT HISTORY command line syntax, above.


Configuration
Option Name

Command Line
Long Form

Description

EVENT_ID

-event_id

Event ID criteria to use for selecting events.

EVENT_PARAMETER

-event_parm

Event parameter criteria to use for selecting events.

EVENT_SELECT_STATE

-event_select_state

Specifies the event status of the events which should be read. The following values are possible:

  • N -Return events that are in status NEW. This includes events that were newly logged and have not been read yet, or events that have been read but not marked as confirmed by the external scheduler.
  • C - Return events which were marked by the external scheduler as CONFIRMED.
  • A - Return events regardless of their status.

The default value is A.

EVENT_ACTION

-event_action

Specifies whether the status of returned events should be changed in the SAP system. The following values are possible:

  • C - Sets the status of read events from NEW to CONFIRMED.
  • N - Leaves the status of read events as NEW.

The default value is N.