Monitor Management

This section covers the following topics:


What is the Monitor?

The Monitor is that component of Entire Output Management which performs all the work of generating, printing and distributing reports and bundles.

It runs as a Natural subtask under Entire System Server or as a batch job.

Invoking Monitor Management

Start of instruction set To invoke Monitor Management:

  • Enter 6 in the command line of the System Administration menu.

    The Monitor Management screen is displayed:

      17:14:52             **** ENTIRE OUTPUT MANAGEMENT ****            2015-09-11
     User ID XYZ                - Monitor Management -                             
                                                                                   
                                                    Status  Idle                   
                                                        at  17:14:15  2015-09-11   
        S Start Monitor                                                            
        C Close Monitor                                                            
        L Display Monitor Log                                                      
        D Display Monitor Log by Date/Time                                         
        P Purge Monitor Buffer Pool                                                
        E Purge a single Buffer Pool Entry                                         
                                                                                   
                  +-------------------------------------------------+              
                  :   ----------  Main Task Parameters  ----------- :              
                  :   Monitor Node ........ 40                      :              
                  :   Minimum Wait ........ 10__       (in seconds) :              
                  :   Maximum Wait ........ 50__       (in seconds) :              
                  :   Wait Increment ...... 5___       (in seconds) :              
                  :   Current Wait ........ 60         (in seconds) :              
                  +-------------------------------------------------+              
                                                                                   
     Command => ___________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit  Flip                    Tasks       Wake        Menu  
    

    It shows the monitor status and the date/time when the Monitor was last active.

The available functions are described below.

You can change the Main Task Parameters as described under Modifying the Monitor Parameters.

Monitor Status

The monitor status can be one of the following:

  • Abended

  • Analyse Report Sources

  • Closed

  • Create Active Reports

  • Delete Active Reports

  • Export Objects

  • Idle

  • Inactive

  • Initializing

  • Load Source into NOM DB

  • Process bundles

  • Process printouts

  • Process SPOOL queue

  • Purge expired archive

  • Purge expired bundles

  • Purge expired logs

  • Purge expired printouts

  • Purge expired reports

  • Recovering from Error

  • Shutdown in progress

  • Start ARCHIVE

  • Start CONDENSE

  • Start REVIVE

Modifying the Monitor Parameters

Start of instruction set To modify the monitor parameters:

  1. Enter 6 in the command line of the System Administration menu.

    The Monitor Management screen is displayed, showing the monitor parameter settings.

  2. These main task parameters are explained below. You can change their settings as desired.

Main Task Parameters

Parameter Explanation
Monitor Node The node under which Entire Output Management is running.
Minimum Wait The minimum time (in seconds) the Monitor is to wait between two consecutive monitoring cycles. You can modify this value by entering a new value.
Maximum Wait The maximum time (in seconds) the Monitor is to wait between two consecutive monitoring cycles. You can modify this value by entering a new value.
Wait Increment The number of seconds by which the wait time increases. If there is no activity during the minimum wait time, the wait time is increased by this value, until the maximum is reached. When activity occurs, the wait time returns to the minimum. You can modify this value by entering a new value.
Current Wait The wait time in effect for the current cycle (in seconds).

See also Wait Factor under Monitor Defaults.

Starting the Monitor

To start the Monitor, the Entire System Server node specified for start must be active.

Start of instruction set To start the Monitor:

  • Enter an S in the command line.

    A message confirms the start, and the Monitor status changes accordingly.

Waking the Monitor

To activate the Monitor before the next scheduled activity cycle, see Wait parameters under Main Task Parameters.

Start of instruction set To activate the Monitor:

  1. Press PF10 (Wake) on the Monitor Management screen.

    The Monitor is activated.

  2. When you press ENTER, the at field (see above) displays the time when the Monitor became active.

If there was any pending work, the Monitor status changes. When the activity cycle is completed, the Monitor status changes back to "Idle".

Closing the Monitor

Start of instruction set To close the Monitor:

  1. Enter a C in the command line of the Monitor Management screen.

  2. A window is displayed, in which you enter SHUTDOWN to confirm the shutdown.

The Monitor status changes to "Shutdown In Progress". This means that the Monitor has not yet detected the close, since it is in wait status. The next time it is active, the Monitor detects the close and performs the normal close. The status then changes to "Closed".

Displaying the Monitor Log

Note:
For a user without administrator status to use this function, the option "Display Monitor Log" must be set to "Y" on his/her User Profile Definition screen.

Start of instruction set To display the monitor log:

  1. Enter one of the following commands in the command line of the Monitor Management screen:

    • L - to display the monitor log records in descending chronological order (most recent event first).

    • D - to display the monitor log records in ascending chronological order (oldest event first).

    A list of all monitor log records is displayed.

  2. If you have invoked the list with D, you can make date/time specifications on the screen to restrict the range of records listed.

  3. To display more information about a log entry, enter the command IN in the command line preceding the entry.

See also LO under Commonly Used Line Commands in the User's Guide.

Suppression of Identical Log Messages

Sometimes errors require user intervention. The monitor will try to re-execute its tasks each monitor cycle. To reduce logging during such transient error situations, repeated identical log messages will be automatically suppressed using the following pattern:

  • Identical messages 1 to 9 are written to the monitor log as usual.

  • Message 10 is preceded by a warning that future identical messages will be suppressed.

  • The next identical messages which are written to the log (reminders) are 20, 30, 40, … 100, 200, 300, … 1000, 2000, 3000, … .

  • The suppression of duplicates is reset whenever the monitor task is restarted. In addition, duplicates are not suppressed if there is a delay of 23 hours or more between occurrences.

Retrieving the Monitor Log in Batch Mode

The monitor log can also be retrieved in batch mode using the utility NOMLOG.

Start of instruction setTo do so:

  1. Create a batch job, start Natural, and log on to the library SYSNOM.

  2. Invoke the NOMLOG utility with the following parameters:

    NOMLOG <yyyymmdd> <hhmm> <YYYYMMDD> <HHMM> <L> <T> <H> [<text>]
    Parameter Explanation
    <yyyymmdd> From year (yyyy) month (mm) day (dd).
    <hhmm> From hour (hh) minute (mm).
    <YYYYMMDD> To year (YYYY) month (MM) day (DD).
    <HHMM> To hour (HH) minute (MM).
    <L> Language (1 = English, 2 = German).
    <T> L = Log data only, T = Trace data only, B = Both log and trace data.
    <H> Write titles (Y/N). Specify N if you want to subsequently process the output with user utilities.
    <text> A word for full text research (optional); only the messages containing this word will be printed.

Purging the Monitor Buffer Pool

Start of instruction set To purge the monitor buffer pool:

  1. Enter P in the command line of the Monitor Management screen.

    All entries in the Natural Buffer Pool are purged.

Purging a Single Buffer Pool Entry

Start of instruction set To purge a single buffer pool entry:

  1. Enter E in the command line of the Monitor Management screen.

    A window is displayed.

  2. In this window, you enter the data for the object to be purged:

    Field Explanation
    Library Enter the name of the library where the object to be purged is located.
    Object Enter the name of the object to be purged.
    DBID Enter the ID of the database where the object to be purged is located.
    FNR Enter the file number of the object to be purged.

    The object specified will be purged from the Monitor Buffer Pool.

Starting and Stopping the Monitor Trace

As monitor performance is significantly worse when tracing is active, you should only activate it under the direction of Software AG Support personnel.

Start of instruction set To start the monitor activity trace:

  1. Enter the command TRACE ON or T+ in the command line of the Monitor Management screen.

    A message is written to the monitor's output file to record that tracing was started.

The number of program levels to be traced is determined by the trace level specified in the job cards of the Monitor Defaults. If the job cards contain no level restriction, the trace activated by TRACE ON or T+ will be across all levels.

Start of instruction set To stop the monitor activity trace:

  1. Enter the command TRACE OFF or T- in the command line of the Monitor Management screen.

    A message is written to the monitor's output file to record that tracing was stopped.

Managing the Monitor Tasks

This function is used to see the current status of the monitor subtasks.

Start of instruction setTo list the monitor subtasks:

  • Press PF8 (Tasks) on the Monitor Management screen.

    The Monitor Task Management screen will be displayed, providing the following information on the monitor subtasks:

    Field Explanation
    # Task number 01 to 05.
    Task Status Current task status.
    Action Processing performed by the task.
    Last Active Date and time the task was last active.
    Wait Factors (Min, Max, Incr, Curr) The Minimum, Maximum, Increment and Current wait times for the task. You can change these values (except Current) by pressing PF8 and then overwriting the values.

    See also Subtask Processing under Monitor Defaults.

    Line Commands

    The following line commands can be entered in the Cmd field next to a task:

    Command Function
    C Close the task. If you close task 1, all subtasks will be closed. For any other subtask, task 1 will take over its work.
    W Wake the task to perform its processing cycle.
    P Purge the Natural buffer pool of the task.
    E Purge a single object from the Natural buffer pool of the task.
    L Display log entries for the task.
    + Activate monitor trace for the task.
    - Deactivate monitor trace for the task.