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.
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.
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
The following sysparm must be specified:
RESIDENTPAGE=(TLSPLISN,$SOCKLST)
The module $SOCKLST is located in library PRD1.BASE.
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.
The IBM GSK load library SYS1.SIEALNKE must be present in either the system LINKLST or Com-plete's COMPLIB chain.
The following sysparm must be specified:
RESIDENTPAGE=IPCRYPTO
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. |