In the settings page, the 10 possible host connections are presented as a simple set of 10 rows, each row representing a host connection. For more details of each entry on this page, click on the prompt for a particular attribute and the help for that attribute will be displayed. If you are not using the public access sites that you might have optionally configured during installation, you can remove them now, and then allocate more sessions to your host access.

If you didn't define a host access for your system, you can either add it to the bottom of the current list, or replace the first line with your host definition. When you've added either an SNA LU Pool name or *TN3270:Yourhost and a session range, use the Submit Button to enter-- note the messages and use the back-button to correct any errors.

1. Open the ScreenSurfer folder from the desktop
2. Open the "HTML Templates" folder found in the ScreenSurfer folder
3. Open the "Global.stml" file: at this time, if you do not have an association for files with the extension of ".stml", the system will ask you for one. Select an editor of your choice, and if you do not have one, select the "Notepad.exe" program.
4. At installation, the top of the file defines the "home page", which begins with:

   <TESECTION HOME>
   

5. Note the patterns in the list of connections, with HTML links defined specifying a "LU_GROUP_1" along with text referencing a particular host. Depending on how you defined your host in the Console Settings Page, you will either modify one of these lines (to change the text of the link to something describing your host), or copy one of the lines for modification.
6. Either copy or modify the appropriate line relating to the line in the settings page the defines your host connection.
7. Save the global.stml file
8. If ScreenSurfer is already started, stop it with the ScreenSurfer Service Applet (in the next step we will restart--when you add or update host configurations, you need to fully stop and restart ScreenSurfer for the new configuration to become active).
9. Restart ScreenSurfer in diagnostic mode--this way, you can watch it perform the connection to your host and view any error conditions that may result (for example, maybe you keyed a TN3270 address incorrectly
10. Open the Web Gateway Page in a browser window (using your bookmark created in the prior section or the ScreenSurfer folder)
11. Click on your host link you created in step 6
12. After 5-10 seconds, the first page of your host connection should be displayed
13. If your host page doesn't display, please check the diagnostic window for any messages that might help you in "tweaking" your host definition on the Console Settings Page
    • If you don't understand an error, or do not see any, please e-mail your \ScreenSurfer\hostsurfer\surfdiag.log file to surfer@ieinc.com along with a note describing the type of host access you were attempting as well as any symptoms you viewed during the connection attempt
14. With a successful host page display, you can now "speed-up" the initial connection by following the steps in the next section

1. Load the DevCenter in your browser--it is recommended that you have at least SVGA resolution to use the DevCenter, and a full 1024 x 768 resolution is recommended.
2. Click on the Session/Screen Select link in the upper left (menu) frame;
3. Click on the Start New Session menu link; the Web Gateway Home page is displayed in the primary frame
4. Select your host connection in the primary frame
5. When your initial screen is (finally!) displayed, click on the "green screen" icon in the banner graphic (upper right); a fixed-format view of your screen is displayed
6. Click on the View Words button in the upper portion of the primary frame-- your screen is now displayed as links
7. Select a field at the top of the screen that is "fixed text" and can be reliably used to identify the initial screen; click on the field with your mouse
8. Details about the field you just clicked on are now available in the lower left frame; scroll down in this frame until you see "When Clause"; swipe the contents of the right side in this frame with the mouse and copy to the clipboard with ctrl-c
9. Now move focus to your global.stml editor window (or open global.stml as in the previous section)
10. Insert the following at the top of global.stml:

    <TECONNECTED WHEN [copy contents of clipboard here]
    

11. Move focus back to DevCenter, and select a field that is once again "static text" and will be on the opening screen every time; this time, select a field as close to the bottom of the screen as possible
12. Click on the field; find it's "when clause" in lower left frame, copy the clause to the clipboard
13. Return to your editor, insert a line below the one you just created and key:

      AND [copy contents of clipboard here]>
    

    Note the closing angle bracket to complete the TECONNECTED TAG. A sample of your completed TECONNECTED tag might look like:

    <TECONNECTED
     WHEN Screen_1_2 IS "Welcome to Frankfurters Incorporated"
      AND Screen_24_50 is "Copyright 1982">
    

14. Save global.stml
15. Focus back to DevCenter; Click on the "Wave" icon in the upper graphic banner; this switches the primary frame view to the active emulation window
16. Click on the "Exit" link in the emulation page to return the primary frame to the connection menu
17. Click on the arrow pointing up/left in the menu frame
18. Click on Development Administration
19. Click on Recompile Templates; status for the template compile will appear in the primary frame.
20. Try your Web Gateway connection to your host again; it should open very quickly now...

1. Open the /ScreenSurfer/hostserver/global.stml file in your editor. If you have not got a "favorite" editor, the notepad.exe editor will do. An easy way to open global.stml file is in the Templates Folder which has a link from the ScreenSurfer folder installed on your desktop.
2. Scroll down or search for the line <TESECTION DEFAULT>. There is no further identification in the TESECTION tag, because the ScreenSurfer compiler automatically recognizes the DEFAULT section by name (it is a reserved section name when inside the global.stml file).
3. All of the HTML between the <TESECTION> and </TESECTION> tag is displayed whenever a screen is unrecognized. You can modify the look and feel of this section all you want, but should remember the following points:
   • You should always retain the <HEAD> tag, particularly in the global.default section, as this is needed to provide the DevCenter with information about the currently displayed screen
   • The <TEMACRO TERMBODY> is needed to create the <BODY> tag with the correct code to position the cursor in the HTML Input field corresponding to the field containing the cursor in the active screen session
   • The <TEMACRO TERMFORM> is needed to create a <FORM> tag that has the correct ACTION attribute to maintain state with the active session.
   • You should always present a user with the Exit and Refresh links, although you may want to create custom SurferScript sections to handle them (as user-defined URL's).
4. Save the global.stml file when done with your modifications
5. Access the DevCenter
6. Select the Administration Tasks from the top menu
7. Click on "Recompile Templates"
8. If your changes created any compile errors, they are now viewable in the primary frame of the DevCenter--you will want to correct in the editor, save and recompile prior to testing
9. Bring a session up in another browser window and check-out the results!
10. You can repeat the previous edit-compile-test steps until the results are what you like-- when testing an active session, simply use the REFRESH link to view your changes (you don't need to restart the session).