ComCap Main Capture Window

When the ComCap tray version is started, it immediately minimises itself to the system tray, usually in the bottom right of the screen.  Left or right clicking on the ComCap icon will open the main ComCap window, with the Capture Log window on the left (first image below) and the Information Log window on the right (second image blow).  There is a narrow vertical splitter between the two windows that may be used to adjust the width of each, while the main window can be dragged by its edges or corners to increase or decrease its size.

(Main Window, Left, showing Capture Log Window)

(Main Window, Right, showing Information Log Window)

Capture Log Window

The Capture Log window is initially empty for a fresh ComCap install, the image above shows two serial COM and 16 network tabs that have been set-up through Common Settings, Network and Serial Ports. 

The tabs are coloured to indicate capture state. Silver means all capture is stopped, Green that the channel is ready to start capture or has already started to capture data and Red that capture for that channel has stopped or not yet started.  The brighter colour is the currently selected tab. 

Clicking on a tab changes the Capture Log window to the new serial or network channel and loads and displays previously logged data for that channel, if any.  This data may be initially several days old, since a new log is not opened until new data is captured.  The intention is that any recently captured data can be viewed, even when stopping and restarting capture.

Any channel can also be displayed by selecting it from the main Capture menu, and may be configured from the main Settings menu.  The title bar shows the configuration of the current channel:

Capture Log: CDRs COM3 (Serial Port COM3, Speed 9,600 bits/sec), Database: COMCAP

while the panel in the button bar show the current state of the channel:

From: COM3 (OK), Echo: UDP Send to IP 192.168.1.107:514 (OK)

The status bar below the button bar shows the time that the last line was captured, the number of lines captured since starting, optionally the number of rows written to the database, then the file name of the main current file to which this channel is being captured, and finally the date and time at which the capture file name will be rotated and a newly named file opened.

The status bar at the bottom of the window has five coloured indicators labelled CTS, DSR, DCD, RD and Echo which are made active for the current channel.  For serial ports, the first three show the status of the Clear To Send, Data Set Ready and Data Carrier Detect signal lines as green (low) or red (high), while for networks CTS indicates listening or attempting to connect, while DSR and DCD indicate an open connection.  The fourth Receive Data indicate will flash green for one second as data is received (for data at a rate of one line per second or faster it will stay green), while the first Echo indicator shows white for no echo, green if echo is OK or red if echo has failed.  Note the signal indicators are meaningless when capture is stopped. 

Right clicking on the Capture Log window displays a pop-up menu that offers further options, depending on whether capture is stopped or started, which are detailed below.  Most of these options are also available on the main menus.

Information Log Window

The Information Log window shows messages about which channels are being captured and their configuration such as to which log files and databases captured data is being written.  Typically, the status information is updated hourly for all channels with cumulative totals, but may be reported at any time by clicking the Status button.  Any capture errors are shown in this window.  Right clicking on the Information Log window displays a pop-up menu that offers further options which are detailed below

Start and Stop Capture buttons

The Start and Stop buttons allow capture to be started and stopped.  The actual action depends on whether the capture is by the Background Service or Tray applications, which is indicated in the status bar at the bottom of the screen on start-up.  If using the Background Service, the buttons will start and stop the service, if the logged-on user has the rights to do so (otherwise the buttons are disabled), and will also start the tray version monitoring the service, if so configured.  If capturing using the Tray application, capture will immediately start. 

When stopping capture, a dialog will appear to ‘Confirm Stop All Captures?’, in case the button is clicked by accident.  The confirm stop dialog will also appear when exiting the ComCap Tray version if capture has been started, but not if Background Service is being used.

Status button and Capture Status menu

The Status button and Capture Status main menu option are used to log the status of all capture channels, including all the current log files names.  This may be configured to occur every hour in Common Settings, Log Files.

Hide button and Hide Main Window menu

The Hide button and Hide Main Window file menu options both cause the main window to be minimised to the System Tray, while capture continues.

Stop Capture and Exit, and Exit menu option

The Exit file menu option and the X Close button in the top right Window cause the Tray version to terminate.  If the Tray version is performing capture, the option will say Stop Capture and Exit and the confirm stop dialog will appear before ComCap is exited. 

Pause Capture and Resume Capture right click menu

These options are only available if capture has been started, and allow a single channel to have capture paused and then resumed.  The tab description indicates any channels that are paused.  While paused, the Capture Settings may be changed.  This option may sometimes to be used to reset a network channel that gets stalled.

Settings menu and right click menu

Allows channel specific Capture Settings to be changed.  This may only be done while capture is stopped or the channel paused.

Edit menu options

There are various option on the Edit and window right click menus, that allow captured data to be selected and copied to the clipboard, Select All, Copy, and Copy All.  Clear may be used clear the current Capture Log window, but it will be refreshed if another channel tab is selected and then the current channel reselected. 

Stop Window Update right click menu

On the Capture Log window right click menu, Stop Window Update is a toggle option (ticked when set) that temporarily stops display of captured data for the selected channel only.  

Auto Scroll right click menu

On the Capture Log window right click menu, toggling Auto Scroll stops ComCap forcing scrolling to the end of the window before adding a new line of captured data.  However, this behaviour depends upon the version of Windows, it does not seem to have any effect on W2K, but with Windows 98 the log window will flicker less.  This applies to all channels.

Word Wrap right click menu

On the Capture Log window right click menu, toggling Word Wrap determines whether captured lines are word wrapped to the Capture Log window width, or displayed in a horizontally scrolled window.  This applies to all channels.

Scroll Tabs right click menu

On the Capture Log window right click menu, toggling Scroll Tabs determines whether multiple Capture Log window tabs are displayed in two or more rows, or instead horizontally scrolled by the left and right arrows.  This will only matter if about four or more channels are captured, where the number of lines of captured data that can be viewed will be reduced as the number of channels increases.   But scrolling means the capture state of all channels can no longer be easily checked since many tabs will be hidden.  This applies to all channels.  This option is set automatically if more than 32 channels are configured, since otherwise there is unlikely to be sufficient screen space to display all the tabs in rows. 

Log Font menu and right click menu

Allows the font used for the Capture Log and Information Log windows to be separately specified.  The Capture Log font must be fixed width, Lucida Console being very readable or else Courier New, usually sized at 8 point.  The Information Log window can be any font and defaults to Arial 8 point.

Load Full Log right click menu

Only available when capture is stopped, Load Full Log causes the full current log to be loaded for display.  Normally ComCap only displays the last few thousand lines (set in Capture Logging while this option will display all lines in the log in the Capture Log window, which might take a few seconds to display.

Database from Log right click menu

This option allows previously captured data to be added to the database, from the capture log.  This is typically done in a recovery situation when a database problem meant data was only captured to a log and not the database.  See Capture Settings, Database for more information.

Add Comment to Log right click menu

For some capture applications, it may be useful to add a comment into the capture log.  The right click menu Add Comment to Log option causes a small dialog will appear, allowing one or more lines to text to be entered, with tick boxes specifying whether blanks lines should be added before or after the text lines.  This feature is intended to assist in documenting batch captures, perhaps from laboratory instruments. Note the added text is processed in the same way as any normal captured line, which might mean serial number or time stamps being added.  Add Comment is only available when capturing using the Tray version. 

View Log Window menu and right click menu

For improved log viewing, there is also a resizable Log View window.  This may be opened from View Log Window on the right click menu when the current capture log will be loaded and displayed, or from View Log Windows on the file menu which will initially display a Select ComCap Log file selection window, allowing any log to selected and displayed.  The View Log window includes an Update Current Log (F5) menu option to reload the current log, or another log may be specified and opened.

Alert Window menu

The Alert Window normally appears automatically when an alert is triggered, but may be opened from the Alert Window file menu option. 

The Alert Window displays multiple alerts, which may be cleared individually, and will show alerts when the ComCap Background Service is running, provided the Tray application is also running.  Buttons available are Clear Some (selected alerts), Clear All Close and Close. 

Test Alert menu

To allow alerts to be tested, the Test Alert file menu options causes an immediate test alert, that may be displayed, sent as an email or an SMS to a mobile telephone, depending on which are set-up in Common Settings, Email/SMS.