The purpose of the Host Simulator tool is to capture interactions between a
terminal and a Telnet server and record the interactions in a trace file.
This file can be used to simulate a live connection to the original
Telnet server, or to play back those recorded interactions.
For instance, you might want to work with host screens offline, or you
might want to provide others access to your screens without providing
access to the original host.
Before you begin recording a session, there is an option related to the Host Simulator console that you should know about and consider. Under the File menu, select Options. There are two selections on the Options menu that are independent of each other. One of the options is Verbose Output. This option controls how much information is displayed in the Host Simulator console. By default, the Verbose Output option is checked, which means you will see more information than when it is not checked. The other option is Playback. The Playback options are defined in the section on Playing back recorded sessions.
To record a trace in Host Simulator, follow these steps:
In the Host Simulator console, you should see the message:
"Server is listening on port 7021".
To set up HATS to record a trace, follow these steps:
Host name: localhost Port: 7021 Type: 3270 or 5250, depending on your host system.
Setup is now complete.
You can record HATS sessions either by running an application or using the HATS Host Terminal.
To record HATS applications, follow these steps:
"Server has accepted a client connection." "Connected to the host "your host" at "your port."
"Session Ended" "Record Session Ended by user"
The trace of the application is recorded in the file named in the Save simulation as field of the Host Simulator.
To record other interactions outside of your HATS application, follow these steps:
"Server has accepted a client connection." "Connected to the host "your host" at "your port."
"Session Ended" "Record Session Ended by user."
The trace of the HATS session is recorded in the file named in the Save simulation as field of the Host Simulator.
Before you begin playing back a recorded session, there are some options affecting the playback that you should consider. Under the File menu, select Options. There are two selections on the Options menu that are independent of each other. One of the options is Verbose Output. The Verbose Output option was described in the section on Recording sessions. The other option is Playback. The Playback options determine the length of time between recorded screens during the playback. The options are:
When you have started the playback, client usage information is available. Under the View menu, select Connection Information. A Client Connection Information window appears and contains the following information:
These values are subject to the recorded session parameters.
To play back a recorded session, follow these steps:
In the Host Simulator console, you should see the message:
"Server is listening on port 23".
To play sessions on the HATS Host Terminal, follow these steps:
Host name: localhost Port: 23 Type: 3270 or 5250, depending on your host system.
"The server has accepted a connection from "your host"."where "your host" is either the host name or the IP address of the machine where the playback will be displayed.
Besides launching the Host Simulator tool from the Start menu, it may also be launched from a command prompt. The general form of running the tool from a command prompt is as follows:
java -classpath %CLASSPATH%;hostsim.jar com.ibm.HostPublisher.HostSim.Hostsim [filename] [mode] [port] [time delay] [server] [minimum] [maximum]
Note: This command assumes that a supported Java VM is included in your command path and that you are issuing this command from the directory where the tool was installed.
The order of the arguments is important. For example, to specify the mode, you must also specify the filename.
Argument | Description |
---|---|
filename | The relative or full path of the trace file being recorded or played back. Enclose long filename paths in double quotes. |
mode | Specifies the initial startup mode. Valid values: RECORD or PLAYBACK |
port | During playback, specifies the TCP/IP port to listen on for client connections. For recording, specifies the TCP/IP port of the telnet server (typically 23). |
time delay | Specifies the playback time delay. Valid values: NONE, RANDOM, or ACTUAL. |
server | Specifies the IP address or host name of the telnet server; only applicable during recording. |
minimum | Specifies the minimum delay (in seconds); only applicable when the time delay argument is set to RANDOM. |
maximum | Specifies the maximum delay (in seconds); only applicable when the time delay augment is set to RANDOM. |
Copyright International Business Machines Corp. 2004. All rights reserved.
No part of this publication may be reproduced, photocopied, stored on a retrieval system, transmitted, or translated into any language without the express written consent of the publisher:
International Business Machines Corp.
P.O. Box 12195
Research Triangle Park, NC 27709-2195
USA
Note to U.S. Government Users - Documentation related to restricted rights - Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.
This program is provided as is; IBM is not responsible for any mishaps to persons or property caused by the usage of Host Simulator.