Start of Content Area

Background documentation icm/server_port_<xx> Locate the document in its SAP Library structure

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.

Caution

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.

Caution

SMTP is not supported for the SAP Web Dispatcher. There is however also the value ROUTER (in contrast to the ICM). This is not a protocol as such, it is used for Structure linkEnd-to-End SSL configuration in the Web Dispatcher.

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 Structure linkTimeout 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=<host name or IP address> to specify that the port should not be bound 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 associated with this parameter:

Structure linkSample Profiles for the ICM

Structure linkExample: Profile File of a SAP Web Dispatcher

 

 

 

End of Content Area