The RTN3270E.DLL file provides complete TN3270E connectivity for BlueZone allowing connection to hosts, servers, and gateways that are TN3270E compliant. TN3270E is the enhanced version of TN3270, providing more SNA information to the client for improved operation. Optionally, Secure Sockets Layer security is available to insure privacy, message integrity and provide authentication.
TN3270E configuration consists of: Connections, Device, Security, Keep Alive, Trace and Firewall setup.
NOTE The TN3270E settings for the BlueZone Display emulator are identical to the BlueZone Printer emulator with the exception of the Device Tab. The exceptions are noted below in bold blue type.
Decide if you want to use Connection Name as Session Description, and check or un-check the Use Connection Name as Session Description box accordingly.
To create a new host connection, click the New... button. If you want to edit an existing connection, click the Edit... button. Clicking the Remove... button will remove the highlighted connection name. Clicking the Sort... button will sort your Connection List.
Click the New... button. The Define New Connection dialog box will appear.
Connection Name:
A unique name used to identify the collection of Connection settings.
Host Address:
Specifies the computer name (in Internet format, known as DNS Name) or the IP address (in dotted decimal format) of the TN3270E server. An IP address is the preferred format, eliminating the requirement for domain name resolution, resulting in a faster connection time and recovery if the name cannot be resolved.
LU Name:
Specifies the name of the LU or LU pool to which to connect.
SEE Automatically Generating LU Names.
TCP Port:
Specifies the TCP port number to which to connect. The default is 23.
Backup Host:
Specifies the backup host to which BlueZone will connect if the primary host is not available. Backup hosts are selected from the Connection List.
Enable TN3270E:
When checked, BlueZone will attempt to negotiate a TN3270E protocol connection to the server. When unchecked, BlueZone will only negotiate TN3270. This option is provided for test purposes and should remain checked.
Enable Extensions:
If checked, enables TN3270E extensions which are a new set of enhancements to TN3270E.
Connection Timer:
Sets the connection timeout value. If the timer expires during a connection attempt, BlueZone will revert to the backup host. If a backup host is not available a connection error message will appear.
Device Type:
Selects the type of IBM terminal or printer to emulate.
3278: Selects a 3278 (monochrome) display. (Display emulator only)
3279: Selects a 3279 (color) display. (Display emulator only)
3287: Selects a 3287 printer. (Printer emulator only)
Device Model:
Selects the screen size of the emulated device. (Display emulator only)
Model 2 (24x80): Selects a model 2 device with 24 rows and 80 columns.
Model 3 (32x80): Selects a model 3 device with 32 rows and 80 columns.
Model 4 (43x80): Selects a model 4 device with 43 rows and 80 columns.
Model 5 (27x132): Selects a model 5 device with 27 rows and 132 columns.
Dynamic: Selects a dynamic device which can accept any model type.
Extended Attributes:
Specifies whether the device supports SNA Extended Attributes (color & highlighting). (Display emulator only)
Override 3270 Emulation Model Type:
Allows the Device Model specified here to override the Default Screen Model Type specified in the 3270 Emulation parameters. This is normally desirable unless the TN3270 server requires a terminal type model specification which differs from the model type configured in the host LU.
All BlueZone emulator clients support the SSL protocol through the SEAGULL Security Server or any SSL enabled telnet connection including IBM Communications Server for NT (SSL v3 only), OS/390, and the iSeries V4R4. BlueZone clients may be pre configured for distribution with SSL enabled eliminating the need for any end-user intervention in the installation or configuration process. The options for configuration include
Enable Secure Sockets Layer:
Specifies whether the TCP connection to the host should be encrypted using SSL.
Invalid Certificates:
Specifies how to handle an invalid server certificate. Options include:
Always Reject:
Specifies that an invalid server certificate should always be rejected.
Ask Before Accepting: (Default)
Specifies that the user should be asked whether to accept an invalid server certificate.
Always Accept:
Specifies that an invalid server certificate should always be accepted.
SSL Version:
Specifies which version of the SSL protocol should be used. Options include:
SSL v3: (Default)- Specifies that SSL version 3 should be used.
TLS v1: Specifies that TLS version 1 should be used.
NOTE SSL v3 and TLS v1 are nearly identical. TLS v1 is preferred.
Preferred Cipher Suite:
If you have a preference, choose a Cipher Suite from the "drop down" box. Otherwise leave it set to none.
Client Certificates:
Specifies how to handle a client certificate. Options include:
Use Client Certificate: Specifies whether a client certificate should be presented.
Certificate File: Specifies the file containing the Client Certificate.
View...: Allows you to view the Client Certificate.
Browse...: Brings up the Common File dialog to browse for the certificate file.
Private Key File: Specifies the file containing the client certificate's private key.
Browse...: Brings up the Common File dialog to browse for the key file.
Timer Options:
These parameters specify whether the client should send keep-alive messages to the server to keep the TN3270E session active.
Disabled: Disables keep-alive messages. (Default)
Use TCP: Uses built-in TCP keep-alive mechanisms.
Use NOP: Uses the Telnet NOP for keep-alive messages.
Use Timing Mark: Uses the Telnet Timing Mark (TM) for keep-alive messages.
Timer Value (Minutes):
Specifies the time interval (in minutes) for sending keep-alive messages.
Trace Options:
These parameters specify the the interfaces to be traced and the file name to which the trace file will be written. The trace files are in ASCII text format and may be viewed with Note Pad or Word Pad.
Trace Sockets Interface: Traces the data as it passes through the Winsock interface from the network connection.
Trace RUI Interface: Traces the data as it passes between the TN3270E driver and the BlueZone terminal session.
Trace SSL Connection: Traces the data as it passes through the Secure Sockets Layer component of the TN3270E driver.
Trace File: Specifies the file name to which the trace file will be written. The Browse... button displays a dialog used to select the directory and file name. BlueZone provides a Traces directory in the BlueZone installation directory.
Trace Viewer: Specifies the program that will be used to read the trace file after it has been captured and written. The Browse... button displays a dialog used to select the directory and file name.
Start Trace Button: Used when you want to manually start a trace.
View Trace Button: Used when you want to view a trace. BlueZone will automatically use the Trace Viewer program specified above.
The Firewall tab allows the configuration of Firewall and Proxy Server sign on systems. To turn on the feature, check the Connect Through Firewall or Proxy Server checkbox. Options are:
Firewall
Type:
Choose the Firewall Type from the "drop down" list.
SOCKS4 Proxy
SOCKS4A Proxy
SOCKS5 Proxy
NVT Proxy or Firewall
Firewall Address:
Enter the IP address of the Firewall.
Port:
Enter the Port number used by the Firewall.
Timeout:
Enter the appropriate Time out value.
User Name:
Enter the appropriate User Name.
Password:
Enter the appropriate Password.
If you have chosen NVT Proxy or Firewall, then you will need to provide the following additional information:
Host
Name Prompt:
Enter Firewall of network prompts BlueZone should look for.
User Name Prompt:
Enter the User Name that the Firewall is expecting.
Password Prompt:
Enter the Password that the Firewall is expecting.
Connected Prompt:
Enter the appropriate Connected message that the Firewall transmits.
Related Topics: Establishing a Host Session