Using the Command Line Program icmon 

Purpose

You can monitor and manage both the SAP Web dispatcher and the Internet Communication Manager (ICM) with the command line program icmon.

Only use icmon should it really be necessary. SAP recommends Using the Web Administration Interface.

The most important functions of icmon are described belo.

Prerequisites

The SAP Web dispatcher or ICM is running. In the following <profile> refers to the name of the profile file that the SAP Web dispatcher or ICM was started with.

You are logged on at operating system level to the computer where the Web dispatcher or ICM is running.

Process Flow

If you started the program icmon with icmon 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.

Tracing

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

Changing the Trace Level Using Signals

First find out the process ID (PID) of the SAP Web dispatcher. You can then use command kill ‑USR2 <WebDisp PID> 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>.

Changing the Trace Level Using icmon

Start icmon with icmon pf=<profile>

To increase the trace level, select +.

To reduce the trace level, select -.

Resetting the Trace File

●     You can reset the trace file while the system is operating:

...

       1.      Start icmon with icmon pf=<profile>

       2.      Choose m. The main menu appears.

       3.      Choose m again an answer the question Do you really want to attach to SAP Web Disp? with y.

       4.      Choose r (reset trace file).

The content of the trace file is then lost and you will see the entry:

[Thr 1860] TRACE FILE TRUNCATED

Maintaining the Authentication File

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 passwd of existing user in set: Change user’s password

c - change passwd of existing user in set: Change user’s group

x - change client cert data of existing user in set: Change user’s client certificate (see Using Web Administration Interface with X.509 Certificate)

d - delete user from set: Delete 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 – menue: go to menu

User for the Web Administration

If you do not have user for the Web Administration Interface, you can create one with icmon. See Create Administration Users.