File properties
The File Properties property sheet controls BlueZone’s operating parameters. From the BlueZone menu bar, click File → Properties. The File Properties property sheet opens. It contains the Program, Auto-Launch, and Options tabs.
Program tab
Settings
Enables customization of the session description. The text displays right justified on the caption bar of the session main window:
•  Session Description: This is an optional field. If desired, a unique session description can be entered that displays right justified on the session window’s caption bar. The session description can help to quickly identify a session when multiple sessions are active.
•  Main Window Always on Top: If checked, the BlueZone program window always remains above all non-topmost windows.
•  Minimize Widow on Startup: If checked, BlueZone runs minimized on startup. This can be used when using BlueZone in conjunction with WinJa or JWalk.
The following items are display-only and can only be viewed by the end user:
•  Command-Line Switches: Displays any command line parameters used when launching the session.
•  Program Group: Displays the BlueZone program group.
•  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 enabled, the global configuration lock option is active.
•  Session Configuration Lock: If enabled, the session configuration lock option is active.
The following item is selectable by the end user:
•  Enable Password Vault: By default, BlueZone.PasswordVault is enabled. To disable it, clear the check box.
TitleBar tab
Show on Window Caption
This group is used to configure the text that appears 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 etc.) in the Display Custom TitleBar edit box:
•  Session Identifier (%1): If enabled, the standard BlueZone session identifier is displayed on the title bar. For example, S1, S2, S3 etc.
•  HLLAPI Short Name (%2): If enabled, the standard BlueZone HLLAPI short name session identifier is displayed on the title bar.
•  Profile Name (%3): If enabled, the name of the current BlueZone profile that was used to launch this session is displayed on the title bar.
•  Session Description (%4): If enabled, the value of the Session Description editbox 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 → Configure 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 enabled, the value of the Connection Name editbox 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 → Configure 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, etc.
•  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 that is placed in this editbox is displayed on the title bar instead of the selected values above. This feature overrides any of the above items. Also, you can build a custom title bar in any order you want by placing the desired variable values (%1, %2, %3, etc.) in the editbox 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 appear on the title bar, type the following in the editbox: %4 - %1 - Claims Application
CAUTION
If the Display Custom TitleBar check box is enabled and the editbox is left blank, the result is a blank title bar.
•  Display Custom Icon: If you would like to change the icon that appears on the BlueZone title bar, enable 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:
1. Check the check box.
2. Choose the BlueZone Session Type: Mainframe Display, Mainframe Printer, iSeries Display, iSeries Printer, or VT Session.
3. Enter desired switches (if any).
The next time you launch this BlueZone Display session, any additional sessions that have been configured, will automatically launch at the same time.
•  Open Session ==> Session Type: (required) Switches: (optional)
•  Open Session ==> Session Type: (required) Switches: (optional)
•  Open Session ==> Session Type: (required) Switches: (optional)
•  Open Session ==> Session Type: (required) Switches: (optional)
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 checked, 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 checked, 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 feature 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.
Open / Save As
•  File Description: This edit box configures the text that appears in the Common File dialog, describing the type of files to list.
•  Default Extension: Limits the initial list for the Common File dialog, the extension is limited to three characters.
Open / Close All Sessions
•  Enable Opening of New Sessions: Controls whether or not this session can be used to launch additional sessions.
•  Prompt before Closing All Sessions: If checked, the user is prompted before closing all sessions.
•  Display Profile List when Opening Sessions: If checked, you are prompted with a list of available configuration files to choose from when opening sessions.
Related Links
Display settings (Parent Topic)