These are functions within the gateway that only users with the relevant expertise should execute. These functions are explained below.
You must gave started the gateway monitor gwmon with the option –expert.
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
-->
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.
You can display the contents of a request block. To do this you must enter its number.
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.
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.
This function writes the contents of the NI buffer to the trace file dev_rd.
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.
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.
This function is the same as menu option Display.
This function displays all the information available on a system logged on to the gateway.
This function displays all the information available on gateway processes.
This function displays all the information available about a gateway logged on to this gateway.
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
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"
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"
This function changes gateway parameters while the gateway is running (see Changing Gateway Parameters).
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.
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.
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.
Connections opened by other gateways can be closed. If a CPIC/RFC connection to this client exists, this connection is closed of course.
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.
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).
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) .
The statistics are displayed provided they have been activated. See also Gateway Statistics.
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) .
This function closes the gateway in a controlled manner. If there are still active connections in the gateway, the gateway is not terminated.
This terminates the gateway immediately. No other checks are made.