Skip to content

Setup

Keyboard and display settings for Design Tool.

Keyboard

Auto Repeat (Enter Key Repeat)

Checking this box causes most keys to repeat when you hold down the key. The Shift, Return, and Ctrl keys do not auto repeat.

This setting is permanently on and cannot be turned off, even though it appears you can clear the selection.

Host 3270 Keyboard

Specify which terminal keyboard is displayed in the Keyboard Setup dialog box and on the floating terminal keyboard.

In the Setting details drop-down, choose your Typewriter. The default is US English 3270 Typewriter

Host 5250 Keyboard

Specify which terminal keyboard is displayed in the Keyboard Setup dialog box and on the floating terminal keyboard.

In the Setting details drop-down, choose your Typewriter. The default is US English 5250 Typewriter.

Host HP Keyboard

Specify which terminal keyboard is displayed in the Keyboard Setup dialog box and on the floating terminal keyboard.

In the Setting details drop-down, choose your Typewriter. The default is US English VT Typewriter

Host Keyboard Type

Specify which type of terminal keyboard you are emulating.

In the Setting details drop-down, choose your keyboard type. The default is Normal.

Host VT420 Keyboard

Specify which terminal keyboard is displayed in the Keyboard Setup dialog box and on the floating terminal keyboard.

In the Setting details drop-down, choose your Typewriter. The default is US English VT Typewriter.

Keyboard Error Alarm

Indicates whether an alarm (a beep) is sounded when a keyboard error is detected. By default, this box is not checked.

Note: This setting is applicable to 5250 terminal sessions only.

Keyboard Locked

Indicates whether the keyboard is currently locked. This setting is read-only.

Local Keyboard

Specify which PC keyboard is displayed in the Keyboard Setup dialog.

In the Setting details drop-down, choose a keyboard option. The default is US English Enhanced 101 Key.

Right Control Key Repeat (setting)

By default, the right Ctrl key acts as a modifier key. That is, used in combination with another key to send a function (for example, Ctrl+F1 is mapped to the Attention key in 3270 sessions). With this setting, you can specify whether the right Ctrl key is treated like any other key, where continuously pressing the key repeatedly sends its function.

Set this to Yes if you map the right Ctrl key to a function other than its default use as a modifier key. The default is No.

Show Host Mapped Keys

Specifies whether host keys (functions) that are mapped to PC keys are shown in cyan on the terminal keyboard in the lower half of the Keyboard Setup dialog. The default value is Yes.

Show Key Help

Specifies whether the name of the selected key in the Keyboard Setup dialog box is identified at the bottom of the dialog box in the Status line. The default value is No. Key help is available for keys on the PC keyboard and on the terminal keyboard.

Terminal Kbd Fix Upper Right Corner

Specifies which corner of the terminal keyboard remains tethered when the user resizes the Terminal Keyboard by clicking the up-arrow or down-arrow icon in the upper right corner with the right mouse button. When the value is Yes, the upper-right corner remains tethered. When the value is No (default), the upper-left corner remains tethered.

Terminal Kbd Mode

Specifies whether the graphical terminal keyboard is attached to one of the margins of the Terminal window and, if it is, which margin it is attached to. The values are:

  • Bottom Bar: The terminal keyboard is attached to the bottom margin of the Terminal window.

  • Floating (default): The terminal keyboard is free floating.

  • Left Bar: The terminal keyboard is attached to the left margin of the Terminal window.

  • Right Bar: The terminal keyboard is attached to the right margin of the Terminal window.

  • Top Bar: The terminal keyboard is attached to the top margin of the Terminal window.

Terminal Kbd Shape

Specifies the shape of the graphical terminal keyboard. The values are:

  • Full Size (default): This is the largest and most complete version—all keys, including alphanumeric keys, are shown.

  • Mini Size: Similar to Full Size, but without the alphanumeric keys.

  • Vertical: Displays a long, narrow keyboard, without alphanumeric keys.

  • Horizontal: Displays a wide, short keyboard, without alphanumeric keys. This setting is relevant only if Terminal Keyboard Mode is set to Floating.

Terminal Kbd Tether

Specifies whether the location of the graphical terminal keyboard is tied to the Terminal window's location.

When the value is Yes (default), the terminal keyboard is tethered to the Terminal window--when you move or resize the Terminal window, the terminal keyboard moves, tracking the nearest corner of the Terminal window. When set to No, moving the Terminal window has no effect on the location of the terminal keyboard.

This setting is only relevant if Terminal Keyboard Mode is set to Floating--that is, if the terminal keyboard is not attached to one of the margins of the Terminal window.

Terminal Kbd Visible

Specifies whether the graphical terminal keyboard is visible. The default is No.

Host Events

Allow Keys During Wait Commands

Specifies whether the user can use the terminal keyboard while an operation containing a Host Events command is executed on the host. The default is Yes.

Display

All Font Character Sets

Specifies whether non-ANSI fonts can be used for the display font. The default is No. Selecting Yes means that non-ANSI fonts are available to use as the display font.

After setting this value, click Display on the Settings menu, and then click the Fonts tab. The Font box will list all the ANSI and non-ANSI fonts that are available for use as the display font.

Automatic Font Sizing (setting)

Specifies that the Design Tool automatically adjusts the font size to fit all text in the Terminal window for whichever font or style you select.

By default, Auto Font Size is enabled. To change the font size, set this setting to No.

BDT Ignore Scroll Lock (setting)

Specifies whether the Design Tool ignores the state of scroll lock when connecting to the host. The default is No.

Caps Lock State (setting)

Specifies whether the Design Tool is in Caps Lock mode. The default is No. This state is not saved as part of a model or settings file.

Caption

Specifies the string that appears in the Design Tool title bar. This string is relevant only when the Help display mode is Status Bar (default). This string is also displayed on the taskbar when the Design Tool is running.

Select a predefined option from the list box, or enter up to 260 characters in the box. As you click on predefined options, shortcuts for these options are added to the box.

The predefined options and their shortcuts are:

Shortcut Option
&r "Verastream Host Integrator"
&f Model File Name (or "Untitled" if a model file is not open)
&s Session Type
&t Transport
&h Host Name
&d Date
&c Connection Status (whether you are connected and over what transport)
&v Assigned Device Name
&& Single Ampersand
&p Script debugging port

So, for example, if you set the Caption to &s - &t - &c, you might see "IBM 5250 Terminal - Telnet - Connected" in the Design Tool title bar or on the taskbar, assuming the Design Tool is running but not minimized. The default is &f - &r - &s.

Current Cursor Column (setting)

Returns the current cursor column location relative to the left edge of the Terminal window. This setting is read-only.

Current Cursor Row (setting)

Returns the current cursor row location relative to the top edge of the Terminal window. This setting is read-only.

Current Display Height (setting)

Specifies the number of rows in the current display height.This setting is read-only.

Note: The value of this setting includes two non-addressable rows dedicated to the Operator Information Area (OIA), so the display height's actual number of addressable rows is the number of addressable rows minus two (2).

Current Display Width (setting)

Specifies the number of columns in the current display width. This setting is read-only.

Current Screen Selection Mode

Specifies what mode to use for the region selected on the terminal screen.

Select Linear to use word processor style selection regions that wrap lines, or Rectangular to use rectangular regions. The default is Rectangular.

This setting is read-only.

Default Screen Selection Mode

Specifies what mode to use when you select a new region on an entity.

Select Linear to use word processor style selection regions that wrap lines, or Rectangular to use rectangular regions. The default is Rectangular.

Display Margins

Specifies whether to display margins around the Terminal window. If the Display margins box is checked (default), text will not touch the sides of the Terminal window. Instead, a margin or border is displayed. Displaying margins may improve readability.

If you want text to fill the entire screen, clear this check box. If this check box is clear, text can touch the sides of the Terminal window, which may be useful for smaller monitors and notebook computers.

Depending on the screen resolution and the size of your Terminal window, you may not see an effect in the Terminal window when you clear this check box. This is because each character takes up the same number of pixels and if your Terminal window is sized so that its width is not evenly divisible by the number of columns, the Design Tool centers the text on the screen.

Display Variable Width Fonts

Specifies whether proportionally-spaced font types appear in the Fonts box. The default is Yes.

Event Handler Toolbar Visible

Specifies whether the event handler toolbar is visible. The default is Yes.

Font Character Set (setting)

Specifies the character set that Host Integrator uses for its user interface. The values are:

  • Ansi Character Set (default)
  • Baltic Character Set
  • Chinese Big5 Character Set
  • East European Character Set
  • GB2312 Character Set
  • Greek Character Set
  • Hangeul Character Set
  • Hebrew Character Set
  • Johab Character Set
  • Oem Character Set
  • Russian Character Set
  • ShiftJis Character Set
  • Turkish Character Set

Font Name

Specifies the display font in the Design Tool session window. You can use any font, including TrueType fonts. Arial is an example of a TrueType font that is not monospaced, and therefore is not supported by the Design Tool. By default, the Design Tool uses the r_ansi font. This provides a 24 x 80 display that accurately emulates the terminal. When you resize the Terminal window, the Design Tool chooses a new font size so the correct number of rows are displayed on the screen. If the Design Tool cannot display the font you have chosen, the default (r_ansi) is displayed instead.

The available fonts can change as you change the model ID in the Session Setup dialog box because not all model IDs support all fonts.

Note

When you print all or part of a host screen from a terminal session, the font used is the currently configured display font.

Font Size

Specifies a font size that the Host Integrator uses in its Terminal window. The range is from 6 to 32 points. The default is 12 points.

Font Style

Specifies a font style: regular or bold. The Design Tool does not support italicized fonts. The default is Regular.

Height of Window

The Design Tool can display a brief message about the currently selected menu, menu command, or button on the title bar (above the Terminal window) or in the status bar (below the Terminal window). By default, help messages are shown in the status bar.

Specifies the height (in pixels) of the Terminal window. The range of values is from 0 to 4095. The range of acceptable values and the default vary depending on your screen resolution and video driver.

Help Display Mode

The Design Tool can display a brief message about the currently selected menu, menu command, or button on the title bar (above the Terminal window) or in the status bar (below the Terminal window). By default, help messages are shown in the status bar.

Left of Window

Specifies the location of the left Terminal window margin (in number of pixels from the left margin of the screen). The range of values is from -2147483648 to +2147483647. The default is 0.

Model Toolbar Visible

Specifies whether the toolbar is visible. The default is Yes.

Mouse Shape

Specifies the appearance of the mouse pointer in the Terminal window. The values are:

  • Default arrow: The mouse pointer appears as the Windows default arrow.

  • IBeam (default): The mouse pointer appears as an I-shape.

  • Rectangular: The cursor appears as a rectangle.

National Character Set

The values identify the various host character sets that Host Integrator supports for 5250 and 3270 terminal emulation. The list varies slightly between 3270 and 5250 sessions. Host Integrator uses this setting to choose a conversion table that it uses to convert host characters (EBCDIC) into PC characters (ANSI).

This setting should match the national character set used by your host system. If it doesn't match, then some characters, such as accents, may not display correctly. See your host documentation for definitions of the characters in each set. The default value is US English.

Num Lock State

Specifies whether Host Integrator is in Num Lock mode. The Design Tool does not change the state of Num Lock, although the model can affect the Num Lock setting if the state of Num Lock is changed as part of building or loading a model.Note: If the model changes the state of Num Lock, you may need to toggle your workstation's Num Lock state after closing the model. This is especially critical for laptops. This state is not saved as part of a model or settings file.

Scroll Lock State

Specifies the state of Scroll Lock in Host Integrator. This state is not saved as part of a model or settings file.

Secondary Selection End Column

Returns the ending column for the pattern definition location. This setting applies when defining a pattern in an expanded region. This setting is read-only.

Secondary Selection End Row

Returns the ending row for the pattern definition location. This applies when searching for a pattern in an expanded region. This setting is read-only.

Secondary Selection Start Column

Returns the starting column for the pattern definition location. This applies when defining a pattern in an expanded region. This setting is read-only.

Secondary Selection Start Row

Returns the starting row for the pattern definition location. This applies when defining a pattern in an expanded region. This setting is read-only.

Selection End Column

Returns the ending column for the current selection. This setting is read-only.

Selection End Row

Returns the ending row for the current selection. This setting is read-only.

Selection Start Column

Returns the starting column for the current selection. This setting is read-only.

Selection Start Row

Returns the starting row for the current selection. This setting is read-only.

Status Bar Text

Specifies the string that appears in the Design Tool status bar. Select a predefined option from the list box, or enter up to 260 characters in the box. As you click the predefined options, shortcuts for these options are added to the box. The predefined options and their shortcuts are:

Shortcut Option
&r "Verastream Host Integrator"
&f Model File Name (or "Untitled" if a model file is not open)
&s Session Type
&t Transport Type
&h Host Name
&d Date
&c Connection Status (whether you are connected and over what transport)
&v Assigned Device Name
&& Single Ampersand
&p Script debugging port

So, for example, if you set the status bar text to &s - &t - &c, you will see "IBM 5250 Terminal - Telnet - Connected" in the Design Tool status bar.

The default is &s - &c.

Substitute Display Chars (Substitute "0" with "Ø")

Specifies whether zeroes displayed in the Terminal window contain slashes (like this: Ø). Selecting this option may make it easier to work with numeric data. By default, this check box is cleared. This check box has no effect on fonts that, by design, already display zeroes with slashes.

Toolbar Visible

Specifies whether the toolbar is visible. The default is Yes.

Top of Window

Specifies the location of the top Terminal window margin (in number of pixels from the top margin of the screen).

The range of values is from -2147483648 to +2147483647. The default is 0.

Width of Window (setting)

Specifies the width (in pixels) of the Terminal window.

The range of values is from 0 to 4095. The range of acceptable values and the default vary depending on your screen resolution and video driver.

Window State

Specifies the state of the Terminal window. The values are:

  • Maximized: The Terminal window is maximized.

  • Minimized: The Terminal window is minimized.

  • Restored (default): The Terminal window is neither maximized nor minimized.

Help Display Mode

The Design Tool can display a brief message about the currently selected menu, menu command, or button on the title bar (above the Terminal window) or in the status bar (below the Terminal window). By default, help messages are shown in the status bar.

Model File

Specifies the name of the model file currently open in the Design Tool. This setting is read-only.

Save Window Position

Specifies whether you want to save the position of the Entity window when you exit. The values are:

  • Disabled: Does not save or load the previous position. This is the default option.

  • Last position used: Uses the last position of the model window.

  • Position saved with model: Saves the position of the model to the model file and only loads that position.

Settings File

Returns the name of the open settings file. If no settings file is open, an empty string ("") is returned. This setting is read-only.