The tn3270 Server

#### Search Results

Search

# The tn3270 Server

Com-plete can act as a tn3270 server. Both plain and secure (SSL) communications are supported, but different TCP/IP port numbers must be used.

#### Initialization

A tn3270 server port can be initialized using the following sysparm:

    SERVER=(name,TLINTNET,PORT=port [,POOL=pool] [,MAXCONN=maxconn] [,SSL=ssl] )

where:

Parameter | Use | Possible Values | Default
--- | --- | --- | ---
name | A unique name to identify the server. | string of 8 characters or less | none
port | The TCP/IP port number. | 1…65535 | none
pool | Indicates how many previously started tn3270 server instances should be kept in a pool for reuse. If you specify 0, then server instances are not pooled, and a new server instance is started for each tn3270 request and terminated after the request is completed. | 0…32767 | 10
maxconn | Specify the maximum number of parallel connections you want to allow this server to accept. | 1…32767 | 32767
ssl | Indicates whether or not SSL should be used, and if client certificates should be required. CERT implies YES. Specify CERT to instruct the server to require a client certificate from each client. | NO / YES / CERT | NO

More than one server of this kind can be started in the same Com-plete, with different names and port numbers.

#### Prerequisites (general)

#### z/OS:

The tn3270 server requires the IBM Language Environment runtime libraries in either LINKLST or Com-plete's COMPLIB chain.

Software AG strongly recommends to specify the following sysparm:

    APPLYMOD=78

#### z/VSE:

The following sysparm must be specified:

    RESIDENTPAGE=(TLSPLISN,$SOCKLST)

The module $SOCKLST is located in library PRD1.BASE.

#### Prerequisites for SSL

Before you can use SSL with Com-plete, you must enable your system for it. This includes creation/purchase and installation of a server certificate. IBM provides all the tools and documentation it takes as part of the operating system. For details on z/OS, see the RACF / Security Server books and follow the instructions described in this documentation.

Using SSL with Com-lete requires specification of a key database or a SAF key ring using the Com-plete SSL-KEYRING-* sysparms.

#### z/OS:

The IBM GSK load library SYS1.SIEALNKE must be present in either the system LINKLST or Com-plete's COMPLIB chain.

#### z/VSE:

The following sysparm must be specified:

    RESIDENTPAGE=IPCRYPTO

#### Operator Commands

The following operator commands can be used to operate the tn3270 server without having to restart Com-plete:

SERV INIT name TLINTNET parms | Starts the tn3270 server the way the SERVER statement described above would.
SERV TERM name | Terminates the tn3270 server the way it terminates during Com-plete shutdown.