Monitoring the Status of the ICM

Use

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 Start of the navigation pathGoto Next navigation step Trace FileEnd of the navigation path or Start of the navigation pathGoto Next navigation step Trace LevelEnd of the navigation path, 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 Start of the navigation pathGoto Next navigation step Trace File Next navigation step  Display Start End of the navigation path 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 Start of the navigation path Goto Next navigation step Trace File Next navigation step Save File LocallyEnd of the navigation path.

Security Log

To view the security log, choose Start of the navigation pathGoto Next navigation step Trace File Next navigation step Security Log Next navigation step DisplayEnd of the navigation path. 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 Start of the navigation pathGoto Next navigation step Trace File Next navigation step Display Dev_icmbndEnd of the navigation path

Parameter

To display or change ICM profile parameters, choose Start of the navigation pathGoto Next navigation step ParametersEnd of the navigation path. If you choose Change, for each listed parameter you can display the RZ11 documentation, 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.

Statistics

Choose Start of the navigation pathGoto Next navigation step StatisticsEnd of the navigation path to activate, deactivate, display, and reset the ICM statistics.

Memory Pipes

Choose Start of the navigation pathGoto Next navigation step Memory PipesEnd of the navigation path 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 Start of the navigation pathGoto Next navigation step Host Name Buffer Next navigation step DisplayEnd of the navigation path or Reset.

Services

Choose Start of the navigation pathGoto Next navigation step  ServicesEnd of the navigation path to monitor and administer the services (ports that are used for the ICM connections).

Display Connection

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

Choose Start of the navigation pathGoto Next navigation step  Display ConnectionEnd of the navigation path 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 Start of the navigation pathGoto Next navigation step Release InfoEnd of the navigation path 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.

HTTP Plug-In

Start of the navigation pathGoto Next navigation step HTTP Plugin End of the navigation path combines all the functions that are connected with the HTTP communication of the ICM.

Function

Menu Path

Description

Monitor and administer HTTP server

Start of the navigation pathGoto Next navigation step HTTP Plugin Next navigation step Server Cache Next navigation step Display DataEnd of the navigation path

Start of the navigation pathGoto Next navigation step HTTP Plugin Next navigation step Server Cache Next navigation step Display DataEnd of the navigation path

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.

Monitor and administer HTTP server cache

Start of the navigation pathGoto Next navigation step HTTP Plugin Next navigation step Server CacheEnd of the navigation path

Here you can find functions for Monitoring and Administrating the ICM Server Cache.

Create and display server logs

Start of the navigation pathGoto Next navigation step HTTP Plugin Next navigation step Server LogsEnd of the navigation path

You can display the following information about logging HTTP requests (server).

  • Start of the navigation pathLog Handler Next navigation step Display EntriesEnd of the navigation path: Display the entries in the logging file

  • Start of the navigation pathLog Handler Next navigation step  More informationEnd of the navigation path: 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.

  • Start of the navigation pathLog Handler Next navigation step Write BufferEnd of the navigation path: 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.

  • Start of the navigation pathLog Handler Next navigation step ActivateEnd of the navigation path or Deactivate: You can activate and deactivate the logging.

Create and display client logs

Start of the navigation pathGoto Next navigation step HTTP Plugin Next navigation step Client LogsEnd of the navigation path

Functions for client logging of HTTP requests (see functions for server logs).

Information about the authentication handler

Start of the navigation pathGoto Next navigation step HTTP Plugin Next navigation step Auth HandlerEnd of the navigation path

You can display the following information about the authentication handler.

  • Start of the navigation pathAuth Handler Next navigation step  More InformationEnd of the navigation path: Display the entries in the logging file

  • Start of the navigation pathLog Handler Next navigation step ActivateEnd of the navigation path or Deactivate: You can activate and deactivate the authentication handler.

  • Start of the navigation pathAuth Handler Next navigation step Load Configuration:End of the navigation path Trigger reading of the configuration.

  • Start of the navigation pathAuth Handler Next navigation step Authorization FileEnd of the navigation path: Displaying the Contents of the Authorization File

  • Start of the navigation pathAuth Handler Next navigation step AuthorizationsEnd of the navigation path: Display the authorizations for the Web admin interface (from the authorization file, by default icmauth.txt).

Information about the modification handler

Start of the navigation pathGoto Next navigation step HTTP Plugin Next navigation step Modification HandlerEnd of the navigation path

You can display the following information about the modification handler.

  • Start of the navigation pathModification Handler Next navigation step ActivateEnd of the navigation path or Deactivate: You can activate and deactivate the modification handler.

  • Start of the navigation pathModification Handler Next navigation step Display RulesEnd of the navigation path: You can display the rules for the modification of HTTP requests (URL rewriting and so on).