TN3270 Services

XCICS accepts terminal connection only over its native protocol, from X4J terminals. In order to allow access to tn3270 terminals (i.e. IBM Personal Communication, Tn3270+, eXtra, etc), XFRAME provides an additional tool, named XTND, which is a TN3270 / XCICS protocol converter.

XTND can be run as an external service or directly embedded by XCICS. In this case XCICS takes care to define the XTND configuration and to start/stop the service whenever required.

This section covers the configuration aspects of tn3270 services embedded in the XCICS region.

By means of the command add tn3270server one or more tn3270 services may be added and started to an XCICS region. All the services defined will be activated at XCICS start up, and they will provide tn3270 access to all the terminals defined as "standard" type.

The connection of terminals defined in TCT with the "address" parameter will be allowed only for  tn3270 connection coming from the specified  IP address.

If the TCT entry contains the "netname" clause, the connection will be allowed only for those tn3270 terminal requiring an LUNAME equal to the one specified in the "netname" clause.

When XCICS region is alive, TN3270 services may be controlled using xcicsadm.

For each of these tn3270 services some parameters must be supplied.

For additional information about XTND, please refer to the XTND Tn3270 Server guide.

Syntax

name

This is the name of the service. If it is not specified it is automatically set by XCICS.

port

This is the port number where the service will be listening for incoming tn3270 connections and where tn3270 emulators should connect to. If it is not specified it is XCICS automatically assigns it. In this case the number assigned can be read on the console log or using xcicsadm utility.

address

This is the IP address bind by the tn3270 service. It must be specified when you want the service to listen on a specific IP. If it is not set the service is bind on the default IP.

admin_port

This is the port number where the service will be listening for admin connections. If it is not specified it is XCICS automatically assigns it. Normally there is no need to specify this parameter.

timeout

This is the time, in minutes, after that inactive terminals are automatically disconnected. If not specified or set to zero, no timeout is managed.

ssl

If set, the tn3270 service will accept only SSL communication. When set, keystore and keystorepassword must also be configured.

keystore

Full path of the Certificate store file.

keystorepassword

Password to access the key store file

For further information about tn3270 over SSL and its configuration, please refer to the XTND documentation, in the "Using SSL" section.

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.