TCP/IP Services

 Top  Previous  Next

One or more TCP/IP Service may be defined, with the add tcpipservice directive.

When XCICS region is alive, TCP/IP services may be controlled using xcicsadm.

Syntax

add tcpipservice name="<value>",
port=<value>, 
[terminal=<value>],
[server_pool=(yes|no)],
[protocol=(ezadirect|ezaclassic|webservices|eci|isc|http|user)],
[urm=<value>],
[ssl=(yes|no)],
[close_connection=(yes|no), [close_timeout=<value>]],
[auth=(none|basic|certificate|automatic)],
[enabled|disabled]

 

name

Name of the TCP service.

port

Number of the TCP port, where the service waiting for connections.

terminal

(Optional) Name of the virtual terminal where the task is to be started.

server_pool

If set to yes, the service forwards the transaction directly on the engines pool, instead of forking as every normal background process;

protocol

defines the protocol handled by the tcpip service. The protocol may be one of the following:

direct

the service handles the direct ezalistener protocol

classic

the services handles classic ezalistener protocol

webservices

the service handles the XCICS/S Web Service interface protocol

isc

the service handles the XCICS/TS Intersystem communication with APPC over TCP/IP protocol

eci

the service handles XECI (XCICS External Call Interface) requests

http

the service handles HTTP requests for the XCICS Web Interface

user

the service handles user protocols for non-HTTP requests

enabled

If specified the service is automatically activated at XCICS start up time. This is the default behaviour.

disabled

If specified the service is not automatically activated at XCICS start up time.

urm

For HTTP and USER protocol only. Defines the name of the analyzer program to be started to handle HTTP and non-HTTP requests.

ssl

For HTTP and USER protocol only. If set to yes, the communication with the service will be encrypted over SSL (Secure Socket Layer)

close_connection

For HTTP and USER protocol only. Controls the usage of permanent connection. By default XCICS uses permanent connections.

close_timeout

For HTTP and USER protocol only. Defines the close timeout, in seconds, for permanent connections.

auth

For HTTP and USER protocol only. Defines the authorization method for the service.

none

no authorization is required to the client

basic

requires BASIC HTTP authentication to the client

certificate

requires the client to provide a certificate, and use it to authorize.

automatic

if the client sends a certificate, the service will use it to authenticate the client, otherwise BASIC authentication will be requested.

 

 

For further information about the EZA-like and SOAP TCP services modes, please refer to the TCP Services. For further information about XCICS Web Interface, HTTP and user protocols, please refer to the XCICS Internet Guide.

If no mode is specified, the BASIC mode is assumed by default.

Example:

add tcpipservice        name=DEFAULT,  port=8023;
add tcpipservice        name=WEBSVC,   port=8090, terminal=WEBS, protocol=webservices;
add tcpipservice        name=LISTENER, port=8090, terminal=WEBS, protocol=ezaclassic;
add tcpipservice        name=HTTPD,    
                       port=80,  
                       protocol=http,
                       close_timeout=25,
                       urm=ANALYZ01,
                       auth=none;
add tcpipservice        name=HTTPSD,
                       port=443,
                       protocol=http,
                       ssl=yes,
                       server_pool=no,
                       auth=automatic;