Monitor Client NATMOPI

This document covers the following topics:

Introduction
Prerequisites for NATMOPI Execution on BS2000/OSD
Command Interface Syntax
Command Options Available
Monitor Commands
Directory Commands
Command Examples

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.