Skip to end of metadata
Go to start of metadata

Purpose

When using a Java system, or a Standalone Gateway running on Central Services application server (ASCS/SCS), you may need to use 'gwmon' tool in order to monitor and perform actions over Gateway functionality (similar which what can be done with SMGW transaction).

This process has different names:
  UNIX: gwmon
  Windows: gwmon.exe

How to check if there's a Standalone Gateway running on an application server?

Executing command:
  sapcontrol -nr $$ -function GetProcessList
where $$ corresponds to instance number.

hostname:sidadm > sapcontrol -nr $$ -function GetProcessList

name, description, dispstatus, textstatus, starttime, elapsedtime, pid
disp+work, Dispatcher, GREEN, Running, <date> <time>, …, DISP_pid
igswd_mt, IGS Watchdog, GREEN, Running, <date> <time>, …, IGS_pid
gwrd, Gateway, GREEN, Running, <date> <time>, …, GW_pid

 If the Standalone GW is running on ASCS/SCS, output will show something similar to:

hostname:sidadm > sapcontrol -nr $$ -function GetProcessList

name, description, dispstatus, textstatus, starttime, elapsedtime, pid
msg_server, MessageServer, GREEN, Running, <date> <time>, …, MS_pid
enserver, EnqueueServer, GREEN, Running, <date> <time>, …, ENQ_pid
gwrd, Gateway, GREEN, Running, <date> <time>, …, GW_pid

How to use ‘gwmon’ tool to monitor Standalone Gateway?

Command to start this tool is:
   >> gwmon pf=<path_to_GW_profile>

for instance, it should be:
   gwmon pf=/usr/sap/<SID>/SYS/profile/<SID>_ASCS$$_<hostname>

You will get main output, showing Gateway monitor, connected to hostname /sapgw$$

You generally exit the gateway monitor with q, and use m to go to the (next higher) menu.
If you enter option m (menue) and press Enter, it will display “Main menue”, where different options can be selected:

  1. display connection table
    You can display Active CPI-C Connections, similar to output from SMGW transaction.
    The header specifies the size of the connections table and the current number of entries.
    Attributes displayed for each active connection are explained on wiki page "Displaying Active CPI-C Connections".

  2. display work process table

  3.  display client table
    Here, we can display Logged On Clients (same information that we could extract with SMGW, Goto > Logged On Clients).
    Values displayed for each client logged on to the gateway, detailed on"Displaying Logged On Clients" online help.

    When we want to identify
    if a program has been successfully registered on this Gateway,

    option 3 will show us program registered (TYPE = REGISTER_TP) with TP name that was used for the registration.


  4. display remote gw table
    Remote Gateways table is shown, with similar values displayed for each remote Gateway (like on clients table). In this case TYPE will be REMOTE_GATEWAY.Inputs 5 and 6 lead to submenus that provide functions for the relevant areas.

  5. connection attributes
    It provides deeper options regarding connection attributes. In this submenu you can display details of the CPI-C connections from the basic list:

    Each submenu option is detailed on "Connection Attributes" wiki page.

  6. statistics menu
    Allows you to check the performance of the Gateway. You can activate and deactivate these statistics dynamically. The statistics display covers the areas, general statistics, gateway reader statistics, and TCP statistics.


  7. gateway parameters and attributes
    This option can be used to display parameters and attributes of the Gateway, as well as their values. Typically, those parameters start with ‘gw/…’. Use option e to scroll to end of the list.

  8.  gateway release info

  9. security information
    This option should be used in order to handle Gateway security files, reginfo and secinfo, that are used to allow/deny programs to register or be executed on this Gateway.

    Reginfo file is used for external programs that register in the GW, while secinfo file is used to start external programs which do not register.
    Whenever those files are changed, they need to be reloaded (option 4 : refresh security), so that new rules are used. This allows the security information to be modified during the runtime.
     
  10. expert functions
    Option 10 gives us much more functionality, all of them explained here.

     
    - Gateway trace file can be reset with option 7. This may be useful when we need to remove previous information and start tracing any error we may need to analyze.
    Note that Gateway trace (called dev_rd, and normally located under work folder) can be increased and reduced using options from Main menue:
     + : increase gateway trace
     - : decrease gateway trace

    You can dump current information about connection table, client table, WPs table or remote Gateways. This allows to get deeper information on each option.

    Option 23, should be used to de-register (cancel) a registered program.

    This way, whenever program is registered again, new rules from reginfo will be used.


 

 

 

 

 

  • No labels