icm/server_port_<xx>

Use

You can use this parameter to specify the service/port that is to be used for a protocol. Either the service name or the port number can be specified.

You can also determine additional service properties. There are described below.

There cannot be more than one service allocated to a single port. Also, a service cannot be started if another program is using the port or service.

Integration

<xx> stands for a number. Numbers ascending from 0 must be used (compare with Generic Profile Parameter with the Ending <xx>).

Properties

Work area

Internet Communication Manager

Unit

Character string

Standard value

-

Dynamically changeable

No

Value Range and Syntax

The character string has the following syntax:

PROT=<protocol name>, PORT=<port or service name>[, TIMEOUT=<timeout>, PROCTIMEOUT=<proctimeout>, EXTBIND=1, HOST=<host name>, VCLIENT=<SSL Client Verification>]

You have to specify the options for the protocol PROT and the service name (or port number) PORT, the other variables are optional.

The options are described below.

Protocol

For the protocol PROT there are the values HTTP, HTTPS (the ICM encrypts the HTTPS request), and SMTP. For the SAP Web dispatcher there is the additional value ROUTER ( End-to-End SSL).

Timout Options

Two timeouts can be configured: the network timeout TIMEOUT, and the processing timeout PROCTIMEOUT.

TIMEOUT is a keepalive timeout for the network connection. PROCTIMEOUT is a processing timeout for communication with the back-end (work process). Details about the timeouts, value range, and standard value can be found under Timeout Options for the ICM and Web Dispatcher.

Using an External Binding Program

For binding ports < 1024 to UNIX this parameter is extended by specifying EXTBIND=1(optional) (see Connecting Ports < 1024 on UNIX).

Not Binding the Port to all Host Names

You can use the optional parameter HOST=<Rechnername oder IP-Adresse> to specify that the port should not be binded to all host names (default), but only to the specified host. In this way the host with only one open port can be reached under various URLs. 

X.509 Certificate

Using the optional parameter VCLIENT you can specify whether the client should have an X.509 certificate when you use SSL. There are three certification levels (0-2):

?     0: No certification is required and the server does not ask for one.                                                      

?     1: The server asks the client to transfer a certificate. If the client does not send a certificate, authentication is carried out by another method, for example, basic authentication (default setting).                                           

?     2: The client must transfer a valid certificate to the server, otherwise access is denied.

This server-specific value overrides the value that is set with parameter icm/HTTPS/verify_client.    

Examples

PROT=HTTP, PORT=8080, TIMEOUT=15

PROT=SMTP, PORT=80, TIMEOUT=45, EXTBIND=1, HOST=prd.sap.de

PROT=HTTPS, PORT=443, TIMEOUT=15, PROCTIMEOUT=45, VCLIENT=0

More Information

Note the following documentation:

Sample Profiles for the ICM

Example: Profile File of a SAP Web Dispatcher