IBM Support

Navigator for i - Monitors

News


Abstract

General monitor information applicable to both Message and System Monitors

Content


Monitors Overview

Available on the new IBM Navigator for i 7.3 and later releases

Introduction

Monitors provide a tool for you to watch for the occurrence of messages on your system and carry out predefined actions when a specific event occurs. Monitors continue to monitor and perform any commands or actions you specified as a threshold until you stop the monitor.

Sections:

  • Overview
  • Authority
  • Stop Monitor Server
  • Monitor stuck in state of "Stopping"
  • Implementation Details
    • Debug files

Overview

IBM Navigator for i provides the following types of monitors:

Collect and display performance data as it happens. System monitors use Collection Services data to track the metrics of system performance that you select. Detailed graphs help you visualize what is going on with your system as it happens. Choose from various metrics (performance measurements) to pinpoint specific aspects of system performance.  
  • Message monitor

Find out whether your application completes successfully or monitor for specific messages that are critical to your business needs. You can see the details of a message, reply to a message, send a message, delete a message, and view or change the properties of a message.

Under the Monitors folder in the navigation area, users can access the system & message monitor lists.  From the message lists, users can create, modify, start, or stop a monitor, and also can view event log list. .

Monitors action icon menu


Authority

If a userid does not have *ALLOBJ authority (that is, User Class *SECOFR authority with *ALLOBJ removed), it needs to be added to the QNAVMNTR (new) authorization list.

Adding to the authorization list is done with the IBM Navigator for i GUI interface or through the green screen command line: ADDAUTLE AUTL(QNAVMNTR) USER(<usrprf>) AUT(*ALL)

For more detail, see: Authority for Monitors in Navigator


Stop Monitor Server

Use the "Stop Monitor Server" action to end the server before you apply PTFs. 

Stop Monitor Server

Figure 11


Copy a Monitor to another System

You can use the "Copy to System" function to copy a specific monitor to any system listed in the Target System List. Monitors Action > Copy to System

Figure 12

Select a system and click OK.

List of systems

Figure 13



Replacement Variables

Replacement variables are available for both System & Message monitors.  

Use these links for more information:


Monitor stuck in state of "Stopping" or "Starting"

The starting/stopping status may occur in the following cases:

1) The system has a new PTF applied or anything that changed the monitor.jar.

If the monitor server job is not restarted, this may cause unexpected behaviors.  Unexpected behavior could including the  monitors failed while starting or stopping (thus showing it stuck in a state).  If this happens, restart the monitor server.  The monitor server should be restarted every time the monitor.jar file is updated.

2) Some categories in collection service are configured, but they are not supported for system monitor.  This can happen when configuring by CFGPFRCOL command, such as *IOPBASE and *RDMA. This can also cause the system monitor to fail while starting or stopping (and getting left in the starting or stopping state).

If this happens, first reconfigure Collection Services (under the system monitor tab), to remove the unsupported categories.  Then restart the monitor server job.

If it is not one of the two above cases and restarting monitor server does not solve the problem, report to service.  Development will need to look at the log to find out what happened and debug.


Implementation Details:

Auto restart is supported for system and message monitors. 

In the IBM i 7.4 IBM Documentation page, it indicates that the monitors do not auto-start because at release time auto-start was not supported.  This statement is incorrect and will be changed in the next release IBM Documentation page.

A user can modify a started system or message monitor.

Design details for monitors functionality

A daemon job QNAVMNSRV (new Navigator) is introduced to provide a monitor service for IBM Navigator for i, which includes data collection and a programmable interface for accessing the data. 

These are the details on the directories and programs:

  • 1.  /QIBM/UserData/Os400/Navigator/config/MONITOR contains log & trace files for job QNAVMNSRV
  •                • monitor.log, stderrA.txt, stderrB.txt, stdoutA.txt, stdoutB.txt
  • 3.  A service program: /QSYS.LIB/QSYSDIR.LIB/QNAVSWUSR.SRVPGM
  • 4.  A program: /QSYS.LIB/QSYSDIR.LIB/QNAVMNSRV.PGM
  • This program is used to start or stop job QNAVMNSRV. Normally, this job is started automatically when IBM Navigator for i is started. The job continues running when IBM Navigator is stopped. It can be stopped explicitly by this command (for new Navigator):
  •     CALL PGM(QSYSDIR/QNAVMNSRV) PARM(*STOP)
  • Note: Call this command to end the job QNAVMNSRV before you apply a new PTF. Alternatively, you can End the Monitor Server with the Action command

Debug files for System Monitors:

Before you report any problems related to system monitors, collect these files before you make any changes to your system to preserve the debug information:

1) In /QIBM/UserData/OS/ADMININST/admin1/wlp/usr/servers/admin1/logs 

  • messages.log is the file to look at for Navigator errors

2) For system monitor specific errors, go to "Serviceability" and select "View GUI Logs" to display all the log files for the Navigator GUI:

Serviceability -> View GUI Logs

  • Open the monitor files at location /QIBM/UserData/OS400/Navigator/config/MONITOR
  • Files:
  1. navMonStderrA.txt
  2. navMonStderrB.txt
  3. navMonStdoutA.txt
  4. navMonStdoutB.txt

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CH1AAM","label":"IBM Navigator for i"}],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3.0;7.4.0;and future releases"}]

Document Information

Modified date:
06 June 2022

UID

ibm16561883