3.1 Setting Up Hummingbird HostExplorer 7

This section provides information on the following:

3.1.1 Creating the Emulator Macro Script

  1. Create and configure a session in the emulator for your environment, then open the session.

    Opening Hummingbird HostExplorer 7
  2. Click Tools > Quick Script > Edit.

    The Quick Script Option
  3. Double-click Untitled: Description of Quick Script.

    An Untitled Application in Quick Script
  4. Specify a filename and description for the Quick Script, then click OK.

    Ensure that the filename is only one word (no spaces).

    Name and Description Fields

3.1.2 Configuring Hummingbird HostExplorer for Usernames

  1. In the Login dialog box, click Commands > Wait For Text.

    The Login Screen for Hummingbird HostExplorer
  2. Configure the Wait For Text dialog box for username prompts, then click OK.

    The Wait For Text Dialog Box
    • In the Text field, specify the text that the server displays when it prompts for a username.
    • Check the Anywhere check box.
    • Specify a timeout period.

      We recommend a setting of five seconds.

    • From the If Found drop-down list, select Pop Up a Message.
    • From the Otherwise drop-down list, select Pop Up a Message.
    • In the If Found pane, click Properties, configure the Popup Message Box window, then click OK.
      A Popup Message Box for Usernames
      • Specify the username in the Title field.
      • Specify the username in the Message field.
    • In the Otherwise pane, click Properties, configure the error box, then click OK.
      A Popup Message Box for Username Errors

      This is the message that is displayed if the prompt text is not found within the set timeout period.

      • In the Title field, specify a title for the error dialog box.
      • Specify a message in the Message text box.

3.1.3 Configuring Hummingbird HostExplorer for Passwords

  1. In the Login dialog box, click Commands > Wait For Text.

    The Login Screen for Hummingbird HostExplorer
  2. Configure the Wait For Text dialog box for password prompts, then click OK.

    Configuration fields for the Wait For Text Dialog Box
    • In the Text field, type the text that the server displays when it prompts for the password.
    • Check the Anywhere check box.
    • Specify a timeout period.

      We recommend a setting of five seconds.

    • In the If Found pane, select Pop Up a Message from the drop-down list.
    • In the Otherwise pane, select Pop Up a Message from the drop-down list.
    • In the If Found pane, click Properties, configure the Popup Message Box dialog box, then click OK.
      The Popup Message Box for Passwords
      • Specify Password as the title.
      • Specify Password as the message.
    • In the Otherwise pane, click Properties, configure the error box, then click OK.

      This is the message that is displayed if the prompt text is not found within the set timeout period.

      In the Title text box, specify a title for the error dialog box.

      Specify a message in the Message text box.

  3. At the Login dialog box, click File > Save As.

    The Login Screen for Hummingbird HostExplorer
  4. Specify Login as the filename, click Save, then close the Quick Script editor.

    The Save As Screen

The macro is now complete.

3.1.4 Configuring the Emulator Session

  1. Click Options > Edit Session Profile.

    The Edit Session Profile Option
  2. (Conditional) Select not to use the SecureLogin wizard at this time.

    If SecureLogin prompts you to run the SecureLogin wizard, check the Don’t Prompt Me In the Future check box, then click No.

    The Prompt for the SecureLogin Wizard
  3. Expand the session in the Settings Groups panel.

    Click General in the Settings Groups panel, then click the Browse button next to the Auto Start Quick-Key drop-down list.

    The Settings Group Panel
  4. Browse to where you saved the Quick Script macro file, then click Open.

    The default path is c:\Documents and Settings\All Users\Application Data \Hummingbird\Connectivity \7.10\HostEx\QuickScript\Login.qsv.

    Browsing to the Quick Script Macro File
  5. Click OK, then close the emulator.

  6. Open the session again.

    You can use the shortcuts on the Start menu, then follow the prompts, or create a shortcut directly to the session.

    To create a shortcut directly to the session, use the following format:

    "Path to hostex32.exe" –P Session name
    

    For example, type

    "C:\Progra~1\Hummingbird\hostex32.exe" –P Session1
    

    The emulator connects and displays the following dialog box.

    The Emulator Dialog Box

    IMPORTANT:Don’t click OK.

3.1.5 Creating a SecureLogin Application Definition

  1. Right-click the SecureLogin icon on the system tray, then click Add Applications.

    Add Applications Option
  2. Click next until you reach the Select a Web Site or Application dialog box.

    The Single Sign-On Enable An Application Dialog Box
  3. Select Windows Application, then click Next.

  4. Drag the hand icon and drop it onto the title bar of the Username dialog box.

    Selecting a Login Panel
  5. In the Select Window Function dialog box, select Login Window from the drop-down list, then click Next.

    Selecting a Window Function
  6. Select the login fields.

    Selecting Login Fields
    1. Drag the hand icons and drop them onto the Username, Password, and (if appropriate) Optional fields.

    2. Drag the hand icon for the OK Button and drop it onto the login button (for example OK, Next, or Continue).

  7. Click Next, confirm login details, then click Next again.

  8. In the Name the Application Definition dialog box, specify a name, then click Finish.

3.1.6 Enabling Hummingbird HostExplorer for Single Sign-On

  1. Right-click the SecureLogin icon on the system tray, then click Manage Logins.

  2. Select hostex32.exe from the My Logins list, then click Edit.

    Selecting an Application
  3. Click Definition, then edit the application definition.

    The Definition Tab

    Place the following application definition:

    Dialog
     Class #32770
     Title "Username"
    EndDialog
    
    Click #2
    
    Delay 50
    Type -raw $Username
    Type -raw \N
    
    Dialog
     Class #32770
     Title "Password"
    EndDialog
    
    Click #2
    
    Delay 50
    Type -raw $Password
    Type -raw \N
    
  4. Click OK twice, then close SecureLogin.

3.1.7 Testing the Configuration

  1. Start the emulator session, specify your username, then click OK.

    Starting an emulator session
  2. (Conditional) Respond to error messages.

    Depending on the values that you entered for the Timeouts in the emulator macro, the error message might be displayed after you click OK.

    If the error message is displayed, click OK to close the session, then restart the session. This might happen twice. To avoid the problem, raise the timeout value in the Macro settings, or enter the username and password more quickly.

  3. Specify the password, then click OK.

    Entering a password

    SecureLogin launches the emulator, enters your username and password, and logs you in to the session.

    Successfully Logging in to a Session