Show TOC

Using the Gateway Monitor Outside the SAP SystemLocate this document in the navigation structure


The gateway monitor is used to analyze and administer the Gateway from outside the SAP system.

The profile you assign to it must be the same as for the gateway.

This process has different names:

UNIX: gwmon

Windows: gwmon.exe


The trace file of the gateway monitor is called: dev_gwmon.

The functionality is the same as that of the Gateway Monitor in the SAP system, the only difference being the menu and submenus.

The detailed information displayed by double-clicking a connection in the SAP system is available here under the Expert Functions.


When you launch the gateway monitor without arguments, all of the permitted arguments and options are displayed:



pf=<profile>      :

Specify name of parameter file or

System number

Specify the profile file or

Specify the number of the system



Print release

Print release

[-refresh n]:

Refresh after n seconds

Refresh after n seconds

[-gwhost host]:

Host name of remote gateway

Host name of the remote gateway

[-gwserv service]:

Service of remote gateway

Service name of the remote gateway


enable expert functions

Enable expert functions


Suppress headers

Suppress headers

[-cmdfile file]

Execute commands from cmdfile

if filename '-' read from stdinv

Execute commands from the file. You can display the possible commands, when you enter - as the file name and then choose help.

The individual functions are grouped into separate submenus.

Main Menu

When you enter gwmon -gwhost <host> -gwserv <service>, the list of activate connections on the gateway is first displayed. Under this:

q - quit

m - menu

You generally exit the gateway monitor with q, and use m to go to the (next higher) menu.

If you then enter m and press Return, you reach the main menu:

Screen output


1 : display connection table

Displaying Active CPI-C Connections

2 : display work process table

Display gateway work processes

3 : display client table

Displaying Logged On Clients

4 : display remote gw table

Display the table of remote gateways

5 : connection attributes

Display Connection Attributes

6 : statistics

Display Gateway Statistics anzeigen

7 : gateway parameters and attributes

Display parameters and attributes of the Gateway

8 : gateway release info

Display gateway release information

9 : security information

Display Security Information

10 : expert functions

Expert Functions

+ : increase gateway trace

Increase gateway trace level

- : decrease gateway trace

Decrease gateway trace level

q - quit

Exit gateway monitor

Inputs 4,5,7 and 8 lead to submenus that provide functions for the relevant areas.


To start the gateway monitor, call the corresponding executable file, specifying a profile file:

On UNIX: gwmon pf=<profile>

On Windows: gwmon.exe pf=<profile>

All of the lists are updated after 5 seconds. You can refresh them sooner by pressing Enter.

It is standard to use 50 lines per screen. The number of lines can be changed (for example, under UNIX you can set the shell variable LINES).

Switch command mode

If you use the option -cmdfile <file>, all the functions to be executed are read from the file (see below). If the file name is '-', all the commands from the standard input are read. As a result the monitor can be operated from a program or script to start specific actions or to supply information.


echo GET_CONNTBL | gwmon -cmdfile - -gwhost <gwhost> -gwserv <service> gets the list of active CPIC connections.

The command field interface provides the same functions as the functions from the menu. You can also execute the same function repeatedly.

You can display all the available functions using HELP. If you do not enter anything and choose RETURN, the last command is repeated. HELP [command] displays the online help for the command.