Global Messages for Events

The Global Messages for Events screen is used to determine the message recipients for specified events.

This section describes the fields and selection options provided on the Global Messages for Events screen.


Accessing the Global Messages for Events Screen

Start of instruction set To define global messages for events

  • Select the Global Messages for Events option from the System Services Menu.

    A screen similar to the example below appears:

     17-09-12                ***** Entire Operations *****                15:51:13 
                              Global Messages for Events                           
     ------------------------------------------------------------------------------
     Definition of events, for which messages will always be sent or stored in the 
     Event Store. Please note that the receiver table must be valid.               
     You may use PF6 to modify the receiver table for message sending.             
                                                                                   
                                     Message  Event                                
     Events                          Sending  Store   Symbols to be used           
     Monitor Runtime Information        N       N     Owner         ==> __________ 
     Monitor Runtime Errors             N       N     Symbol Table  ==> __________ 
     Activation and JCL Load Errors     N       N          Version  ==> (unnamed)_ 
     Latest start time exceeded         N       N     Escape        ==> @          
     Job executing after deadline       N       N                                  
     Job not ok, or execution error     N       N                                  
     Network or Job not terminated      N       N                                  
     Awaiting Symbol Prompting          N       N                                  
     Symbol not found                   N       N                                  
     Calendar undefined for year        N       N                                  
     Node Errors                        N       N                                  
     Execution time threshold reached   N       N                                  
                                                                                   
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End         Save  RcvTa Symb

Receiver Table

For all events marked with Y in the input fields of the Message Sending column, a pre-defined message will always be sent to all receivers defined in the receiver table (opens with PF6) for these events.

This function works only if the receiver table contains at least one receiver.

Note:
Only one receiver table is available for all defined events.

You can use e-mail addresses as receivers.

These must be stored in the symbol table, which can be defined on the Global Messages for Events screen.

The receiver table contains the symbol, preceded by the global activation escape character, representing the receiver in this case.

The fields contained in the receiver table are explained in Fields and Columns: Message and Message Recipients in the section Message Sending in the User's Guide.

Event Store

You can limit the number of messages distributed among users by storing part ot the messages in the event store of System Automation Tools. The messages can then be checked only if required.

For all events marked with Y in the input fields of the Event Store column, a pre-defined message will always be saved in the event store (if used) of System Automations Tools.

For detailed information on the event store, refer to the appropriate System Automation Tools documentation.

Symbols to be Used

In the Symbols to be Used section of the Global Messages for Events screen, you can specify the symbol table to be used for all symbol replacements within the message receiver table.

In the input fields, you can enter a valid name or use asterisk (*) as a wildcard to select a name from a selection window.

Field Description
Owner The owner of the symbol table used for symbol replacements within the receiver table.
Symbol Table The symbol table to be used for symbol replacements within the receiver table.
Version

(Symbol Table)

The version of the symbol table to be used.

If you do not specify a version, the unnamed version is used. Specify (unnamed) if you want to use the current version for the current date.

Escape (Read-only field)

The escape character to be used is the global activation escape character.

The value is derived from the global activation escape character. It cannot be modified here.

Events to be Selected

In the Events section of the Global Messages for Events screen, you can specify the events for which messages are to be sent and/or stored in the event store.

Prerequisite: The receiver table must be valid.

You specify the events to be selected by entering Y (Yes) in the input field next to the required events. Events for which N (No) is entered, are not selected.

Events Selected Messages Sent
Monitor Runtime Information Messages are sent each time the Monitor starts or shuts down a task.
Monitor Runtime Errors Messages are sent each time the Monitor error routine is activated due to a Monitor runtime error.
Activation and JCL Load Errors Messages are sent by the Monitor in case of activation errors and JCL load errors.
Latest start time exceeded Messages are sent each time a job was not submitted, before the defined or calculated start time was reached.
Job executing after deadline Messages are sent each time the Monitor detects that a job was not terminated before its defined or calculated deadline time.
Job not ok, or execution error Messages are sent:
  • Each time the Monitor detects that a job ended not ok.

  • If the condition NET-END-NOTOK is set or reset with an active subnetwork. See also Link to the Main Network in the User's Guide.

  • For other job execution errors.

Network or Job not terminated Messages are sent by the network deactivation routine if the active network or job is not terminated.

In this case, the active jobs will be deactivated if the retention period for active jobs is reached.

Awaiting Symbol Prompting Messages are sent each time the Monitor detects that at least one symbol is to be prompted for network activation.
Symbol not found Messages are sent each time a symbol cannot be found and cannot be handled successfully by the "symbol not found" exit.
Calendar undefined for year Messages are sent each time Entire Operations detects that a calendar is undefined for the current or the next year.
Node Errors Messages are sent by the Monitor if errors occur during node access.
Execution time threshold reached Messages are sent if a job runs three times longer than the estimated elapsed time defined for the job in the Scheduling Parameters window (see the section Schedule Maintenance in the User's Guide).

Special PF Keys: Global Messages for Events

PF Key Name Function
PF6  RcvTa Receiver Table. Use this PF key to open and modify the receiver table.
PF7  Symb Symbol Table. Definition of symbols to be used in message receiver definitions.

You can view and modify all symbols defined for the specified symbol table.