Show TOC

Function documentationExpert Functions Locate this document in the navigation structure

 

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

Prerequisites

You must have 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 infos

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

-->

Display 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.

Display 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.

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.

Activate/Deactivate 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. See the information there.

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.

Display Release Notes

This function displays release notes on the gateway. This function is the same as the -V option in the gateway.

Display End of Trace File

Caution Caution

This function is for UNIX only.

End of the caution.

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, default: vi %s

Change Gateway Parameters

Using this function you can change the gateway paramaters in running operation.

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.

Example Example

enter tpname : testtp

count registered program testtp

total = 1

init = 0

waiting = 1

running = 0

End of the example.

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:

  • Resolution of IP address for host name failed

  • Resolution of host name for IP address failed

  • Resolution of service name for port number failed

The trace file contains more information.

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.

You can display or download the trace file, and change the trace level.

Display conversation ID table

A table containing conversation IDs with additional information is displayed.

Example Example

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) .

End of the example.
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.