Starting sessions with bookmarks or icons

A security warning window may appear while you are using Z and I Emulator for Web. The content of the window depends on your browser. The purpose of the window is to tell you that Z and I Emulator for Web was created by HCL Technologies Ltd. and to ask whether you trust it. You must click Grant or Yes to continue. To stop the window from reappearing, click:

  • Remember this decision (Netscape).
  • Always trust content from HCL Technologies Ltd. (Microsoft Internet Explorer).

Creating a bookmark to bypass the logon window

  1. Click Start > Programs > HCL Z and I Emulator for Web > Administration.
  2. Click Clients and Utilities.
  3. Click the Z and I Emulator for Web client you want to start.
  4. Enter your user ID and password, then click Log On.
  5. After successfully logging on, create a bookmark for the page using your browser's bookmarking function.

The next time you want to start Z and I Emulator for Web, use the bookmark you created. The session starts without having to logon.

Anyone with access to your workstation can use the bookmark you created to logon to Z and I Emulator for Web with your ID.

Creating a bookmark that automatically starts a session

  1. Start the Z and I Emulator for Web client you want to bookmark.
  2. At the logon window, enter your user ID and password, then click Log On.
  3. Right-click the icon for the session that you want to autostart with a bookmark.
  4. Click Set Up Bookmark.
  5. Select whether your session is to run in a separate window or in an HTML page within the browser window.

    Choose Run in a window to run the Z and I Emulator for Web session in a window separate from your browser. This means that you can move and re-size the session window independently of the browser window and that the host session remains visible if you browse other Web sites.

    Choose Run in an HTML page to run the Z and I Emulator for Web session as an HTML page embedded in your browser window. This means that the host session runs within the browser window and that you cannot move or resize it independently. If you browse another site, the session remains active but you cannot see it until you return to it (with the browser's Back button). Sessions bookmarked as Run in an HTML page do not have a menu bar.

  6. The session starts. When prompted, bookmark the page.

The next time you want to start Z and I Emulator for Web, use the bookmark you created.

  • The bookmark is based on the session name. If you change the session name or delete the icon for the session after you have created a bookmark, the bookmark will not work.
  • Anyone with access to your workstation can use the bookmark to log on to Z and I Emulator for Web with your ID.

Creating a desktop icon for a bookmarked session

  1. Create a desktop icon from your Z and I Emulator for Web bookmark by dragging and dropping the bookmark onto your desktop (not all browsers have this capability).
  2. Double-click the Z and I Emulator for Web desktop icon to start a session.

Your browser probably lets you select it as your default browser. If you create a desktop icon with that browser, and later make another browser the default, the icon you created to start Z and I Emulator for Web may not work.

Bookmarking limitations

Locally-installed clients

You cannot use bookmarks to launch sessions on locally-installed clients.

Browser access

When creating bookmarks to launch sessions, Z and I Emulator for Web assumes that access to the browser is secure. If a browser contains a bookmark that bypasses the logon process, any person with access to the browser can use that bookmark to access Z and I Emulator for Web.

Error 501

Some Web servers do not support Z and I Emulator for Web's bookmarking feature. When you attempt to load a client from one of these servers, the following message appears: Error 501 (Sorry, this server does not perform searches).

This problem has been observed on the following Web servers:

  • IBM Internet Connection Server 4.x on iSeries

To avoid this problem, edit the client HTML file (default.html, for example) and add the following parameter:


<param name=bookmarking   value="false">

Although the client will now load properly, users will not be able to use the bookmarking feature for their sessions.

If you are using the client, the procedure for disabling the bookmarking feature is different from that used with other clients. To disable bookmarking, do the following:

  1. Edit the HTML file for the client (default.html).
  2. Search for the following string:
    
    var enableBookmarking       = true;
    
  3. Change the line as follows:
    
    var enableBookmarking       = false;
    

Bookmarks and multiple users

If more than one user creates bookmarks with the same browser, users cannot switch between the bookmarked sessions without closing the browser and restarting it. If a user logs on with a bookmark and then attempts to load another user's bookmark, the client will not load properly. To avoid this problem, log off, close the browser, and then restart it if you want to log on again using another user's bookmark.