Using the event stream service for any user tasks

The functionality of the event-stream service can be used for any user task but is restricted by the specific operating functionality. It is a good idea to use at least two user tasks per workplace. One user task (user task 1) is used for the input of commands and to receive the associated command results. The second user task (interactive task 2) has to be an interactive task and is used for the presentation of asynchronous messages directed to the user task (e.g. BROADCAST), as well as of parts of the command dialog of user task 1, depending on the settings.

For every user event stream, the events are recorded in a separate user event-stream file in a separate batch task of the same ID. The name of the file is SYSLOG.ESS.USER.log-id. The suffix of the file name forms the name (LOG-ID) of the event stream. Access to the file is only possible via the presentation function. The lifetime of the batch task corresponds to the active phase of the event stream (from starting to termination or closing). The user event stream file is created the first time the event stream is started and deleted with final termination.

The name of the event stream (LOG-ID) is unique within the ID. Access to a user event stream is possible from all interactive tasks of the same ID. There is no special authorization for the TSOS ID.

Dialog stream (user task 1):

• Setting up a user event stream to receive asynchronous messages:
/ASSIGN-SYSEVENT TO=*USER (LOG-ID=MYES), ADD-SYNCH-EVENTS=*NONE

  ADD-SYNCH-EVENTS=*ALL can be used to also log the entire command dialog of user task 1 in the event stream MYES. This means that the scope of the events to be logged (messages) is set by means of the ASSIGN-SYSEVENT command and the ADD-SYNCH-EVENTS operand.

  The asynchronous messages sent directly to user task 1 are always logged. Depending on the setting ( MODIFY-MSG-OPTIONS command), these are also output on the data display terminal. The output on this terminal can be suppressed by the following setting:
/MODIFY-MSG-OPTIONS OPERATOR-BROADCAST=*NO.OPERATOR-MSG=*NO,SYSTEM-MSG=*NO

• The presentation of the event stream in the same task is possible but not advisable, because no commands can be entered during the presentation.

Presentation of the event stream (interactive task 2):

• Interactive task 2, also under a task of the same ID, is used only for the presentation of the event stream. The event stream assigned in user task 1 is uniquely identifiable by its name (LOG-ID).

• All recorded events are always displayed, i.e. there is no “viewer profile” for user event streams.

• The presentation function is started with the command
/SHOW-SYSEVENT-LOG LOG-ID=MYES

  The presentation function appears with its main mask in static mode and offers input options via menu, command line and F keys. The current mask always shows the most recent events.

  The following functions are offered in static mode:

  • position and page within the event stream

  • search

  • switch to dynamic mode

  • provide a help system

For a detailed description of the presentation function, see the description of the SHOW-SYSEVENT-LOG command.