Expert Functions

Use

These are functions within the gateway that only users with the relevant expertise should execute. These functions are explained below.

Prerequisites

You must gave started the gateway monitor gwmon with the option –expert.

Features

The submenu below will be displayed:

expert functions

-------------------------------------------------------------------

  1 : memory usage

  2 : request block

  3 : reset error counter

  4 : reset all error counter

  5 : reset NI buffer

  6 : dump NI buffer

  7 : reset trace file

  8 : activate   external program trace

  9 : deactivate external program trace

 10 : dump connection table

 11 : dump client table

 12 : dump work process table

 13 : dump remote gateway table

 14 : dump gateway's release notes

 15 : tail trace file

 16 : edit trace file

       20 : change gateway parameter

   21 : cancel registered programs

   22 : count registered programs

   23 : cancel client

   24 : cancel remote gateway

   25 : dump load balancing table

   26 : display ni buffer

   27 : display started & check programs

   28 : enable restart of a started programs

   29 : disable restart of a started programs

   30 : change to cmdline mode

   31 : display ip adress(es)

   32 : display statistics

   33 : display wp state

   34 : activate client trace

   35 : deactivate client trace

   36 : activate remote gw trace

   37 : deactivate remote gw trace

   38 : display conversation id table

   98 : hard shutdown

   99 : soft shutdown

  q - quit

  m - Menu

-->

Displaying Memory Allocation

The header line displays the maximum number of request blocks, the number of requests blocks currently occupied, and the maximum number of request blocks occupied up to now. The current memory allocation (that is, all locked request blocks) is displayed. The number of each request block and the process which is currently using it are also displayed.

Displaying Memory Contents

You can display the contents of a request block. To do this you must enter its number.

Reset the IBM Error Count

If the gateway is running on IBM, connections where errors have occurred are marked with an error count, and not used again until the counter has been reset to 0 (with each initialization to the same partner the counter is decreased by 1). The counter can also be reset to 0, in the background or interactively, using gwmon. In dialog you choose the function "reset error count" from the expert menu, then you can specify the number of the connection you want to reset, or specify “all”. When gwmon -e <nr> pf=... or gwmon -e all pf=. is called the error count can be reset in the background for one connection or for all connections. gwmon terminates afterwards.

Reset NI Buffer

This function resets the NI buffer (it buffers the host name or IP address and the service name). This means that all buffered entries are deleted from the buffer. See also the host name buffer functions in Expert Functions of the gateway monitor in the SAP System.

Dump NI Buffer

This function writes the contents of the NI buffer to the trace file dev_rd.

Reset Trace File

This function resets the trace file. If the trace file has become too big, for example, due to an error analysis, the file can be reset.

Activating/Deactivating Tracing for External Programs

This function informs programs started by the gateway to trace their program flow. This function is required for error analysis. The file CPICTRC is created in the working directory.

Display Entry in Connection Table

This function is the same as menu option Display.

Display Entry in System Table

This function displays all the information available on a system logged on to the gateway.

Display Entry in Work Process Table

This function displays all the information available on gateway processes.

Display Entry in Remote Gateway Table

This function displays all the information available about a gateway logged on to this gateway.

Displaying Release Notes

This function displays release notes on the gateway. This function is the same as the -V option in the gateway. See also Displaying Gateway Release Information

Display End of Trace File

 This function is for UNIX only.

The function displays the last lines of a file.

This function can be controlled with the following environment variables:

·        XTERM_CMD : Command for creating a new window. Default: "xterm -bg BLUE -T \"%s\" -e %s &"

·        TAIL_CMD  : Command for displaying the last lines of a file. Default: "tail -f %s"

Display Trace File in the Editor

This function is for UNIX only.

The function displays a file in the editor.

This function can be controlled with the following environment variables:

·        XTERM_CMD : Command for creating a new window. Default: "xterm -bg BLUE -T \"%s\" -e %s &"

·        EDITOR_CMD: Default command for starting an editor: "vi %s"

Change Gateway Parameters

This function changes gateway parameters while the gateway is running (see Changing Gateway Parameters).

Exit Registered Programs

This function closes registered programs. This function is also used internally in the gateway, when it terminates. Registered programs, which are waiting for a connection, are assigned the return code 18, CM_DEALLOCATED_NORMAL. A registered program that is running cannot be closed with this function.

Count Registered Programs

This function counts registered programs.

The number of registered programs with their statuses are displayed.

enter tpname : testtp

count registered program testtp

total   = 1

init    = 0

waiting = 1

running = 0 .

You can see how many registered programs there are in each status.

Exit Clients

Connections controlled by the gateway (external C programs, registered programs, remote gateways) can be closed. If a CPIC/RFC connection to this client exists, this connection is closed of course. 

Exit Remote Gateway

Connections opened by other gateways can be closed. If a CPIC/RFC connection to this client exists, this connection is closed of course.  

Display Load Balancing Table

This function displays the list of IP addresses defined for a weighting value. Each line consists of the following entries:

Index, weighting factor, and an IP address, whereby areas can also be specified with wild cards.

For more information about load balancing see Load Balancing for Registered Programs.

Display NI Buffer

This displays the contents of the host name buffer.

If the status is UNKNOWN, this may have the following causes:

·        IP address cancelled  ®  host name failed

·        Host name resolution  ®  IP address failed

·        Service name resolution  ®  Port number failed

The trace file contains more information (see Error Analysis).

Display Gateway IP Addresses

This function displays the IP addresses of the gateway. 

 

Gateway monitor, connected to binmain / 3353

Gateway's own ip adresses

----------------------------------------------

[10.17.68.123] ls0302 (HOSTNAME)

[127.0.0.1] localhost (LOCALHOST)

[10.17.4.228] ls0302b.wdf.sap-ag.de (NILIST) .

Display Statistics

The statistics are displayed provided they have been activated. See also Gateway Statistics.

Activate and Deactivate Traces

The functions are the same as those in the gateway monitor in the SAP System, see Activating Traces.

Display conversation ID table

A table containing conversation IDs with additional information is displayed.

Gateway monitor, connected to ld0004 / sapgw04

gateway - conversation id table

-----------------------------------------------------------

65407549 : local, conn=57

65287481 : remote, us7211.wdf.sap.corp / sapgw04 (gw_id=1)

64085539 : remote, us7211.wdf.sap.corp / sapgw04 (gw_id=1)

63980260 : remote, us7211.wdf.sap.corp / sapgw04 (gw_id=1)

63979858 : remote, us7211.wdf.sap.corp / sapgw04 (gw_id=1) .

Soft Shutdown

This function closes the gateway in a controlled manner. If there are still active connections in the gateway, the gateway is not terminated.

Hard Shutdown

This terminates the gateway immediately. No other checks are made.