You can monitor and manage both the SAP Web dispatcher and the Internet Communication Manager (ICM) from the command line program. You use program icmon for the ICM, and wdispmon for the SAP Web Dispatcher.
Note
Both programs have exactly the same functions. To make things simple the following sections refer always to icmon, but all functions are valid for wdispmon too. Two programs are required to ensure the release/patch level and codepage can be used for the ICM or Web Dispatcher, for the case that they have different release statuses.
Recommendation
We recommend that you use the Web Administration Interface and ICM Monitor for administration of the Web Dispatcher and ICM. Only use the command line programs if this is not possible.
The most important functions of icmon are described below.
The SAP Web dispatcher or ICM is running. In the following, <profile> refers to the name of the profile file with which the SAP Web Dispatcher or ICM was started.
You are logged on at operating system level to the computer where the Web dispatcher or ICM is running.
If you started program icmon with cmon pf=<profile>, you will see configuration and statistical data of the SAP Web Dispatcher, and a snapshot of the thread activity.
Some of the functions that you may need are described below in brief.
The trace file of the SAP Web Dispatcher is called dev_webdisp and is located in the directory of the SAP Web Dispatcher. You can change the trace level using signals or the icmon.
First find out the process ID (PID) of the SAP Web dispatcher. You can then use command kill USR2 <PID des WebDisp> to increase the trace level by one, or kill USR1 <pid> to reduce it. By default, the trace level is set to 1. In Windows you use sapntkill USR2 <pid> or sapntkill USR1 <pid>.
Start icmon with icmon pf=<profile>
To increase the trace level, select +.
To reduce the trace level, select -.
You can reset the trace file while the system is operating:
Start icmon with icmon pf=<profile>
Choose m. The main menu appears.
Choose m again, and answer the question Do you really want to attach to SAP Web Disp? with y.
Choose r (reset trace file).
Caution
The content of the trace file is then lost and you will see the entry:
[Thr 1860] TRACE FILE TRUNCATED
You can use icmon -a to maintain the authentication file (default: authfile.txt). If you have confirmed or changed the file name, you will see the menu below:
a - add user to set: Create new user (see below)
c - change password of existing user in set: Change a user’s password
g - change group of existing user in set: Change a user’s group
x - change client cert data of existing user in set: Change client certificate of a user (see Using Web Admin Interface with X.509 Certificate)
d - delete user from set: Delete a user
l - list users of set: List all users
s - save changes of set to file: Save changes
q - quit (without saving): Quit without saving
m – menu: Go to menu
If you do not have user for the Web Administration Interface, you can create one with icmon. See Create Administration Users.