Session Configuration

VT Session Configuration

Prior to establishing a host system connection, you must set Session Configuration parameters.

From the BlueZone MenuBar, choose Session:Configure. The Session Configuration dialog will appear.

BlueZone VT Display Session Configuration consist of Connections, Trace, Keep Alive, and License Manager setup.

Connections Tab

Telnet Connections ----

Connection List: Contains the names of the defined host connections. A total of 64 connections may be specified.

New Button: Used to create new host sessions. When clicked, the Define New Connection dialog will appear.
Edit Button: Used to edit an existing host connection. When clicked, the Edit Connection Dialog for the highlighted connection will appear.

NOTE The Edit Connection dialog is essentially the same as the Define New Connection dialog. Use the Define New Connection dialog as a reference for the Edit Connection dialog.

Copy Button: Used to copy an existing host connection. When clicked, the Edit Connection Dialog will appear with all the information of the connection that was highlighted except for Connection Name.
Remove Button: Used to remove an existing host connection. When clicked, the highlighted connection will be removed from the list.

Use Connection Name as Session Description: If checked, the name that you gave to the active connection, will appear in the BlueZone Title bar, immediately after the session number. This feature is handy if you have multiple hosts defined, and you are not using the "Connections" drop down list, and you want to know the name of the current connection.

Options ----

Auto-Connect Session: If enabled, BlueZone will automatically start the host connection that is highlighted in the Connection List.
Auto-Reconnect Session (when Deactivated by Host) in: If enabled, BlueZone will auto-connect the session if the host disconnects the session while a BlueZone session is active, in the number of seconds specified in the list box. 0 through 10 seconds can be selected.
Prompt on Disconnect: If enabled, BlueZone will display a message box "Are you sure you want to disconnect and close session? whenever an attempt is made to disconnect a host session, or when the BlueZone application is closed with an active host session.
Auto-Close Session on Disconnect: If enabled, BlueZone will automatically close the session (that is highlighted in the Connection List) upon session disconnect. Selecting this option will disable the Auto-Reconnect option above.
Disable Exit While Connected to Host: If enabled, BlueZone will not allow the user to close down the BlueZone program while it is still connected to an active host session.

Trace Tab

Trace Options ----

These parameters specify the interfaces to be traced and the file name to which the trace file will be written. The trace files are written in ASCII text format and may be viewed with Notepad or WordPad.

STEP-BY-STEP How to Capture a BlueZone Trace

Trace File: Specifies the file name to which the trace file will be written.

Browse: Displays a dialog used to select the directory and file name. BlueZone provides a Traces directory in the BlueZone installation directory.

CAUTION! This must be a valid path or the trace feature will not work.

Trace Viewer: Specifies the program that will be used to read the trace file after it has been captured and written.

Browse: Displays a dialog used to select the directory and file name.

Start Trace: Used to manually start the trace.
Stop Trace: Used to stop the trace.
View Trace: Used to view the trace. BlueZone will automatically use the Trace Viewer program specified above.

Keep Alive Tab

Timer Options ----

These parameters specify whether the client should send keep-alive messages to the server to keep the TN3270E session active.

Disable: Disables keep-alive messages. (Default)
Use TCP: Uses the built-in keep-alive mechanism.
Use NOP: Uses the Telnet NOP (No Op) 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.

Advanced Tab

The Advanced Tab is used for enabling or disabling Nagle's Algorithm and setting the a National Replacement Character Set if so desired.

Nagle Algorithm ----

Nagle's Algorithm provides a means of dealing with the small packet problem that is created when an application generates data one byte at a time, causing the network to be overloaded with packets. A single character - one byte of data - originating from a keyboard could result in the transmission of a 41 byte packet consisting of one byte of useful information and 40 bytes of header data. Most networks have support for Nagle's Algorithm tuned on by default. This feature can be turned off through use of the TCP_NODELAY sockets option. When TCP_NODELAY is selected, Nagle's Algorithm is disabled.dsdsd

Disable (TCP_NODELAY On): Choosing this option will result in Nagle's Algorithm being turned off.
Enable (TCP_NODELAY Off): Choosing this options will result in Nagle's Algorithm being turned on.

National Replacement Character Set ----

Used to manually set the National Replacement Character Set. Most host applications automatically set the correct National Replacement Character Set to match the required language. In some cases the host application assumes that the character set is already selected.

If the wrong National Replacement Character Set is selected, you will notice that certain characters, like accented characters, will be displayed incorrectly. If this happens, choose the desired country's National Replacement Character Set from the drop down listbox.

License Manager Tab

The License Manager Tab is used to store the IP address of the BlueZone License Manager server. This is necessary when using a "Concurrent" licensing scheme.

NOTE The License Manager Tab will only appear if you are using a "Licensed" copy of BlueZone. If you are currently "evaluating" BlueZone this tab will not appear.

License Servers ----

Use this group to configure your BlueZone License Manager IP address.

Add Server: Place the IP address of the server or servers that are running the BlueZone License Manager in this filed and click the Add button.

NOTE If your BlueZone License Manager is using a Listening Port other than the default of 8421, you must add the configured port number to the end of the IP address, using a coma as a separator.

Example: 63.75.199.234,80

CAUTION! DO NOT use a colon ( : ) between the IP Address and the Port number. You must use a coma as shown above.

Server List: This will display the IP addresses of your BlueZone License Manager server (if any).
Use the Remove and Clear buttons as needed.

Group Information ----

This field is only used if you are using the Group feature of the BlueZone License Manager.

Group: Place the name of the Group in this field (if any).

SEE BlueZone License Manager Administrator's Guide for more information on the Group feature.