Monitoring the Status of the ICM

The ICM monitor (transaction SMICM) provides various functions for monitoring the status and configuration of the ICM and for detecting any possible errors.

Features

You can find the functions described here in the Goto menu.

Trace Files

Using Goto Trace File or Goto Trace Level , you can display the trace file dev_icm, reset it, or set the trace level (values between 0 and 3 are possible, default is 1). You can also display just the start or the end of the file (the first or last 1000 lines). This is a very useful function for large files. Choose Goto Trace File Display Start or Display End.

You can download the trace file on to your local computer, which is very useful for large files or if you want to store a file or reuse it later. To do this choose Goto Trace File Save File Locally .

Security Log

To view the security log, choose Goto Trace File Security Log Display . You can also download the security log and display general information about it.

dev_icmbnd

If you want to view the trace file of the external binding program icmbnd, choose Goto Trace File Display Dev_icmbnd

Parameters

Choose Goto Parameters to display or change the ICM profile parameters. If you choose Change, you can display the RZ11 documentation for every parameter that is executed by placing the cursor on the parameter name and choosing Documentation (Documentation).

The value field is ready for input for those parameters that can be changed dynamically.

Caution Caution

Note that with dynamic changes, these are lost the next time the instance is started.

End of the caution.

Statistics

Choose Goto Statistics to activate, deactivate, display, and reset the ICM statistics.

Memory Pipes

Choose Goto Memory Pipes for information on the memory pipes that are used for data exchange between the ICM and the work process.

Host Name Buffer

The mapping of host names to IP addresses or of service names to port numbers is buffered in the SAP system, once they have been read from the file system. If a host name or a service name that should be accessed is changed, the host name buffer must be reset. You can display the buffer contents and reset the buffer. Then the ICM reads the updated data from the file system.

To do this choose Goto Host Name Buffer Display or Reset.

Services

Choose Goto Services to monitor and administer the services (ports that are used for the ICM connections). This is described in Displaying and Changing Services.

Display Connection

All the connections that the ICM has open at the moment are listed here.

Choose Goto Display Connection to display the TCP/IP connections which the ICM has open with a client (HTTP(S) client (browser), SMTP client). Either the ICM accepted the connection or opened it itself I(as HTTP client).

Release Information

Choose Goto Release Info or choose Release Info to display information about the version of the ICM, the release and the patch level of the SAP kernel.

The first line contains general information on the ICM.

kernel information tells you the release of the SAP kernel. Besides kernel release and compile information, this screen provides the following information:

update level specifies with which kernel releases the kernel can run in an SAP system. If different application servers should run in a system with different kernel patch statuses, they must all have the same update level.
patch number specifies the last patch level that is relevant for the component ICM.
source id (the numbers after the point) indicates the actual kernel patch level.

Below you can find the patch comments on the kernel patches that affect the ICM component, as well as additional detail information.

Note Note

You need this information mainly for notifying SAP of any problems that may occur.

End of the note.

HTTP Plug-In

Goto HTTP Plugin combines all the functions that are connected with the HTTP communication of the ICM.

THTTP Plug-In Functions
Function	Menu path	Description
Monitor and administer HTTP server	Goto HTTP Plugin Server Cache Display Data Goto HTTP Plugin Server Cache Display Data	Provides information about the HTTP application server (current AS ABAP or AS Java, URL prefix table). If AS Java is not configured (`J2EE Server configured = FALSE`), all HTTP requests are passed on to AS ABAP. If AS Java is active, the ICM decides, using the URL prefix table, whether the request is sent to AS ABAP or to AS Java: All URL prefixes in the table are sent to AS ABAP, all others are sent to AS Java. The table is determined from the possible prefixes (HTTP service tree and external aliases) of the Internet Communication Framework. If no AS Java has been configured, the table is not loaded. You can however enforce this using Load URL Prefixes. For more information, see: Processing HTTP Requests
Monitor and administer HTTP server cache	Goto HTTP Plugin Server Cache	Here you can find functions for Monitoring and Administrating the ICM Server Cache.
Create and display server logs	Goto HTTP Plugin Server Logs	You can display the following information about logging HTTP requests (server). Log Handler Display Entries : Display the entries in the logging file Log Handler More information : Name of the log file, format of the log file, terms for new log files, maximum log file size, cyclical write (yes/no), current number of characters in the log file and the current number of lines in the file. Log Handler Write buffer : The logging file entries are buffered and are regularly written to the hard disk. Since you can only see the entries that are already on the hard disk with Display Entries, you can use this function to force the buffer contents to be written to the hard disk. Log Handler Activate or Deactivate: You can activate and deactivate the logging. For more information, see: Logging in the ICM. icm/HTTP/logging_<xx>
Create and display client logs	Goto HTTP Plugin Client Logs	Functions for client logging of HTTP requests (see functions for server logs). For more information, see icm/HTTP/logging_Client_<xx>
Information about the authentication handler	Goto HTTP Plugin Auth Handler	You can display the following information about the authentication handler. Auth Handler More information : Display the entries in the logging file Log Handler Activate or Deactivate: You can activate and deactivate the authentication handler. Auth Handler Load Configuration: Trigger Configuration Output. Auth Handler Authorization File : Displaying the Contents of the Authorization File Auth Handler Authorizations : Display the authorizations for the Web admin interface (from the authorization file, by default icmauth.txt). For more information, see: Processing HTTP Requests icm/HTTP/auth_<xx> icm/authfile Setting Up the Web Administration Interface
Information about the modification handler	Goto HTTP Plugin Modification Handler	You can display the following information about the modification handler. Modification Handler Activate or Deactivate: You can activate and deactivate the modification handler. Modification Handler Display Rules : You can display the rules for the modification of HTTP requests (URL rewriting and so on). For more information, see: Processing HTTP Requests Modifications of HTTP Requests Defining Modification Actions

More Information

Memory Pipes and MPI Buffers