Creating and using a web session

To set up a web session you need to do the following:

• Save a local session with the desired settings
• Transfer the local session file to the web server
• Add web_session_name_x and web_session_url_x applet parameters to the HTML page used to load JET.
• Set the value for the web_session_url_x parameter to the http: URL for the session file on the web server.
• Set the last_web_session applet parameter to the index of the highest web_session_url_x parameter.

Here is an example of how to create and use a web session.

The example assumes that your workstation is connected to the Internet so that JET 3270 can connect to the Library of Congress TN3270 server at locis.loc.gov. If your workstation is not connected to the Internet but can access a local TN3270 server then you should be able to get similar results by substituting the hostname of the local TN3270 server where locis.loc.gov appears.

• Start JET 3270 from the original Shortcut.htm file.
  Note: Another web page can be used to start JET 3270 for this example if the web page does not have any applet parameters that start with disable_ set to yes.
• If JET 3270 is running within the browser window:
  • Click the Close Session toolbar button (trash can/garbage bin icon).
  • Click New Window.
    A JET 3270 window and Untitled Session Settings dialog box appear.
• If a JET 3270 window appears but no Untitled Session Settings dialog box appears:
  • From the Session menu select Close.
  • Click New Window.
    A JET 3270 window and Untitled Session Settings dialog box appear.
• If no JET 3270 window appears:
  • Click New Window.
    A JET 3270 window and Untitled Session Settings dialog box appear.
• Enter locis.loc.gov for Hostname on the Untitled Session Settings dialog box.
• Click Colours in the Category list.
  The Colours panel is displayed with Cursor Colour selected.
• Click the Choose Colour button.
  The Colour Selector dialog box appears.
• Select yellow from the list.
• Click OK on the Colour Selector dialog box.
  The Colour Selector dialog box disappears. The Cursor Colour square is yellow.
• Click Background Colour.
• Click the Choose Colour button.
• Select brown from the list.
• Click OK.
  The Background Colour square is brown.
• Click Display in the Category list.
  The Display panel is displayed.
• Select TimesRoman for Font.
• Select 12 for Font Size.
• Click OK on the Session Settings dialog box.
  The Session Settings dialog box disappears. The background colour and screen keyboard on the JET 3270 window change. JET 3270 attempts to connect to the host.
• Select Save As... from the Session menu.
  A Save Session As dialog box appears.
• Enter _session_name for the session name.
• Click Save.
• Select Close from the Session menu.
  The JET 3270 window disappears.
• Locate the local session directory.
  The location of the local session directory depends on the web browser and operating system.
  The general rule is that the local session directory is called .jet3270 and is a subdirectory of the user's home directory as given by the browser (i.e. the user.home system property).
• Locate the _session_name session file. It is in the local session directory and named "_session_name".
• Transfer the _session_name session file to your web server as a binary file. The way of doing this will depend on your environment. Alternatively copy the session file to another directory on you local file system. For example, C:\ on a Windows system or your home directory on a Unix machine.
• Determine the fully quailified URL that will access the session file on the web server. For example, if your web server's name was intranet.acme.com and you had transfered the session file to a jet/session subdirectory of the web server's document root directory then the URL might be:

  http://intranet.acme.com/jet/session/_session_name

  If you copied the session file to the C:\ directory on your Windows system the URL is:

  file:/C:/_session_name

  If you copied the session file to a /home/myuser directory on your Unix system the URL is:

  file:///home/myuser/_session_name

• Copy the original Shortcut.htm file to WebSession.html
• Open WebSession.html with a text editor. Delete the line that starts with:

  <param name="last_web_session" ...

  and add the following lines in its place:

  <param name="web_session_name_0" value="_session_nameWeb">
  <param name="web_session_url_0" value="url">
  <param name="last_web_session" value="0">

  Substitute the URL that will access the session file where url appears. Save these changes.

• Restart JET 3270 from the WebSession.html file.
• If JET 3270 is running within the browser window:
  • Click the Close Session toolbar button (trash can/garbage bin icon).
• Click the Open Session in New Window button.
  An Open Session dialog box appears.
• Click _session_nameWeb in the Web list.
• Click Open.
  A JET 3270 window appears with the title "_session_nameWeb - JET 3270", a brown background colour and screen keyboard buttons in a large Times Roman font. JET 3270 attempts to connect to locis.loc.gov . If it connects successfully the LOCIS main screen is displayed with a yellow cursor