The Host Integrator Session Monitor is a debugging tool that allows you to view host sessions connecting from Host Integrator Servers in real time. When you view a session with the Session Monitor, you can see every aspect of the interaction between the client application and the host. In addition to viewing host screens in a session, you can also record a snapshot of the images and play them back, which is especially useful for finding errors.
To begin, you must specify the name of one or more AADS servers on which the Host Integrator Servers containing the sessions you want to view are running.
To add a directory server to the Session Monitor's configuration
Repeat these steps for each directory server you want to add to your Session Monitor configuration. Once added, the directory server appears in the list of directory servers. To remove a directory server, select Remove Directory Server from the Configure menu, then select the server you want to remove from the list.Return to top
After you add one or more directory servers to the Session Monitor configuration, the Host Integrator Servers running beneath each directory server appear in the VHI Server list at the bottom of the Session Monitor main screen.
To connect to a Host Integrator Server
Once a connection is made to the directory server, the list of Host Integrator Servers running beneath it becomes available.
Note: If a Host Integrator Server becomes active after you start the Session Monitor, it will not automatically be visible. To refresh the list of available servers, disconnect and reconnect to the directory server under which the newly available server is running.
Once you connect to a Host Integrator Server, you can view all active sessions and session pools. Do so by selecting Active Sessions or Session Pools on the left portion of the screen.Return to top
After you connect to a Host Integrator Server, you can list the active sessions and session pools running on that server.
To list the active sessions or session pools
The Session Monitor displays the following statistics about active sessions on the currently selected Host Integrator Server:
Specifies the IP address of the machine connected to the server. If the session is suspended, this field will be blank.
Specifies the session pool used by this session.
Specifies the name of the model used by this session.
Specifies the name of the host this session is connected to.
Indicates the amount of time, in seconds, that this session has been connected.
Indicates whether the session is currently suspended. When the session is suspended, the Client IP and User ID columns for this session are blank.Return to top
After you connect to a Host Integrator Server, you can view active sessions on that server.
To view a session or session pool
A session view window opens, displaying the session you selected. The current state of the session is represented, including the cursor position. The session window displays a real time view of the state of the session. All entity navigations and attribute updates are visible.
In addition to viewing the session, the Session Monitor also allows you to record the session's screens. This makes finding errors easier, especially for sessions in which the host interaction is rapid.
Return to top
The Session Monitor allows you to record a session and play it back to aid you in troubleshooting errors. Any change to the host screen causes the Session Monitor to record the current screen as a record. By default, the number of records (screens) that the Session Monitor will record is 200. The maximum number of screens you can record is 2000.
Note: The host application model contains a setting called "Maximum Number of Consecutive Session View Partial Updates Allowed" which specifies the maximum number of partial screen updates that will be accepted by a Host Integrator Server from a character mode host. Partial updates are commonly sent via a datastream of characters on character mode hosts unlike block mode hosts, which often transmit one screen's worth of data at a time. Setting a maximum number of partial screen updates optimizes performance between the Session Monitor and Host Integrator Server.
Return to top
By default, the Session Monitor only refreshes the list of sessions or session pools when you click Refresh on the Session Monitor main screen. To turn on the Auto Refresh feature, which automatically refreshes the session list every 20 seconds, select Auto Refresh on the Configure menu.Return to top
The numbered list below includes all the error messages that can appear as you're using the Session Monitor and a brief explanation.
The operation failed. The remote object failed to send a response within a specified timeout period.
The server you are trying to connect to is not currently running or is shutting down.
The connection failed because the remote object did not send a handshake reply within specified time-out period.
A connection to the remote service cannot be made. Please verify that the services are running on the machine you are connecting to.
The service you are connecting to is no longer running. Its likely that it was removed because it timed out while waiting for client connection.
The service you are connecting to is shutting down. It is possible that the service was removed because it timed out while waiting for a connection.
A connection to the remote service cannot be made. Verify that the services are running on the machine you are connecting to.
Verify that the name of the host or server you are connecting to is correct.
Contact Technical Support.
A communication error occurred between the Administrative WebStation and the server. Log out from the Administrative WebStation and then log back in.
The operating system does not recognize the user ID or password. Verify the user ID and password and try again.
The user ID is not a member of an operating system group associated with the specified security profile. Please add the user to the appropriate operating system group.
Directory Services is a component of Host Integrator Authentication Authorization and Directory Services (AADS). When Directory Services is installed, a security certificate is issued, which makes it possible to secure the communication between Host Integrator Servers, the Session Monitor, and Directory Services. When this certificate is issued during installation, the fingerprint for the certificate is displayed. You must copy this number and save it for future reference. You need this number whenever you add a directory server to an Administrative WebStation configuration in the Set Directory Server dialog box.
Note: You may see this message if you have upgraded Host Integrator from a previous version. AADS connection names reflect settings from the earlier version of Session Monitor. To remedy this problem, delete all AADS connection names and then add the names again.
If the fingerprint that is displayed when you connect to a server, it means that the directory server has been reinstalled. Although this can be an indication of a security breach, in most cases it means that the administrator responsible for the server had to reinstall directory services. Contact that administrator for the correct fingerprint.
If you are unable to determine the cause of mismatched fingerprints, you can resolve this problem by reinstalling the AADS server. Be aware, however, that if you reinstall an AADS server, you will have to reinstall every Host Integrator Server that is registered to it.
Note: You can also view the fingerprint by opening the cert.fingerprint file on the machine where AADS is installed. Cert.fingerprint is installed in the <installed directory>/etc/aads directory.
The server could not establish a connection to AADS for registration. If this error occurs on startup, the server will immediately shut down. Check to see if AADS is running.
A given session can only be viewed by one window at a time.
Verify the inactivity timeout configured on the server or contact your system administrator.
An unauthorized connection to the server was attempted. You will get this error if you configured security profiles and turned on security for your server just now. You must first log out and log back in to get a new security token that is authorized to configured this server. If the problem persists even after you logout and log back in, contact Technical Support.
Links you directly to the technical support Web site where you can browse technical notes, download support software, and contact a support technician.