Administration of the J2EE Engine

Use

You can manage the J2EE Engine from the SAP Web AS ABAP, that is, you can start and stop it in different ways. You can find the functions in the ICM monitor (Transaction SMICM or by choosing Administration ® System Management ® Monitor ® System Monitoring ® Internet Communication Manager).

Integration

Of course, you can also use other administration tools to start, stop, and monitor the J2EE engine (SAP Management Console, and so on.) For more information see the Administration Manual for the J2EE Engine.

The Java Startup and Control Framework is used to start, stop, and control the Web AS Java components.

Prerequisites

You are using the SAP Web Application Server with ABAP and Java.

So that the dispatcher can start the SAP J2EE Engine, you must set parameter rdisp/j2ee_start to 1. You can make this setting dynamically in transaction RZ11.

You can check if the J2EE Engine is actually configured and running by choosing, on the initial screen of the ICM monitor, Goto ® HTTP Server ® Display Data.

Under HTTP Application Server Handler you can see the following information.

HTTP Server Details

Property

Possible Values

Significance

ABAP server operational

TRUE or FALSE

Is the ABAP server running? If you execute the SMICM from the SAP GUI, this value must be TRUE.

J2EE server configured

TRUE or FALSE

TRUE, if the parameter  icm/HTTP/j2ee_0 has a correct value.

J2EE HTTP port

Port number

Port, on which the J2EE engine receives HTTP and HTTPS requests.

The J2EE Engine sends the communication port numbers to the ABAP dispatcher, which then forwards the information to the ICM.

J2EE HTTPS port

J2EE Server operational

TRUE or FALSE

TRUE, if the J2EE Engine has sent the ACTIVE event to the ABAP dispatcher (compare dev_disp) and the icm/HTTP/j2ee_<xx> parameter has a correct value.

Default root access handler

ABAP or J2EE      

Value of parameter is/HTTP/default_root_hdl (compare Message Server Parameters).

The parameter is only evaluated if the J2EE Engine is configured (J2EE Server configured) and operational (J2EE Server operational). Otherwise, the default root handler is always ABAP (ICF).

URL Prefix Table loaded

TRUE or FALSE

Specifies whether the ICM has loaded the prefix table. You can trigger the loading in the ICM monitor by choosing Goto ® HTTP Server ® Load URL Prefixes. You can view the available URL prefixes in URL Prefix Table

Features

The ICM monitor provides various functions for starting and stopping the J2EE Engine. These functions can be performed for the local J2EE Engine on this instance (Administration  ® J2EE Instance (Local))as well as on the entire J2EE cluster (Administration  ® J2EE Cluster (Global)).

If the J2EE Engine is not running, these menu options are grayed out.

The most important functions are described below.

Sending a Soft Shutdown (With or Without a Restart)

The (ABAP) dispatcher of the SAP NetWeaver Application Server sets the restart flag for the J2EE Engine and sends the SOFTSHUTDOWN message to the J2EE Engine. The dispatcher does not actively close the connection, the J2EE Engine must close itself instead. If the application server is restarted, the J2EE Engine is restarted by the dispatcher.

Sending a Hard Shutdown (With or Without a Restart)

The (ABAP) dispatcher of the SAP NetWeaver Application Server sets the restart flag for the J2EE Engine and sends the HARDTSHUTDOWN message to the J2EE Engine. The dispatcher does not actively close the connection, the J2EE Engine must close itself instead. If the application server is restarted, the J2EE Engine is restarted by the (ABAP) dispatcher.

Ending the Process (With or Without a Restart)

The (ABAP) dispatcher of the SAP NetWeaver Application Server sets the restart flag for the J2EE Engine and sends a signal to the process (shell or Java process). If the application server is restarted, the J2EE Engine is restarted by the dispatcher.

In Release 7.00 all named signals/messages are handled the same by the control framework of the J2EE Engine, so it does not matter which option you use.

Restart Yes/No

This sets the J2EE Engine’s restart flag.

If you set new start to Yes, you can also restart a non-running J2EE Engine. When the (ABAP) dispatcher makes the next periodic check it starts the J2EE Engine.