This page contains the manual of the terminal capture utility.
The utility generates Emulator Emulator (.ee) and Emulator Emulator Master (.eem) files. The emulator files contains definitions of terminal screens. This means the terminal fields, text, layout and colours. The master file contains the information of the host dynamics (i.e how to move between screens). Together, these files can be used as the basis for NetPhantom application development. For further details on this topic, please see the NetPhantom documentation.
The basic functionality of the utility is to connect to an existing host, display a terminal window, extract information and save it in the files mentioned above. The following paragraphs provides some level of detail of these steps.top
When the utility is started, the working directory is established. The working directory will hold the utility configuration (capture.ini) and the generated files. If the utility is started from the file system directory directory (as a runnable "jar" file), by default the directory from where it is started is selected as the working directory. If the utility is run in a browser (applet) or if the directory from which it is started is not writable, the home directory of the user is selected as the working directory.
If a file called "capture.ini" is found in the working directory, the information is used as the initial configuration. If no such file is found, it is created (empty).
The current working directory can be displayed using menu File - Show Working Dir
The connection configuration is done by selecting menu: Connection - Configuration
The configuration consists of the following parts:
The connect action is performed by selecting menu: Connection - Connect
Once a connection is established, it can be terminated with the deconnect action. This action is performed by selecting menu: Connection - Deconnect
The connection status is displayed in the lower left corner of the terminal window.
The EE files (the individual screen) can be recorded in two ways:
The EE files are put in the working directory and are named "Screen<sequential number>.EE".
The EEM file is generated at utility exit and is based on all the screens displayed during the time when the option was active. The option is activated by selecting Catch - Generate master file on exit. Please note: The actions for changing between screens are not automatically recorded in the EEM file. These can be specified using a specific EEM utility.
The exit action is performed by selecting menu: File - Exit
If the "Record EEM" option is active, the information about the session and recordings is collected and a new EEM file (named "Master.EEM") is created.
After that and if the utility is started as an application, any open connection is closed and the application is terminated. If the utility is run in a browser, the application (in this case, the browser) is not terminated but the other steps are done like previously described.top