2.7 Set up Custom Controls for Working with Host Screens

You can enhance your program interface using InfoConnect hotspots (virtual buttons that appear over text in terminal sessions).

If you work with 3270 or 5250 terminal sessions, you can customize host sessions with Micro Focus Plus controls to provide a modern interface with new features and capabilities.

2.7.1 Define hotspots

Hotspots are virtual buttons that appear over text in terminal sessions. By using hotspots, you can control your terminal session with the mouse instead of the keyboard. Typically, clicking a hotspot transmits a terminal key or command to the host, but you can also configure hotspots to open a Web page, launch a macro, or perform a variety of other actions.

You can create new hotspots or set sessions to use customized hotspots files that you have used in other sessions, including hotspots files used in previous versions of InfoConnect.

NOTE:InfoConnect hotspots files are saved as .xhs files.

To create and configure a customized hotspots file

  1. Open the Document Settings dialog box.

    The steps depend on your user interface mode.

    Ribbon or InfoConnect Browser

    With a session open, from the Quick Access Toolbar, click .

    TouchUX

    With a session open, tap the Gear icon and then select Document Settings.

    Classic MDI

    With a session open, go to Options > Settings

  2. Under Terminal Appearance, click Manage Hotspots.

  3. Click Create a new hotspots file from an existing hotspots file.

  4. In the Create a New Hotspots File dialog box, select the type of hotspots file (built-in, Custom, or the new file for the current session) to use as a template for creating a new hotspots file.

  5. In the Modify Hotspots dialog box, under Hotspot text, enter the host screen text for the hotspot.

  6. Under Select an action to map to the hotspot, select an action to map to and configure the action.

  7. When prompted, save the new hotspots file.

  8. On the Quick Access Toolbar, click the Save button to save the session.

    The session is automatically configured to point to the new hotspots file.

To set up a session to use a customized hotspots file

  1. Make sure the hotspots file is in a trusted location.

  2. Open the Document Settings dialog box.

  3. Under Terminal Appearance, click Manage Hotspots.

  4. Click Select another hotspots file.

  5. Select Custom and browse to the file you want to use.

    The selected file is displayed under currently selected file.

  6. Save the session.

    The session is configured to point to the new hotspots file.

To enable hotspots and specify which mouse actions trigger them

  1. Open the Document Settings dialog box.

  2. Under Terminal Appearance, click Set Up Hotspot Display Settings.

  3. Select Enable all defined hotspots.

  4. Under Mouse Activation, configure the mouse actions that you want to trigger your hotspots.

2.7.2 Set up QuickPads

A QuickPad is a small window that you can load during a session. QuickPads can contain text, buttons, bitmaps, icons, and other graphic elements. The buttons and icons on QuickPads can be linked to any of the Actions available in the Select Action Dialog Box.

How To Use QuickPads in Reflection Desktop (4:07)

To create a QuickPad

  1. Under Terminal Appearance, click Manage QuickPads.

  2. Click Create a new QuickPad.

  3. Use the QuickPad Designer to configure your QuickPad.

  4. Click OK. Use the Save As dialog box to save your QuickPad file (*.rqpx).

To add a QuickPad to your session

  1. From the Manage QuickPads dialog box, click QuickPad Selection.

  2. In the Available QuickPads list, select the QuickPad and click OK.

    The QuickPad is now set to display when you open new sessions using this document.

2.7.3 Create a custom context menu

You can create custom context menus for frequently used commands. After you create a custom context menu, you can map a mouse action to open the new menu.

  1. Start a terminal session.

  2. At the top of the Context Menudialog box, click Addand enter the name of your context menu.

  3. Add the menu items and separators for your new menu.

  4. Under Menu Itemsettings, enter the label and select an action for each item.

  5. Click OKto save the new menu.

Next, you'll want to make a right-click open the new custom context menu instead of the default.

  1. Under Mouse Mapper, for Key Combination, select Rightand then click Modify.

  2. From the list of actions, select Show Specific Context Menu.

  3. On the right, from the Context Menu, choose the name of the new custom context menu.

2.7.4 Use Micro Focus Plus Screen Designer

If you work with 3270 or 5250 terminal sessions, you can use Micro Focus Plus Screen Designer to customize host sessions and provide a modern interface with new features and capabilities. The Screen Designer provides a number of modern controls that you can add to your host screens to provide a more modern user experience for your host programs. Some examples of how you can use the Screen Designer include:

  • Adding tool tips to fields to help your users get over the difficult spots in your application.

  • Replacing old-style numbered option lists with more modern drop-down selection lists.

  • Adding buttons to the host application's interface and programming them to start macros or perform other actions.

  • Replacing manual entry of dates with a graphical calendar date-picker.

What you need to do to use the Screen Designer with InfoConnect

You’ll need to follow this process to set up Screen Designer controls on a session.

NOTE:

  • You can only customize screens for 3270 mainframe and 5250 IBM System i sessions.

  • InfoConnect Desktop Plus does not support Japanese and other languages that use double byte information.

  • When you run a macro in Plus mode, controls do not appear on any customized screens until the macro reaches the final screen.

Get and save a screen history

  1. Open the Screen History task pane.

    The steps depend on your user interface mode.

    Ribbon

    On the Session ribbon, click the Screen History button.

    InfoConnect Browser

    On the InfoConnect menu, choose View and then Screen History.

    TouchUX

    Tap the Wrench icon and then under View, select Screen History.

    Classic MDI

    From the Productivity menu, select Screen History.

  2. Navigate through the screens you want to modernize.

  3. On the Appearance tab, in the Plus group, from the Plus drop down list, select Export History for Screen Designer.

Use the Screen Designer to set up the controls on the screen

Follow this basic process to set up the controls. For detailed instructions, see the online Help provided with the Screen Designer.

  1. On the Appearance tab, from the Plus drop down menu, select Screen Designer.

  2. Create a new project, and then import the screen history.

  3. Add static controls in the Screen Design view.

  4. For dynamic control or conditional controls, create rules in the Rule Manager window.

  5. Generate a Screen Designer customization file. Be sure to save the file in a trusted location, such as your user data directory.

    The customization (.rdar) file is an archive file which contains the rules file (.rsdo) and resource files such as images, macros, and scripts.

Set up your session to use the controls

  1. Open your session and select the Appearance tab.

  2. On the Plus drop down list, choose Select Plus Customization File and then select the customization file you created for this session.

    The controls you created are displayed on the session file screens.