Customizing the Display and Printer session interfaceView menuView propertiesRocket TE Mainframe and iSeries toolbars

Rocket TE Mainframe and iSeries toolbars

Rocket TE has several toolbars that allow quick access to many functions. The toolbars can be customized by the end user or customized by the Rocket TE administrator to match the emulator being replaced.

Toolbar types include:

  • Menu Buttons: Provides one click access to any function accessible through the menu system.

  • 3270 or 5250 Keys: Sends the indicated aid key to the host.

  • Quick Colors: Allows the user to quickly select and change emulation colors.

  • Auto-Entry: Saves all or selected user input and automatically reenters it when selected from the list.

  • TN3270E or TN5250E: Provides quick access to TN related functions including a drop-down box showing TN connections, launching the session configuration dialog, starting, stopping and viewing traces.

    Note: This is the only toolbar that cannot be customized.

Rocket TE toolbars are completely user definable. Buttons can be removed, added and rearranged on the Rocket TE toolbar.

To customize a toolbar, click View → Properties from the Rocket TE menu bar, and click the Toolbars tab.

Toolbars tab

The Toolbars tab is used to control which toolbars are displayed in the Rocket TE display session and the look and feel of the buttons. It is also used to customize the toolbars.

The Settings group is used to set the availability of the toolbars on the desktop:
Show Menu Buttons
If selected, the main Rocket TE Iconic toolbar (Menu Buttons) is displayed.

  • Customize: Click to customize the toolbar.

    Toolbar Buttons
    Displays the buttons in the order they appear (from left to right) on the toolbar in the active window. To add a blank space in the toolbar, highlight the button that should appear to the left of the space, and click Separator. To remove a button from the toolbar, highlight it and click Remove. To reposition a button, highlight the button and click Up or Down.
    Add
    Click to open the Button Properties window, where you can create a new button for the toolbar.
    Edit
    Click to open the Button Properties window for the highlighted button, where you can customize the button's appearance and behavior.
    Open
    Click to open a saved toolbar file.
    Save As
    Click to save your customized toolbar file.
Button Properties
The Button Properties window opens when you click either Add or Edit.
General tab
  • Show Label: Select the check box to include a label on the button. Enter the label in the text field.
  • Show Image:: Select the check box to include an image on the button. Select an image from the menu or click Browse to select an image from your computer.
  • Enable ToolTip: Select the check box to include a ToolTip that will appear when you hover your mouse over the button.
Action tab
To assign an action to the button, choose the type of action you need from the Action Type list on the left side of the window. The list on the right side of the window will contain all available actions of the selected type. The Action field displays the action currently assigned to the button.
  • Action Type: A list box that contains a list of all the Rocket TE action types that can be mapped.
    • 3270 Functions / 5250 Functions: Lists the 3270 or 5250 functions and what keys they are currently mapped to.
    • 3270 Characters / 5250 Characters: Lists special 3270 or 5250 characters like the Cent Sign, Logical Not, and the Solid Vertical Bar and what keys they are currently mapped to.
    • Menu Hotkeys: Lists the Rocket TE menu items available for key mapping.
    • PC Data Keys: Lists the PC Keyboard Keys available for key mapping.
    • APL Characters: Lists APL graphics characters and what they are currently mapped to.
      Note: The APL Characters action type is not available for 5250 sessions.
    • Macros Files: Lists the macro files available for key mapping. Rocket TE macro files are created by selecting Macro → Record from the Rocket TE menu bar.
      Note: When Macro Files is selected, only macro files from the Rocket TE program directory will be listed for selection.
    • Script Files: Lists the script files available for key mapping. Rocket TE script files are created by selecting Script → Record from the Rocket TE menu bar.
      Note: When Script Files is selected, only script files from the Rocket TE program directory will be listed for selection.
    • ASCII Characters: Lists the ASCII characters available for key mapping.
    • Send Keys: Used to send specific text characters or API Keys. Double-click in the action list to add a key to the Action text box.
    • Run Program: Used to call a specific program to run.
    • Toggle Power Pad: Used to toggle back and forth between two or more power pads. To use this feature, you must have at least two power pads defined. This feature allows you to create a button on the first power pad that toggles on and off a second power pad.
      Note: Be sure not to configure the first power pad to toggle itself. It is possible to create a button on the second power pad to toggle the first power pad. This feature can be useful if users have a large number of power pads. You can create a master power pad that has individual buttons that toggle each power pad.
    • Mouse Functions: List mouse functions available for key mapping.
Show 3270 Keys or Show 5250 Keys
If selected, the 3270 or 5250 Keys toolbar is displayed.

  • Customize: Click to customize the toolbar.

    Toolbar Buttons
    Displays the buttons in the order they appear (from left to right) on the toolbar in the active window. To add a blank space in the toolbar, highlight the button that should appear to the left of the space, and click Separator. To remove a button from the toolbar, highlight it and click Remove. To reposition a button, highlight the button and click Up or Down.
    Add
    Click to open the Button Properties window, where you can create a new button for the toolbar.
    Edit
    Click to open the Button Properties window for the highlighted button, where you can customize the button's appearance and behavior.
    Open
    Click to open a saved toolbar file.
    Save As
    Click to save your customized toolbar file.
Button Properties
The Button Properties window opens when you click either Add or Edit.
General tab
  • Show Label: Select the check box to include a label on the button. Enter the label in the text field.
  • Show Image:: Select the check box to include an image on the button. Select an image from the menu or click Browse to select an image from your computer.
  • Enable ToolTip: Select the check box to include a ToolTip that will appear when you hover your mouse over the button.
Action tab
  • To assign an action to the button, choose the type of action you need from the Action Type list on the left side of the window. The list on the right side of the window will contain all available actions of the selected type. The Action field displays the action currently assigned to the button.
  • Action Type: Refer to the Action Type descriptions listed in the previous section for the supported Action Types.
Show Quick Colors
If selected, the Quick Colors toolbar is displayed.

  • Customize: Click to display the Define Custom Colors dialog. Select the desired color and click OK to accept the changes. The changes are not saved until you click File → Save.

    Note: To use the Quick Colors toolbar, position your mouse pointer over the desired color on the Quick Colors toolbar and click once with the left mouse button. Drag the mouse pointer to the desired area on the display screen to change colors and click once with the left mouse button. If the color of letters is to be changed, make sure the cross-hatch is directly over a spot on the letter. If the cross-hatch is off by just a little bit, the background color will change.
Show Auto-Entry
If selected, the Auto-Entry toolbar is displayed.

  • Customize: Click to display the Customize Auto-Entry Toolbar dialog.

    Maintain Current List Manually (stop recording all events):
    If enabled, no new events will be added to the Auto-Entry toolbar drop-down list.
    Record Input Fields - Associate AID-Key with Last Field:
    If enabled, the last text event recorded for the screen will auto-send the associated AID-Key on playback.
    Record Input Fields - No AID-Key Association with Last Field:
    If enabled, the last text event recorded for the screen will not auto-send an AID-Key on playback.
    Record Upload and Download Host File Transfers:
    If enabled, host file transfers (IND$FILE 3270 only) will be recorded in the Auto-Entry list.
    Record Macro File Playbacks:
    If enabled, Macro playbacks will be recorded in the Auto-Entry list.
    Record Script File Playbacks:
    If enabled, Script playbacks will be recorded in the Auto-Entry list.
    Clear Auto-Entry List:
    Select this button to remove all entries from the Auto-Entry drop-down list.
Show TN3270/E or Show TN5250/E
If selected, the TN3270/E or TN5250/E Quick Access toolbar is displayed.
Toolbar Size:
To change the size of the toolbar, select Small, Medium, Large, or X Large from the drop-down box. The default setting is Medium.
Parent topic: View properties