This document covers the following topics:
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.
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.
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.
|
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 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: |
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. |
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.
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.
|