Show TOC

Monitoring the Status of the ICMLocate this document in the navigation structure

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 path Goto Next navigation step Trace File End of the navigation path or Start of the navigation path Goto Next navigation step Trace Level End 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 path Goto Next navigation step Trace File Next navigation step  Display Start or End End of the navigation path.

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 Locally End of the navigation path.

Security Log

To view the security log , choose Start of the navigation path Goto Next navigation step Trace File Next navigation step  Security Log Next navigation step  Display End 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 path Goto Next navigation step Trace File Next navigation step Display Dev_icmbnd End of the navigation path

Parameters

Choose Start of the navigation path Goto Next navigation step Parameters End of the navigation path 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

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

Statistics

Choose Start of the navigation path Goto Next navigation step Statistics End of the navigation path to activate, deactivate, display, and reset the ICM statistics.

Memory Pipes

Choose Start of the navigation path Goto Next navigation step Memory Pipes End 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 path Goto Next navigation step Host Name Buffer Next navigation step Display End of the navigation path or Reset .

Services

Choose Start of the navigation path Goto Next navigation step  Services End of the navigation path to monitor and administer the services (ports that are used for the ICM connections). This is described in Displaying and Changing Services .

Connections

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

  • Start of the navigation path Connections Next navigation step Default End of the navigation path shows the TCP/IP connections that the ICM has open for a client (browser, P4, IIOP, Telnet, SMTP client). Either the ICM accepted the connection or opened it itself I(as HTTP client).

  • Start of the navigation path Connections Next navigation step Proxy End of the navigation path shows virtual network connections. These are only significant when the Virtual Machine Container (VMC) is used: The VM in the work process must be able to roll and therefore the VM is not allowed to open any connections; this task is delegated to the ICM which takes on the role of a proxy.

    Proxy connections can also be accepted or opened actively.

    For more information, see: SAP Virtual Machine Container

Release Information

Choose Start of the navigation path Goto Next navigation step Release Info End 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.

Note

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

HTTP Plug-In

Start of the navigation path Goto 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 path Goto Next navigation step HTTP Plugin Next navigation step Server Cache Next navigation step Display Data End of the navigation path

Start of the navigation path Goto Next navigation step HTTP Plugin Next navigation step Server Cache Next navigation step Display Data End 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 .

For more information, see: Processing HTTP Requests

Monitor and administer HTTP server cache

Start of the navigation path Goto Next navigation step HTTP Plugin Next navigation step Server Cache End 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 path Goto Next navigation step HTTP Plugin Next navigation step Server Logs End of the navigation path

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

  • Start of the navigation path Log Handler Next navigation step Display Entries End of the navigation path: Display the entries in the logging file

  • Start of the navigation path Log Handler Next navigation step  More information End 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 path Log Handler Next navigation step Write buffer End 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 path Log Handler Next navigation step Activate End of the navigation path 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

Start of the navigation path Goto Next navigation step HTTP Plugin Next navigation step Client Logs End of the navigation path

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

Start of the navigation path Goto Next navigation step HTTP Plugin Next navigation step Auth Handler End of the navigation path

You can display the following information about the authentication handler.

  • Start of the navigation path Auth Handler Next navigation step  More information End of the navigation path: Display the entries in the logging file

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

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

  • Start of the navigation path Auth Handler Next navigation step Authorization File End of the navigation path: Displaying the Contents of the Authorization File

  • Start of the navigation path Auth Handler Next navigation step Authorizations End of the navigation path: 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

Start of the navigation path Goto Next navigation step HTTP Plugin Next navigation step Modification Handler End of the navigation path

You can display the following information about the modification handler.