CLEO Logo

CLEO Message

Home Getting Started Fundamentals Applications Feedback & Support Glossary Acknowledgments Table of Contents

 

 

Back
Up
Next

GBO Logo

CLEO Launch
CLEO Message
Status Screen
Manager Control
Scan Coordinator
Antenna
Servo Monitor
Accelerometers
Motor Rack
Prime Focus 1 Rcvr
Prime Focus 2 Rcvr
1-2 GHz Receiver
2-3 GHz Receiver
4-6 GHz Receiver
8-10 GHz Receiver
12-18 GHz Receiver
18-26 GHz Receiver
I.F. Manager
L.O. 1 Rack
I.F. Rack
Converter Rack
Analog Filter Rack
Switch Sig. Selector
DCR
Spectrometer
Spectral Processor
Holography Backend
VLBI-DAS
Weather Station
Tipper
Archivist
Site Timing
Device Explorer
Sound Server
ActuatorCal
Analyze Messages
Save / Load All
CLEO Clock
Gateway
Scheduler
Sticky Notes
LST Appointment Manager
VNC Tool
TkCon Console

Introduction:

CLEO Messages is an application that receives all incoming messages from M&C Control regarding the events that are continuously being monitored.  These events may occur due to any number of reasons or combinations of errors or information.  Some of these events might be as harmless as some incoming information about a Manager being on source or as Fatal as a message regarding a Device that is not responding to its Manager.  All of these types of message, as well as anything in between, need to be constantly monitored.  To try to make sense of the data that is constantly coming in, an attempt to make a user friendly application to display this data was made.  We call this CLEO Messages.  CLEO Messages is a way of organizing all of the data being received and displaying it in a user friendly application.  Many of the aspects about this application are dynamic and can be specified and changed by the user, over and over again.  Others cannot be changed due to their being color coordinated for meaning and clarity.  There are different icons, row colors, tab names and colors, width of columns, etc.  This application has the ability to create up to ten tabs with user specified names, descriptions, and foreground colors for the tabs, delete any number of tabs after you have created them, to have multiple tabs that can be viewed at one time, copies of messages going to different tabs for different reasons, hiding and resizable columns, extended text, sorting, filtering, drag 'n drop, users input as to suggestions for any changes, as well as many more enhancements that can, and hopefully will, be used.  I hope you enjoy the application and that it enhances the readability of the incoming data and makes it more understandable to the common user.

Main Display

 

Concepts:

Drag and Drop:

Drag 'n Drop is a process used to assign a permanent move or copy of certain Devices, Managers, or Messages to a particular tab.  The Drag 'n Drop is used on both the main display and on Tabs Manager.  In either case, the Drag is initiated with a left hold of the mouse, Drag to the appropriate tab or tab name, and drop the message by Device, Manager, or Message.  If you choose to copy the message to a tab by Device, all messages that come in for that particular Device.

Logging:

Logging is basically a way of keeping a history of messages that are suggested to be grouped together for some particular reason.

Message Types:

Messages come under five different types:
  • Assert - A message as it is originally received.  Usually waiting to be cleared.
  • Clear - A message that has been asserted previously and gets cleared.
  • sysUp - A message informing that a system is going up.
  • sysDown - A message informing that a system has gone down.
  • Transient - A message of an event that has happened.  Does not wait for a clear.
Multiple Tabs:

Multiple tabs are useful  for viewing more than one message table at a time.  These tables can contain specific Devices, Managers, Messages, or any combination of the above.  The maximum number of tabs that can be created at this time is ten.  Although small, all ten tabs can be viewed at the same time if needed.

Resizable columns:

Columns can be resized by using the mouse to do a left hold on the column separator and moving the mouse left or right.  The columns on either side of the separator will shrink or grow respectively.

CLEO Messages Start Up Window

When Cleo Message is started, the first screen will be the Configuration and sounds screen.  Here is where you can choose to load a configuration by checking the check button.  You can then either type in the file name or browse for the file name.  To have sounds, you must again check the check button and can specify what computer you the sounds to come out of.  After clicking OK, the changes will take place and the main display will come up.


Main Display

Tear-off Tabs:
Right-single-click on a tab label will tear off any number of tabs the user chooses.  There can be as many tear off tabs as needed.  To put the tab back, either right-single-click on the tab label again, or close the tab using the "X".
 
Drag 'n Drop:
Left-single-hold over first column of icons.  This will result in the picking up, or drag, of a message.  To drop the message, move the mouse over another tab label and let go.
 
More Info Popup:
Right-double-click on a row.  This will bring up all information we currently know about the message in this row.
 
Sort or Hide/Show:
Right-single-click on a column label heading will bring up a menu containing the option to Sort or to Hide/Show a column.
  • Sort - Increasing or Decreasing by column that was chosen.
  • Hide/Show - Hides the chosen column, or shows individual or all columns that have been hidden.  For obvious reasons, you can show any hidden column by choosing any column label or heading.
Highlighting:
Selections of rows are made by:
  • single-left-click = single row selection of one only.
  • ctrl-single-left-click = individual row selections of one or more rows.
  • shift-single-left-click = all rows between first and last selection.
 
Resize Column:
Left-hold on column separator and move the mouse left and right.  This will resize the columns on either side of the column separator.
 
Extend Text:
When the mouse is stationary over a text window, and the text is longer than the window itself, the text will be displayed on a popup extension over top of the original text.  This extension has word wrap so none of the text of the message will be lost.

Menu Bar

File Menu

Save Configuration:

Save Configuration will bring up a separate popup screen to save the current configuration to a user specified file.  This will enable the user to retain all specifications that he/she has made regarding filters, tabs, devices, etc.

Load Configuration:

Load Configuration will also bring up a separate popup screen, but this time it will give choices for loading a configuration from a previously saved file containing your specifications.

Save/Print Tab

Save/Print Tab is a menu button that will display all of the tabs that are currently created, as well as an "All" label.  You may choose an individual tab or all of the tabs to save or print their current information.

Quit 

Quit is just another way of exiting the program.

Help Menu

The Help selection on the menu bar is the same as most of the other CLEO applications, so it will not be explained here.

 

Common Tool Bar

 

Auto Remove:

The Auto Remove button will automatically remove messages that have been cleared if they are of the level and of the type that you have specified under the Levels button.  Auto Remove can be turned on or off by selecting the check box.

 

Level:

The level button controls which messages will be displayed and which messages will be removed when they are cleared.  This button has two basic functions, to set the levels and to set the types of these messages.  The level is controlled by the slider.  As the slider is moved up, the level that will be removed when the messages are cleared moves up.  If the level is highlighted, all levels from that point down will be removed.  The type is controlled by check boxes.  If these boxes are checked, they will not be displayed when they have been cleared, the entire row will just be removed.  For these changes to actually take place the user must press the OK button.



Create/Delete/Edit Tabs

The Create/Delete/Edit Tabs button brings up a popup window that allows the user to create their own tabs with their own characteristics, delete current tabs, and change existing tabs.  All tabs are subject to these changes except the default tab.  The default tab is always created, and cannot be deleted, changed, or moved, so it does not appear on this screen.

Name:
 
Name is an entry field for a user specified name for a chosen tab.  There is no restriction on the number or on the type of characters used in the name.
 
Description:
 
Description is a text box for a user specified description for a chosen tab.  Again, no restrictions on the number or the type of characters used for the description.
 
Tab Color:
 
Tab Color is a menu button containing a selection of colors for the user to choose from for a chosen tab.  The user is restricted to choosing from the menu instead of entering their own color.
 
New:
 
New creates new tabs with default values it can use until the user changes them.  There is a maximum of 10 tabs in this application, but this can be changed if needed.
 
Delete:
 
Delete must have a selection from the Tabs list box so it knows what tab to delete.  When deleting a tab, a notice will come up asking if you are sure you want to delete this tab.
 
Tabs:
 
The Tabs list box that contains the names of all of the tabs, except the default tab.  These names are in order of the tabs appearing in the notebook.  When a tab's name has been changed, it will appear in this list box under the new name.  To see what the other attributes about a particular tab are, you can make a selection in the Tabs list box and the name, description, and color will appear in their appropriate entries.
 
Up Arrow:
 
Up Arrow moves the selected tab up the list of tabs closer to the default tab.
 
Down Arrow:
 
Down Arrow moves the selected tab down the list of tabs away from the default tab.
 
Apply:
 
Apply accepts and makes all changes, but will not destroy the popup window.
 
Cancel:
 
Cancel will not accept or make any changes and will return to the main screen after destroying the popup window.
 
OK:
 
OK will accept and make all changes and will return to the main window after destroying the popup window.
 
  • How to use:

This is the way the user dynamically creates the number and the look of the tabs they are wanting.  The user will first need to press the "New" button, then supply a name, description, and tab color for that new tab.  This can be done to create a maximum of ten tabs.  If at any time, the user wishes to delete a tab, they must first choose the tab name from the list box, then press delete.  To edit or change an attribute about a tab, the user must first select a tab name from the list box, then make the changes in the entry field that applies to the change.  Beside the Tabs list box, there is an Up arrow and a Down arrow.  To use these arrows, first make a selection in the Tabs list box, then press the Up arrow if you want that tab to be moved closer to the default tab, or the Down arrow if you want that tab to be moved away from the default tab.   For any of the above changes to take place, the user must press "Apply" or "OK".  If "Cancel" is pressed, none of the creations, deletions, or changes will take place.

 

Tabs Manager:

The Tabs Manager button brings up a popup containing four list boxes:

  • The first list box contains the names of all of the tabs in the notebook.  The font is a little larger in this field for drag and drop procedures.
  • The second list box has two fields.  If a message is being placed in a tab due to its device name, the tab name and the device name are displayed in this box.
  • The third list box has three fields.  If a message is being placed in a tab due to its manager name, the tab name, the device name, and the manager name are displayed in this box.
  • The fourth list box has four fields.  If a message is being placed in a tab due to the message itself, the tab name, the device name, the manager name, and the message are displayed in this box.

The Tabs Manager has four other buttons of some interest:

Undo/Redo:
 
Undo/Redo will change the application back to its state one step prior to its last change.  The one exception to this is a deletion of a tab.  Once a tab has been deleted, it cannot be brought back.
 
Show All Messages:
 
Show All Messages, when checked, will display all messages that are assigned to a specific tab, including those on the default tab.  When this is not checked, only those messages that have been specified by the user will be displayed.
 
Update:
 
Update is basically a refresh button for any changes that have been made but were not seen by Tabs Manager.
 
Close:
 
Close will discontinue this screen only.


The Tabs Manager is a useful tool in keeping track of what messages, managers, and devices have been assigned to what tabs.  These assignments can be easily changed by dragging and dropping the message on this popup from one tab (source tab) to another tab (drop tab).  The source tab must be chosen from one of the list boxes containing a blue column (boxes 2-4), and the drop tab must be chosen from the pink list box (box 1).  An attempt to move messages in any other way on this popup will result in an error message.  To sort the columns, just click on the label of the column you want to sort on.  The first click will be an increasing and the second will be a decreasing sort.

Remove Cleared:

Remove Cleared removes all messages that have been cleared but are still being displayed.  This would include all transients, sysUps, and sysDowns.

 

Refresh:

The Refresh button will retrieve all messages from the database and display them on their appropriate tab.  Before this takes place, an error message will ask the user if they really want to refresh all of the tabs.  If the answer is yes, this may take some time.
 

Quit:

The Quit button will close the entire application and program.
 

Tab Tool Bar

This row of buttons contains the features that apply to a particular tab only.  For example, the Filters and the Level being sorted by can be different for each tab.

Configure Filters:

The Configure Filters button brings up a popup that allows the user to specify what messages they do not want to see displayed on the screen.  The user can filter out four different categories.  These are Levels, Devices, Hosts, and Assert Times.  The buttons located directly above the Configure button turn these filters on or off respectively.

 
  • Levels will filter out any message being received that is of the level you have specified.  If checked, that level will be left out of the display, if not checked it will be displayed.  The "Set all" and "Clear all" buttons are for easier use when wanting to filter out more than you want to see.

  • Devices, as shown above, will filter out the device names that you have moved from the Unfiltered side of the table (left) to the filtered side of the table (right).  This move can be accomplished by selecting one at a time and pressing the arrow going in the respective direction, making a selection as is done in windows with control left select and shift left select, or by moving all of the devices to the filtered side and moving back the ones you do not want filtered.  The single arrow moves a single selection in the appropriate direction and the double arrow moves all devices in the appropriate direction.

  • Hosts works the same way as Devices, only it's for Hosts.
  • Assert Time is the time that a message is actually received by Monitor & Control.  This window is used for setting a particular time range that you do not wish to see.  One that you wish to have filtered from view. The Assert Time window has two sections, the Start time and the Stop time.  The Start time is where you enter the beginning time for the filter and the Stop time is where you enter the ending time for the filter.  When this window comes up, it is in its default setting of "None", which means no filtered times.  To make any changes you must first turn the checkbox beside the word "None" off.  To change the Start Time, which is in UT Time, use the arrows on the screen to scroll to the appropriate time.  To set the date, click on the button beside the date entry that has "..." on it.  This will bring up a small calendar.  The months on the calendar can be changed by pressing the arrows by the month at the top, then click on the day you wish to set the filter to.  If you want the filter to start now, instead of going through all of that to get the settings, just press now and the time and date will be inserted for you.  These changes are the same for Start and Stop.  Again, for any of these changes to take place, you must press OK or Apply, and you must turn on the filter.

Turning on/off filters:

To turn on and off the filters, there is a row of buttons just above the Configure filters.  When the filter is turned on, it will be depressed and yellow in color.

Auto Scroll:

The Auto Scroll button moves the view of the screen to where the newest message was placed.  Again, this can be turned on or off by pressing the checkbox.

New Message:

The button beside the "New Message" label lets the user choose where they want a new message to be placed.  This button works with the Auto Scroll button.


Sorted by:

Sorted by tells you what column the tab is being sorted by and in what direction, increasing or decreasing.  It also gives the user another opportunity to change these values if needed.
 

Suggestions:

To be able to bring up the suggestion window, you must first make a selection from the original display.  The selection can be as small as one or as large as all.  Once you have made the selection, you can press the suggestion button.

Types of Suggestions:
  • Comments are for when you just want to send a comment regarding the selected messages.
  • Inhibition is used when a particular message comes in so you do not display, you hide, a list of other messages.
  • Inference is used when a group of messages come in and you do not want to see them all.  You just want to see a certain message.
  • Log/Sound is used for keeping track, logging, certain messages and for making suggestions of sounds for certain messages or groups of messages.

The window starting with the label "Level", displays all of the messages that you have selected in the original display screen.  The comment area is just for writing any comments you may have, or that you want someone to know about.  Beside the comment section is a message box that gives some direction as to what you have selected and what you should do.  Send is what you press to send your "Suggestions" to the appropriate person via e-mail, so that a specified person can review the possible changes and prioritize them as well as approve them.

Defining Inhibition and Inference:

The Suggestion window will be a useful tool in communication between the users, the programmers, and the people keeping track of the database.  To give a better explanation of Inhibition and Inference I am going to use some examples.  Inhibition is like when you get a message that the power source has been unplugged, but it hasn't been shut down properly.  You get 5 error messages saying that the power source is down and receivers 1, 2, 3, and 4 aren't working due to a lack of power.  Instead of all of these messages, why not just display the actual cause, that the power source is down, and get rid of the ones saying that the receivers aren't working.  The other messages could be inhibited by receiving that one message about the power source.
Inference is when you make clear cut assumptions and conclusions about certain messages.  This would be like the reverse of Inhibition.  If you find that receivers 1, 2, 3, and 4 are not working due to a lack of power, you may want to just display that the power source is down.  Inference is like giving a possible cause for a certain set of messages.

 


Copyright 2000 Associated Universities, Inc. Washington D.C., USA
Modified: 22 November, 2000 by Ronald J. Maddalena