User Guide for the Capture and Replay Mechanisms
In Habanero 1.0
Draft1 - 01/26/98 - Annie Chabert
Habanero 1.0 supports the Capture of Habanero collaborative sessions as well as the Replay of those sessions in a single-user and stand-alone mode. This paper describes the different functionality inherent to the Habanero 1.0 Capture and Replay mechanisms. First, we present the process to capture a live session, then the Replay Editor is discussed.
Capturing a session
While you are collaborating in an Habanero session, you have the possibility to keep track of your collaborators as well as any collaborative actions they will perform in the session's applications. Capturing a session is a non-collaborative process done on your local machine. If several participants want to capture a same session, there are several ways to do so. Either anyone records the session at his/her own pace on his/her local machine; or only some of them record the session and then make the data available to anyone interested in (via files transfer protocol).
Recording a session:
Remember that you can only record a live session you are currently in. The following are the different steps to record a session:
All the captured data are stored in a specific directory named after the session name. You can enter another directory name if you desire (remember no spaces allowed).
If the given directory exists already and contains an archived session, a deletion box will ask you to agree to delete the old archived data. In the negative case, you have to restart the record process from the previous step and enter a new directory name to archive the current session.
Stopping the Record process
To end the Record process:
Once the Record process is over, you are able to continue to capture the session in another archived directory by starting a new Record process. But be sure to not override the data you just record by forgetting to change the archived directory name.
Make sure that the options names I put " " are the correct ones… I wrote this without running Habanero…
To be tested:
Replaying a session through the Replay Editor
The Replay Editor is part of the Habanero 1.0 package as a single user and a stand-alone application.
In this section, we describe how to launch the Replay Editor, then we detail the different parts of the editor.
Launching the Replay Editor:
Could you test and write this part… I am not sure of how we launch the editor on the different platforms and where the executable file is located.
Asking for the archived session to be replayed:
First, the Replay Editor requests you to select the archived session you want to replay by opening a file dialog box. This name is mandatory, and if you enter other directory names than the one containing an archived session, the Editor will end right there. The Replay Editor 1.0 supports only the replay of one archived session at a time, if you desire to replay few sessions, you need to run several instances of the Replay Editor.
Now, you have enter a correct archived session's name, the system is loading all the information concerning the session to-be-replayed. This process can take some time, upon to the length of the recorded session (i.e. the amount of the archived data). A status window is displayed during all the loading process to let you know the system is still working on your request.
Replay Editor overview:
The Replay Editor is then displayed and contains all the information concerning the archived session such as the collaborators' list, the tools' list, the collaborative actions performed, the time scales, etc.
The following screen shot presents the Replay Editor descriptive view of the content of a captured session, in terms of people, tools, actions and time.
Figure 1: screenshot of the Replay Editor

This screenshot is a very old one … Should be redone with more tools, people and different actions
As shown above, the Replay Editor window forms a sort of table that represents all the collaborative actions performed according to their time of occurrence, their tools' target, and their initiators. To describe the Editor, we will decompose it into five areas that will be detailed in the next sections:
Any of these panels are separated by resizing slide bars in order to increase and decrease independently the size of each panel. This facility gives a more accurate and comfortable view of the table.
Time area:
The Time area displays two time scales. The first one represents the time scale of the whole archived session. Where as the one below corresponds to the period of time displayed in the Actions area.
Both time scales display their time ranges on their corners. You can also slide the time on both time scales in order to browse different parts of the archived session. Sliding the time on time scales will position the Actions area at a specific moment during the session.
Tools area:
The Tools area contains all the tools that were up during the capture of the session. The tools' list represents the entry column of the table. Consequently, each line of the Actions area is associated to a tool; and actions on a line belong to this specific tool.
Each tool is viewed by its corresponding icon. However the first icon, the Habanero logo, does not represent a specific tool but the entire session in order to display in the Actions area the collaborative actions that occur at the session level (such as the participants' joining/leaving actions and the creation/deletion of tools).
As mentioned earlier, the tools' list regroups all the tools that were used at a time during the captured session. To show that a tool is not present at a certain moment (not been opened yet or already been closed), the background of its associated line in the Actions area is grayed out.
Selecting a tool icon allows you to "Bring to Front" or to "Put to back" the corresponding application's window as well as "Hide" or "Show" it.
Is there any pop up menu associated to the session icon?
Participants area:
The Participants area regroups all the collaborators that attended part or the entire captured session. This list represents the legend of the table: a unique pictogram (shape/color) is associated to each participant. This pictogram will appear in the Actions area each time he/she performed a collaborative action.
As mentioned above, this list regroups anyone who ever attended the captured session. The participants' leaving/joining actions will be represented in the Actions list on the first line (i.e. the session line).
Each participant is listed either by his/her name or his/her machine name and listening port number. To toggle the list between these two attributes, click on any name or machine name.
Could you make sure that:
Actions area:
The Actions area displays the content of the captured session. Each line is associated to a tool (from the Tools area) and contains all the collaborative actions performed in the specific tool. These actions are displayed by a pictogram, shaped and colored according to their originator. The Participants area legends the association between a person and his/her pictogram. The actions are also sorted horizontally by their time of occurrence upon the time scales.
Modes area:
The Modes area contains the Replay Editor modes: Replay mode, Edit mode, Restart mode and Quit mode. In the Habanero 1.0 version, only the Replay and Quit modes are available. To switch between modes, use the popup list button.
When the Replay Editor is launched the Replay mode is the activated one.
Activating this mode will close the Replay Editor.
Do I need to switch mode + click on anther button to close the editor?
In the Replay mode, you can replay the archived session an unlimited number of times.
The replayed functions are Play, Pause/Resume, Stop, Fast Forward, Fast Rewind, and also the possibility to set up the play speed rate to replay the session. All these functions are available in the Modes area via buttons and slide bars.
Selecting the Play button starts the replay of the archived session from its beginning, upon the speed you have entered via the Play Speed widget. The progression of the session is shown by moving both time scales at the right speed rate; and also by a time bar sliding at the same pace in the Actions area. This vertical bar reflects what action is replayed as the time goes by. In parallel, you can see the action been performed in real time in its collaborative application window.
Note that if you speed up the replay time rate, you might encounter some actions' overlaps or inconsistencies. Theses problems are due to actions' execution time: some actions such as the loading of some web resources required time. So, by speeding up the rate of the whole execution, the system might replay some actions while other are not yet been finished.
The Pause/Resume button allows you to pause the execution of the replay in order to resume it later on at this exact moment. This button is a switched button that will be labeled "Resume" or "Pause" according to the state of the replayed session. When you are in the Pause state you can browse, study the replayed session, look closer in the collaborative applications, wait until a long action will be fully executed etc… as well as stop the replay process.
Once you hit the Resume button, the session will continue to be replayed.
The Stop button stops the replay execution.
At anytime during the execution of the session, you can modify its speed rate. This modification will be taken into account right away.
The play speed can be increase up to ten times its normal speed. To increase, decrease the speed, slide up or down the slide bar of the Play Speed widget.
These facilities are not available in this version.
You are now ready to use fully the Habanero 1.0 Capture Replay mechanisms. Hope you will enjoy these new features
J .