Monitor Client NATMOPI

This document covers the following topics:


Introduction

The Monitor Client NATMOPI is a character-based command interface for monitoring the various types of servers that are provided in a mainframe Natural environment. Each of these servers has its own set of monitor commands which is described in the corresponding server documentation. In addition, a set of directory commands is available which can be used independent of the server type. One NATMOPI can be used to monitor different server types.

Prerequisites for NATMOPI Execution on BS2000/OSD

Execute NATMOPI with the following SMARTS console command:

/INTR <SMARTS-tsn>,NATMOPI <mopi-command>

where SMARTS-tsn is the TSN of your SMARTS main task.

Example:

/INTR 4711,NATMOPI -dls

The output is written to the SYSOUT file of the FSIO task.

Note:
The server to be monitored must be running in the same SMARTS environment as NATMOPI.

Command Interface Syntax

Basically the syntax of the command interface consists of a list of options where each option can/must have a value. For example:

-s <server-id> -c help

where -s and -c are options and <server-id> and help are the option values.

It is possible to specify multiple options, but each option can have only one value assigned.

The command options available are listed below.

Command Options Available

Words enclosed in <> are user supplied values.

Command Option Action
-s <server-id> Specify a server ID for sending a monitor command. If the server ID is not unique in the server directory, NATMOPI prompts the user to select a server.
-c <monitor command> Specify a monitor command to be sent to the server ID defined with the -s option
-d <directory command> Specify a directory command to be executed.
-a Suppress prompting for ambiguous server ID. Process all servers which apply to the specified server ID.
-h Print NATMOPI help.

Monitor Commands

These are commands that are sent to a server for execution. The monitor commands available depend on the type of server, however, each server is able to support at least the commands ping, terminate and help. For further commands, refer to Operating the Web I/O Interface Server where the corresponding server commands are described.

Directory Commands

Directory commands are not executed by a server, but directly by the monitor client NATMOPI.

You can use the directory commands to browse through the existing server entries and to remove stuck entries.

The following directory commands are available. Words enclosed in <> are user supplied values and words enclosed in [ ] are optional.

Directory Command Action
ls [<server-id>] List all servers from the server directory that apply to the specified server ID. The server list is in short form.
ll [<server-id>] Same as ls, but the server list contains extended server information.
rs [<server-id>] Remove server entries from server directory.

Note:
If you remove the entry of an active server, you will loose the ability to monitor this server process.

cl [<server-id>] Clean up server directory. This command pings the specified server. If the server does not respond, its entry will be removed from the directory.
ds Dump the content of the server directory.
lm List pending IPC messages.

Command Examples

Example: Ping a Server in Different Environments

Server in z/OS (SMARTS/Com-plete), output in STDOUT:

  • System operator:

    /F complete-jobname,NATMOPI -sServerName -cPING
  • Com-plete online command:

    NATMOPI -sServerName -cPING

Server in z/OS (started task or batch mode):

  • Execute NATMOPI in batch job:

    NATMOPI,PARM=('-sServerName -cPING')

    Sample job:

    //SAGMOPI  JOB  SAG,CLASS=K,MSGCLASS=X                       
    //NATEX EXEC PGM=NATMOPI,REGION=3000K,                       
    // PARM=('-Sname -CPING')                                  
    //* PARM=('-H')                                              
    //STEPLIB  DD DISP=SHR,DSN=NATURAL.XXXvr.LE.LOAD         
    //         DD DISP=SHR,DSN=CEE.SCEERUN                       
    //SYSOUT   DD   SYSOUT=X
    //SYSPRINT DD   SYSOUT=X                                     
    //*                                                          
    

    Where XXX is the Web I/O Interface server product code (NWO) and vr is the two-digit product version.

  • Execute NATMOPI in TSO (Command):

    NATMOPI -sServerName -cPING

    The NWO load library must be included in the steplib of TSO.

Server in z/VSE (SMARTS/Complete):

  • System operator:

    (vse-replid) NATMOPI -sServerName -cPING
  • Com-plete online command:

    NATMOPI -sServerName -cPING

Further Command Examples:

natmopi -dls
List all servers registered in the directory in short format.
natmopi -dcl TST -ls TST
Clean up all servers with ID TST* (ping server and remove it, if it does not respond), and list all servers with ID TST* after cleanup.
natmopi -sSRV1 -cping -sSRV2 -sSRV3 -cterminate
Send command ping to SRV1. Send command terminate to SRV2 and SRV3.
natmopi -cterminate -sSRV1 -cping -sSRV2 -sSRV3
Is equivalent to the previous example. That is, NATMOPI sends the command following the -s option to the server. If no -c option follows the -s option, the first -c option from the command line will be used.
natmopi -sSRV1 -cterminate -a
Send command terminate to SRV1. If SRV1 is ambiguous in the server directory, send the command to all SRV1 servers without prompting for selection.