File properties

The File Properties window controls BlueZone’s operating parameters. From the BlueZone menu bar, click File → Properties. The File Properties window opens. It contains the Program, Title Bar, Auto-Launch, Profile Schemes, and Options tabs.

Program tab

Session Description: This is an optional field. Enter a unique session description. This description displays in the window title bar, after the program and connection names. The session description can help to identify a session when multiple sessions are active.
Main Window Always on Top: If selected, the BlueZone program window always remains above all non-topmost windows.
Minimize Window on Startup: If selected, BlueZone runs minimized on startup. This can be used when using BlueZone in conjunction with WinJa or JWalk.

The following items are read-only:

Command-Line Switches: Displays any command line parameters used when launching the session.
Program Group: Displays the BlueZone program group. For example, BlueZone 7.1.
Installation Directory: Displays the BlueZone installation directory.
Working Directory: Displays the BlueZone working directory.
Preferred Connection Type: Displays the BlueZone preferred connection type. The preferred connection type is used to determine how BlueZone connects to the host system the first time a session is launched.
Global Configuration Lock: If selected, the global configuration lock option is active.
Session Configuration Lock: If selected, the session configuration lock option is active.

The following item is selectable by the user:

Use the Consolidated Settings Viewer: If selected, all of the properties, options, and configuration windows contain a left navigation pane. The Settings Viewer allows you to easily navigate and set multiple options through one window.

Title Bar tab

This group is used to configure the text that displays on the BlueZone title bar. By default, the Session Identifier, Profile Name, Session Description, and Program Name are displayed on the BlueZone title bar. You have the option of turning off these items or you can create you own custom title bar by using the desired variable (%1, %2, %3 and so on) in the Display Custom Title Bar field:

Session Identifier (%1): If selected, the standard BlueZone session identifier is displayed on the title bar. For example, S1, S2, S3 and so on.
HLLAPI Short Name (%2): If selected, the standard BlueZone HLLAPI short name session identifier is displayed on the title bar.
Profile Name (%3): If selected, the name of the current BlueZone profile that was used to launch this session is displayed on the title bar.
Session Description (%4): If selected, the value of the Session Description field located on the Program tab (see Program tab above) is used, unless the Use Connection Name as Session Description check box located on the Connections tab (Session → Configure → Properties from the BlueZone menu bar), is checked. Then the connection name that was used to create the session is displayed on the title bar.
Connection Name (%6): If selected, the value of the Connection Name field located on the Connections → Edit Connection dialog is displayed on the title bar.
Note: If the Use Connection Name as Session Description check box located on the Connections tab (Session → Configure → Properties from the BlueZone menu bar), is checked, the connection name is displayed twice on the title bar.
Program Name (%5): If enabled, the standard BlueZone program name is displayed on the title bar. For example, BlueZone Mainframe Display, BlueZone iSeries Display, and so on.
3270 Application Name (%7): Available in Mainframe Displays only.
Select this check box to display the 3270 application name, for example, TELNET, CICS, or TSO. To display the application name, the session must be connected to the host using TN3270E.
Separator: Type a character to be used to separate the above values. Spaces are valid separators and can be used in conjunction with other characters. The default separator is “ - ” (space hyphen space).
Display Custom TitleBar: If enabled, any text in this field is displayed on the title bar instead of the selected values above. This feature overrides any of the above options. Also, you can build a custom title bar in any order you want by placing the desired variable values (%1, %2, %3, and so on) in the field in the order in which you want them to appear on the title bar. You can also mix in your own text as well.
For example, if you want the Session Description followed by the Session Identifier followed by the words "Claims Application" to display in the title bar, type the following in this field: %4 - %1 - Claims Application
CAUTION:
If the Display Custom Title Bar check box is selected and the field is left blank, the result is a blank title bar.
Display Custom Icon: If you would like to change the icon that displays on the BlueZone title bar, select this check box and browse to the location where the desired icon is located. We suggest keeping the icon in a predicable location like the BlueZone installation directory.

Auto-Launch tab

Run Sessions on Startup

This group is used to configure up to four additional BlueZone sessions to launch along with this session. This feature can be used to launch a BlueZone Printer session along with a BlueZone Display session.

To launch an additional session or sessions:

Select a check box.
From the Session Type menu, select the session type:
- Mainframe Display
- Mainframe Printer
- iSeries Display
- iSeries Printer
- VT Display
- 6530 Display
- TCP/IP Print Server
- UTS Display
- T27 Display
Optional: Type any command line switches.

The next time that you open this BlueZone Display session, any additional sessions that have been configured, will automatically open at the same time.

Run Program on Connect

This group is used to launch and run external programs when BlueZone makes a host connection:

Launch the WinJa (TM) Windows Client on Connect: If selected, the WinJa (or JWalk) client launches as soon as BlueZone makes the host connection.
- Switches: Specifies any additional program command line parameters when launching.
Run Custom Command: If selected, you can specify an external program to launch when BlueZone makes the host connection.
- Browse: Click to locate the external program.

Profile Schemes tab

The profile schemes feature is covered in detail in the Configuration Management section. Refer to Profile schemes for more information.

Options tab

Save

Ask to save configuration settings on exit: If selected, the user is prompted whether or not to save the configuration settings on program shutdown.
Always save configuration settings on exit: If selected, the configuration settings are always saved on program shutdown.
Do not save configuration settings on exit: If selected, the configuration settings are not saved on program shutdown.
Auto-Backup settings in Profile Mode: If selected, a backup of the configuration file is automatically saved whenever a change is made.

Open/Save As

File Description: This field configures the text that displays in the Common File window, describing the type of files to list.
Default Extension: Limits the initial list for the Common File window, the extension is limited to three characters.
Profile Format: Select the format of the configuration file: Binary or Text. If you select Text, you can edit the configuration file in any text editor.

Open/Close All Sessions

Enable Opening of New Sessions: Controls whether or not this session can be used to start additional sessions.
Prompt before Closing All Sessions: If selected, the user is prompted before closing all sessions.
Display Profile List when Opening Sessions: If selected, you are prompted with a list of available configuration files to choose from when opening sessions.