logger - a client/server based logging system
Contents
1. 19 Acknowledging Message nenne nenn eiserne here 20 Seurehimo 1p Message ee ae ee ee ee a 20 Pie ren ee DT E E EE 20 Sendino Messa Oi si ron ee cic tame api aein oa oa Oebar saaarin 21 Contiguration of the Message Window eu iu 22 Conr urnon CONCE o assesi EA EEE NEEE eS E EEEE ERSE 22 Overall Configuration Structure ann nennen 23 Basic Message Window Configuration Layout u a a a ee 23 T Udo CaO ss oed Sue N 24 Ihe E OB T Tm 25 VIEW DINO T T E Mmm 25 rotis DV STA DD ERE 26 The ctl 2 OID aoe saeco ca saan ies dr dep sane cease iita iN er 21 File TS A Or ee ee ee ee rer 27 Interna Lu 28 The Messase File Torma ae ee en nee ernennt 28 The bosser ProtObDLoan aene nOL ee ee ee 20 A east aou ee 20 COREL HOD DISCODBO GEO ee nen 20 SALES IN OC O ee Eee 29 PSS UTS MESSE een ee 30 FORM 0019 1M 1 logger rtf Copyright by EADS All Rights Reserved AIRBUS DEFENCE amp SPACE Seite Page 2 2 5 Acknowledging Messages eie trot ricordi ie erinnere 320 I Cruel euim SUNMEMEM I CIBO 3 28 Summary ROUGE essien Eden Eo Sec Ua Nae PEE E Xe Pe FER e Ue Dee a uuo egre Pon Pd ode cused 3 29 HenUC lent C ompmuticaltlOR nu 3 2 10 SESSION OCCA ON Arena ee een enterprise eher FORM 0019 1M 1 logger rtf Dok Nr No Ausgabe2. Views can be given a name and kept in a view from where they can be selected and applied The configuration file s loaded by the program can predefine named views they are shown in the view list The user defined views are saved in the user configuration file on program termination Only those views that were created by the user or loaded from the user s own configuration file can be modified Views from other configuration files are protected against modifications The current view i e the one currently applied is stored as part of the user configuration on program termination It is automatically re applied when starting the program again FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 19 von of 31 3 2 8 Styles A style defines the appearance of a set of messages They can have special attributes like colour a symbol or a jingle Opening the style window new style can be defined or old styles can be changed or deleted If an existing style is selected at the left table on right table the corresponding attribute definitions are displayed You can define a color a symbol and a sound for a certain kind of message The kind of message is defined by a filter first column A style definition can have multiple attribute definitions These are ordered from top to bottom For example if
3. 3 2 6 Filters Filters can be used to reduce the amount of messages displayed Several filters can be defined given a name and kept in a filter list from where they can be selected and applied The configuration file s loaded by the program can predefine named filters they are shown in the filter list Only those filters that were created by the user or loaded from the user s own configuration file can be modified Filters from other configuration files are protected against modifications The current filter 1 e the one currently applied is stored as part of the user configuration on program termination It is automatically re applied when starting the program again To modify filters the filter definition form is used It is shown in the picture ER Manage Filters Filters New Edit Ss myfiter Delete The symbols before the filter definition name show a user filter definition here my filter is editable the other definitions are locked Locked definitions cannot be edited but they can be copied right mouse click The same symbols are used in the windows Manage Views and Manage Styles FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 9 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 17 von of 31 Mame New Message classes Regular expression ignore case NOT AND OR INFO Title L Lj
4. a mes sage is from the first kind filter Hallo it is red displayed even it is also from another kind later in the list The order of the attributes can be changed by the Up and Down Buttons Manage Styles Filter Color pa ma A a ee X L JL M9 opukde3 shal PEE jopt kde3 Wil opt kde3 shai Delete Add Remove Up Down FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 20 von of 31 3 2 9 Acknowledging Messages Messages may require acknowledgement by the user Such messages have an acknowledgement status indicator in their leftmost column a red exclamation mark if the message is to be acknowledged a small checked box if it has already been acknowledged 3 l FATAL 2007 07 17 08 3 CGS vm3a 227 Give me an acknowledge Biji FATAL 2007 07 17 08 3 CGS vm3a 227 s acknowledged O Z o A message can be acknowledged by selecting the message and clicking on the acknowledge button in the tool bar This will send an acknowledgement message to the message server which keeps track of all acknowledgements 3 2 10 Searching in Messages VIE SSH TENUIT UTI stunt pepe 1 Messages can be searched for certain contents in their text fields Clicking on the search bu
5. user config option The definitions of this file can be changed Options help Print help text and exit message window afterwards When the optional parameter is set the help is print ed more verbosely user config file name This option sets the user s configuration file which will be loaded The definitions of this file can be changed A user configuration file can be also loaded interactively Settings Open Configuration So it is not man datory to load it per command line option server host namerport Defines the host name and port number of the message server If omitted localhost 7250 is assumed COonnect Connect immediately to the server This option can t be used in conjunction with the file option file filename Open the message log file specified by filename This option can t be used in conjunction with the connect op tion incoming filter filtername filter definition This option defines a filter to load only those messages which match the filter into the Message Window An already defined filter name from config files can be used or a textual filter description defines a temporary filter which name is displayed as in_temp An incoming filter cannot be changed or disabled after start A textual filter description is composed of three optional components separated by commas The components are AND associated class filter String patterns time Filter class filter is an
6. view Views v Fiter test v Style NEWSUVIET Ack ld Class Local Time Mission Time Sender amp Host Tille h Text Locati 5 36 INFO 1 30 10 57 30 286907 30 10 57 30 286930 UTCTES_O1 vm2b Erroneous derived value 4 022 MY DV 539 INFO 1 30 10 57 30 430881 30 10 57 30 430853 UTC CIS_01 vm2b TES_01 has sent its distribution table 540 INFO 1 30 10 57 30 470735 30 10 57 30 470718 UTC CIS_O1 vm2b Reconnected to Oracle MDB MDB_S e 541 NFO 1 30 10 57 30 470970 30 10 57 30 470960 UTC CIS_01 vm2b Connecting to configuration control unit Eleme CIS 542 INFO 1 30 10 57 30 644977 30 10 57 30 644983 UTC TES_01 vm2b Initialisation parameters EUREC INFO Eee Em 547 INFO 1 30 10 57 33 475393 30 10 57 33 475385 UTC CIS_O1l vm2b CCU consistencyd 548 INFO 1 30 10 57 33 559709 30 10 57 33 559699 TC EE oLewnab_ MOE Soak to configuration 549 INFO 1 30 10 57 33 560474 30 10 57 33 560463 UTCICIS_01 vm2b MOIS Socket Intefface Server disabled Soc 550 INFO 1 30 10 57 33 560495 30 10 57 33 560491 UTCICIS_O1 vm2b Corba Interface Jerver started m Local time Mission time Location Title mE Message details Message list Split pane subwindow The Message Wind
7. Dok Nr No CGS RIBRE MA 0010 a i A R BU S g S Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 1 von of 31 DEFENCE amp SPACE Logger Titel g A client server based logging system Title Dokumenten Typ Konfigurations Nr User Manual Document Type Configuration Item No Referenz Nr Klassifikations Nr Reference No Classification No Lieferbedingungs Nr Freigabe Nr DRL DRD No Release No Gruppierung Dok Gruppierung Version Group Doc related Group Version related Thema Subject Kurzbeschreibung The document describes a client server based logging system that was developed for the CGS Abstract project but may be used in other software systems as well Autor Org Einh Unternehmen i CGS Team TE 55 Astrium Bremen Prepared by Organ Unit Company Gepr ft Org Einh Unternehmen Agreed by Organ Unit Company Genehmigt Org Einh Unternehmen Approved by Organ Unit Company Genehmigt Org Einh Unternehmen Approved by Organ Unit Company FORM 0019 1M 1 logger rtf Copyright by EADS All Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS g 5 Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 2 von of 31 DEFENCE amp SPACE Daten Dokument nderungsnachweis Data Document Change Record DCR Ausgabe Datum Betroffener Abschnitt Paragraph Seite nderungsgrund Kurze nderungsbeschreibung Issue pae Affected Section Parag
8. END request Send Message client gt server SEND lt message gt The lt message gt is a CSV encoded list of message components The structure is identical to the lt message struc ture gt returned with the connection acknowledgement Since the server does automatically add the message id the field must be really empty not 0 0 or The id field is always required even if empty and must be the first one in the character separated value Justification This has been defined for performance reasons since the server can directly deliver the message id concate nated with the received message to its subscribers without parsing it 5 2 5 Acknowledging Messages Server clients can acknowledge messages with an ACKNOWLEDGE request Acknowledge Message client gt server ACKNOWLEDGE lt message gt The lt message gt is a CSV encoded list of message components The structure is identical to the lt message struc ture gt returned with the connection acknowledgement with the following specifics The ID is the ID of another existing message The class is ACK The sender is an identification in the form user host Local time and mission time set accordingly Other fields are empty 5 2 6 Message Subscription Connected receiver clients may subscribe to message delivery Subscription client gt server SUBSCRIBE lt filter string gt Subscription Acknowledgement server gt client SUBSCRIBED
9. Issue CGS RIBRE MA 0010 5 Datum Date 2014 06 25 4 von of 31 Copyright by EADS All Rights Reserved Dok Nr No CGS RIBRE MA 0010 Ausgabe Issue 5 Datum Date 2014 06 25 AIRBUS DEFENCE amp SPACE Seite Page 5 von of 31 1 Reference Documents 1 1 An XML Based Configuration Concept Configuration Editor and APIs CGS RIBRE MA 0008 1 2006 10 01 FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS J DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 6 von of 31 2 Overview The logging system has a client server based architecture A central Message Server collects messages from senders and distributes them to reader clients typically message windows All messages are stored in files Message clients can both send and receive messages They may run on different computers in a network and communicate with the Server through APIs Currently there are APIs for Ada and Java Within a software system there may be more than one message server A client can however connect to only one server at a time Message Window The Message Window is a Java client It connects to a server and displays all messages received from the server But Message Window clients can also directly read message files and display their contents The Message Window allows to display the messages in different formats sort messages acco
10. LCM ID lt message id gt Unsubscription client gt server UNSUBSCRIBE The filter string isa CSV encoded list of filter components message classes time span regular expressions for message parts Details TBD The SUBSCRIBED message can contain an optional identifier for the message id of the last message in the server cache LCM ID last cached message identification followed by column character and the message id 5 2 7 Message Delivery When a receiver client has subscribed to message delivery the server will send first all messages from internal server cache and then the server will continuously deliver messages until the end of messages has been reached client unsub scribed or all messages from requested time span have been delivered FORM 0019 1M 1 logger rtf Copyright by EADS All Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 31 von of 31 Message Delivery server gt client MESSAGE lt message gt End of Messages Notification server gt client EOM The lt message gt is a CSV encoded list of message components The structure is identical to the message header re ceived with the subscription acknowledgement 5 2 8 Summary Request Connected clients may request summary information from the server Request a Summary client gt server SUMMARY lt client id gt Request a Summary server gt clien
11. connected as INTERCONNECT client will receive status notifications and messages from other clients It can subscribe for messages and receive reports A client connected via CONNECT can send messages only Connection as Client client gt server CONNECT lt client name gt INTERCONNECT lt client name gt Disconnection client gt server DISCONNECT Success Response server gt client CONNECTED lt client id gt lt message structure gt DISCONNECTED The message structure is a CSV encoded list of message column headers names It defines the message struc ture understood by the server All messages sent by senders and delivered to receivers contain values in the same struc ture This allows a consistency check between server and clients Error Response server client ERROR error text 5 2 3 Status Notification Whenever there is a status change the server notifies all connected clients with a status notification Notification of Client Connections and Disconnections server client CLIENTS client name host id comma separated list of connected client information triples Notification of Error server client ERROR error text FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 30 von of 31 5 2 4 Issuing Messages Server clients can send messages with a S
12. described in the following subsection 4 6 View Definitions Zl view 1 group name view N gt R name attribute name name gt lt value gt name lt value gt lt attribute gt group name ack gt lt group gt group name id gt lt group gt group name class gt lt group gt A horizontal arid vertical arid ack group name location gt lt group gt i id group name local time group i class group name mission time gt lt group gt ol location group name sender gt lt group gt o 2 local_time group name title gt lt group gt o al mission time group name text gt lt group gt i2 sender lt group gt e iJ title i text A view definition defines the columns of the table displaying the messages name the name of the view displayed in the list of views ack the acknowledgement column id the message ID column class the message class column location the location column local time the local time column mission time the mission time column sender the sender column title the title column text the text column FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 26 von of 31 4 7 Column Definitions lt group name column name gt JO column name F lt attribute name nam
13. e gt T a Name lt value gt name lt value gt A on attribute A width attribute name on gt A position lt value gt boolean lt value gt lt attribute gt lt attribute name width gt lt value gt integer lt value gt lt attribute gt lt attribute name position gt lt value gt integer lt value gt lt attribute gt lt group gt A column definition defines the appearance of a column in the message table name the name of the column displayed in the table header on true the column is shown in the message table false the column is hidden width width of the column in pixels position position of the column in the message table counted from left to right starting at 1 FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 Ausgabe Issue 5 Datum Date 2014 06 25 AIRBUS DEFENCE amp SPACE Seite Page 21 von of 31 4 8 The filters Group group name filters gt T c filters l name current filter gt lt group gt T e current filter group name fil per 1 lt group gt 5 filter_1 group name filter 2 gt lt group gt o T filter 2 group name filter 3 gt lt group gt i filter 3 lt group gt The filters group contains a list of filter definitions Each filter definition is described by a subgroup The cur rent filter group contains the currently applied filter This filter is auto
14. e Message Details Window Double clicking a message in the message list opens a separate details window It contains the same information as the message details pane but offers the possibility to navigate to the next previous message by clicking the adequate button Message Window Class INFO Local time 2012 09 10 10 34 34 576276 Sender ES_O1 vm2b Mission time 2012 09 10 10 34 34 5 76304 UTC Location TES Title Entering IDLE mode FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS Ausgabe Issue 5 Datum Date 2014 06 25 DEFENCE amp SPACE Seite Page 13 von of 31 3 2 4 The Menu Bar The File Menu Open Open a message file and display the messages contained in it A connection to a message server is closed before loading the file With clicking the check button you can load hidden messages e g HLCL commands Connect Local Save Save the currently displayed messages in a file Connect Global Disconnect Connect Connect to the message server local Connect Join the CGS group multicast to listen for messages Resume global Disconnect Disconnect from message server 2012 09 11 l l Pause Do not show incoming messages Resume Show all messages again including the incoming mes sages during the Pause Exit Exit the program The Message Menu Message Window Server v File Message Settings Help Show details Show th
15. e details of the selected message from the message list Show Details Find Search messages opens a search form Find Message ie Send Send a message to the message server Send Ctri N Acknowledge Acknowledge message mi Acknowledge Message 54 a Copy Message 41 Copy Copy message to clipboard i 3 Clear i Clear Clear the message list 2012 09 10 10 34 41 FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS J DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 14 von of 31 The Settings Menu sage wyindow server m2zb Views Open the views dialog ssage Settings Help a Filters Open the filter dialog Views Styles Open the styles dialog S Filters HH Styles Preferences Open the preferences dialog C inj Preferences LEX Open Config Open file dialog for opening user configuration ti file n Open Configuration E IN Li Save Configuration 70 Save Config Open file dialog for saving user configuration i eg uration file INF Exit Dialog 697 INE 3 Z 20 2 59 Vereo Exit Dialog Shows Exit Dialog or not on quit INFO 2013 02 28 17 58 42 07 INFO 2013 02 28 17 58 37 925 INIEM n19 0 228 1782239 QI The Info Menu indow Server 14 dr vmzb wait About Show information about the program ings Help s
16. econds accuracy SSS time scope UTC GPS SENDER for normal messages the sender application in the form application host for acknowledgement messages the user information in the form user host TRUE or FALSE indicating whether the message shall be displayed Characters of TEXT column are escaped using Java string rules to avoid line feeds in columns All other columns must not contain CR or LF characters Message Classes Messages are classified with the following classes INFO an informal message ERROR a non fatal error message FATAL a fatal error message DEBUG a debug message a message acknowledgement refers to another existing message FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 29 von of 31 5 2 The Logger Protocol 5 2 1 General Format Server and clients communicate via textual messages The general format is lt TAG gt lt SUBTAG gt lt parameter gt Each message consists of a tag and possibly a subtag that indicate the kind of message They are followed by parameters that are specific to the message kind 5 2 2 Connection Disconnection In order to connect to a logger server clients send a CONNECT INTERCONNECT request to the server The server re plies with either a positive acknowledgement CONNECTED DISCONNECTED or an error message ERROR A client
17. enumeration of all matching message classes e g class INFO WARNING string patterns are regular expressions with not and amp or I and case insensitive indicators e g Ititle expr i amp host expr text expr time filter starts with an LT or MT tag followed by a time range Ig Sos ss lu If first or last is omitted begin or end of time range is assumed FORM 0019 1M 1 logger rtf Copyright by EADS All Rights Reserved Dok Nr No CGS RIBRE MA 0010 Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 9 von of 31 Examples class WARNING ERROR ltitle ucl 1 amp text i compiler class WARNING ERROR title ucl i amp text compiler class WARNING ERROR LT 2007 01 01 00 00 2007 01 01 12 00 00 display Zilter 2ilrernome titer deiinrcron This filter works on the already loaded messages Only those messages which match the filter are shown A display filter can be changed after start For the option values the description of incoming_filter FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 Ausgabe Issue 5 Datum Date 2014 06 25 AIRBUS DEFENCE amp SPACE Seite Page 10 von of 31 3 2 2 Window Description The picture shows the layout of the window used by the Message Window program Product Menu bar Tool bar Info Panel Message Window Server vm2b File Message Settings Help vlaen at
18. ettings Sod Open User Open the manual in pdf format with Manual acroread Local Time FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 15 von of 31 3 2 5 The Tool Bar The tool bar contains a number of symbols that denote frequently used functions and thus allows easier access to these functions Most of them are also available in the menu bar Open File Open an existing message file A file chooser will be displayed to select the file Save File Save the currently displayed messages in a file Le Wo Search Messages Search for patterns given as regular expressions within the currently maintained messages Pause Pause updating the message list don t show new messages freeze mode Resume Resume updating the message list stop freeze mode Acknowledge Message Acknowledge the selected message Clear View Clear the messages list A Preferences Open the preferences dialog Server summary Display a server summary not implemented yet View View Select a view definition Filter Filter Select a filter definition Style Style Select a style definition FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 16 von of 31
19. ing criterion a single click on one or more other columns adds them as subordinate sorting criteria The first click sets as cending order subsequent clicks toggle between ascending and descending order for the particular column The sorting order is indicated with an arrow in the column header a bigger arrow for the primary column and smaller arrows for subordinate columns The messages in the picture are sorted first by Sender Host then by Local Time both in ascend ing order 1D Class LocalTime SendereHost 2 Title 0 000000 OU l3 INFO 2006 09 28 Gselinptll 0 l7 INFO 2006 09 30 DBS_01 linpcll Session closed l INFO 2006 09 20 amp AS l elinpcll As 1 standard tracing on 2 MFO j 2006 03 30 S55 l elinpcll Message APISTORE LISER FILE cgs inst cgsho a INFO 2006 03 30 545_l lingcll STORE USER FILE cas inst cashome gsaf data The position of the columns can be changed by dragging the column header with the left mouse button to the desired position The width of the columns can be changed by pulling the right border of the column header with the left mouse button to the desired width The subset of columns to be displayed by using the view definition form Manage Views View Columns v Ack Icon Class Location v Local Time Mission Time Sender Host Title v Text
20. layed e Filter definitions from different files are gathered in the list of filters Filter names must be unique If the same filter name is given twice an error message is displayed e Window related attributes overlay and hide the previously given attributes This allows to build multiple level configurations e g in the form that a basic configuration on system level may be extended and modified by separate configurations on group and user level This way a user may not only add his own views and filters but also modify e g the window size The values of several attributes may contain placeholders for environment variables They have one of the two forms variable name Svariable name default value These placeholders are substituted by the Message Window with the value of the corresponding environment variable If the variable does not exist and a default value is given the default value replaces the placeholder If the variable does not exist and there is no default value the Message Window will report an error and reject the configuration The following describes the configuration giving both a graphical representation of the elements in Configuration Editor conventions in terms of groups and attributes and a pure XML pattern This should enable a reader to manually set up a configuration in XML form Within the XML patterns identifying attributes to be given in this form are shown in bold attribute values to be supplied by
21. matically applied when opening the Message Window All filter definition groups have the same structure as described in the following subsection 4 9 Filter Definitions lt group name filter 1 gt ci filter Y attribute name name Al name lt value gt Filter One lt value gt A value lt attribute gt lt attribute name value gt lt value gt class ERROR WARNING FATAL DEBUG host linsrv 1 i lt value gt lt attribute gt lt group gt Definition of a filter name the filter name shown in the filter list value filter definition as described in section 3 2 1 Command Line Invocation FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 28 von of 31 5 Internals 5 1 The Message File Format Message files are encoded in CSV format each message as one line with each message component as one column The first line of each message file is a CSV encoded list of column names This can be used by the logger software to perform version and consistency checks The following fields are encoded in this order LOCAL TIME the local time in the form YYYY MM DD hh mm ss nnnnnnnnn nnnnnnnnn parts of seconds with 9 digits nano seconds accuracy MISSION TIME the mission time in the form YYYY MM DD hh mm ss nnnnnnnnn SSS nnnnnnnnn parts of seconds with 9 digits nano s
22. o WARNING Farner ERROR eee FATAL Location DEBUG Time local time O mission time From to A filter definition consists of three sections These sections are AND associated e Message classes This is a subset of the message classes that are to be displayed e Regular expressions for the message text fields These can be case sensitive or insensitive If the NOT flag is select ed the pattern matches if it does not appear in the text field otherwise it matches if the pattern is present Single pat terns can be AND or OR associated The logical expression is formed by first giving the AND associated patterns and then the OR associated ones e Time ranges for local time and mission time A time specification has the form YYYY MM DD hh mm ss A time range may consist of a lower or upper bound only i e one of the bounds may be omitted The Apply button applies the filter to the filter list FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 18 von of 31 3 2 7 Views A view defines the appearance of the message list It comprises the subset of columns displayed the position and width of the columns and the ordering of the messages in the list Messages can be sorted by several columns A double click on a column header selects the column as the primary sort
23. oup comprises a number of attributes that determine the appearance of the Message Window window width an integer defining the width of the window in pixels if omitted a default width is assumed height an integer defining the height of the window in pixels if omitted a default height is assumed x Horizontal position of the window y Vertical position of the window max messages an integer defining the maximum number of messages kept by the Message Window if omitted the number of messages kept is not limited may cause memory problems auto scrolling Indicates whether auto scrolling of messages is enabled exit confirmation Indicates whether an exit confirmation is needed FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 25 von of 31 4 5 The views Group group name views gt j yd Pm view an nn UOS l lt group name view 1 gt lt group gt amp view 1 group name view 2 gt lt group gt o i7 view 2 group name view 3 gt lt group gt jl view 3 u lt group gt The views group contains a list of view definitions Bach view definition is described by a subgroup The cur rent view group contains the currently applied view This view is automatically applied when opening the Message Window All view definition groups have the same structure as
24. oup name window gt lt group gt a wincio lt group name views gt lt group gt lt group name filters gt lt group gt lt group gt The message window group must contain a version attribute and three subgroups version Identifies the version of the configuration file structure window contains all attributes that determine the appearance of the Message Window window views contains a list of view definitions filters contains a list of filter definitions FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 24 von of 31 4 4 The window Group I window group name window gt spi attribute name width gt lt value gt integer lt value gt lt attribute gt height lt attribute name height gt lt value gt integer lt value gt lt attribute gt M attribute name x gt lt value gt integer lt value gt lt attribute gt attribute name y gt lt value gt integer lt value gt lt attribute gt attribute name max messages gt lt value gt integer lt value gt lt attribute gt Meise Ipso dg attribute name auto scrolling gt lt value gt boolean lt value gt lt attribute gt auto scrolling attribute name exit confirmation gt lt value gt boolean lt value gt lt attribute gt A exit confirmatio lt group gt The window gr
25. ow consists of a menu bar a tool bar info panel and a content area The content area is separated by a split pane and shows the messages in a list and the selected message on the message details pane By clicking on the tiny arrows on the divider the message list or message details pane can be hidden or expanded Drag the dimpled line to change the space used for the message details pane The info panel shows the applied filter and view The window title indicates the current message source The sources can be server group multicast or file FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS Ausgabe Issue 5 Datum Date 2014 06 25 DEFENCE amp SPACE Seite Page 11 von of 31 Show Details 59772 B Copy Message 22443 RROR Acknowledge Message Sr Er Er hk 2012 09 10 10 34 33 436935 hk Clicking the right mouse button pops up a menu from which you can choose some options A new one is to copy the contents of the message into the clipboard by pressing the Copy Message menu item The message text in the clipboard has the following format class local time mission time sender location title text FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 12 von of 31 3 2 3 Th
26. raph Page Reason for Change Brief Description of Change 1 2007 08 01 Initial version FORM 0019 1M 1 logger rtf Copyright by EADS All Rights Reserved AIRBUS DEFENCE amp SPACE 3 1 32 2l 3 2 2 D 3 2 4 3 2 5 3 2 6 Sod 3 2 8 3 2 9 3 2 10 32 41 3 2 12 4 1 4 2 4 3 4 4 4 5 4 6 4 7 4 8 4 9 5 1 I 2 5 2 1 5 2 2 902 9 5 2 4 Dok Nr No CGS RIBRE MA 0010 Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 3 von of 31 Inhaltsverzeichnis Table of Contents ToC Reference Brel OP PETRI 5 An XML Based Configuration Concept Configuration Editor and APIs CGS RIBRE MA 0008 1 2006 10 Up 5 VCE NCW ER EN E EEE E A Tm 6 Usage of the Lopene System nE ENEE NEEE 7 Tae Ni Sa Se ee E E AE ee 7 The Me IRR are eier 8 Gom a M BT Brno rer LS PEE E E ner 8 bores MB ccce ioo LR D mt 10 The NE BU RED TT 12 B Ng c X TAE 13 Tae TO OU NT 15 giu m VY M 16 MS M 18 ARTI M J
27. rding to different criteria search for message contents etc Different views and filters may be defined given a name and stored for later reuse The Message Window can be configured through XML based configuration files x x x x Client Client Client Client Ada Ada Ada Ada Message Window XXXXXXXXX XXXXXXXXX XXXXXX m x C SiServer CSV ieee ILI Client Client Client Client Java Java Java Java FORM 0019 1M 1 logger rtf Copyright by EADS All Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS Ausgabe Issue 5 Datum Date 2014 06 25 DEFENCE amp SPACE Seite Page 1 von of 31 3 Usage of the Logging System 3 1 The Message Server FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 8 von of 31 3 2 The Message Window 3 2 1 Command Line Invocation The Message Window is started from the command line with the command message window config file options Contig f1192143 the names of the XML configuration files to be used to configure the Message Window Several files can be given they are accumulated as described in the document in section 1 1 The definitions of these files cannot be changed In addition to the files given a user configuration file can be defined with the
28. t SUMMARY lt summary gt The lt summary gt is a CSV encoded list of summary components Details TBD 5 2 9 Client Client Communication Connected clients can forward messages to other clients Forward a message client gt client FORWARD lt client pattern gt lt host pattern gt lt string gt Forward a string to clients at hosts specified by regular expressions Receive a forwarded message FORWARDED lt client id gt lt string gt Receive a forwarded string from client identified by its id 5 2 10 Session Notification Connected clients can notify the logger server s archive about sessions Notify create session client gt server CREATE_SESSION lt string gt Inform server s archive that a session named by string was created Notify close session client gt server CLOSE_SESSION lt string gt Notify server s archive about closed session FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved
29. tf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 Ausgabe Issue 5 Datum Date 2014 06 25 AIRBUS DEFENCE amp SPACE Seite Page 22 von of 31 4 Configuration of the Message Window 4 1 Configuration Concept The Message Window is configured through one or more XML files a configuration comprises the following elements e aversion number e the window appearance and preferences o width and height of the window o position of the window o the maximum number of messages kept and displayed o whether auto scrolling is enabled o whether exit needs a confirmation e alist of view definitions e alist of filter definitions The configuration is based on the configuration concept described in 1 1 The Configuration Editor can be used to set up and edit the configuration Please note that a configuration need not be given in one file but may be split in several files each containing a part of the overall configuration Only when merged together the set of separate files must result in a complete Message Win dow configuration All files must be given as parameters to the message window program If a file given in the com mand line contains attributes that were already given in a preceding file these multiple attributes are resolved as follows e View definitions from different files are gathered in the list of views View names must be unique If the same view name is given twice an error message is disp
30. the user are shown in italic and in red text FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS Ausgabe Issue 5 Datum Date 2014 06 25 DEFENCE amp SPACE Seite Page 23 von of 31 4 2 Overall Configuration Structure 9 _ _919 ZI configuration name lt xml version 1 0 encoding UTF 8 gt il configuration name configuration name gt E message window possibly other configuration elements Xgroup name message window gt all Message Window configuration goes here lt group gt possibly other configuration elements oconfiqurations The overall configuration must contain a global group named message window this group must contain the Message Window configuration Any configuration elements outside this group are ignored This allows to keep a Message Win dow configuration as part of a general configuration The configuration element may or may not reference a Schema file In any case each XML file will be validated both by the Configuration Editor and by the APIs and hence by the Message Window against the basic Schema on which the configuration concept is based 4 3 Basic Message Window Configuration Layout A lt group name message window gt message _ window zu d c ge lt attribute name version gt CEPS lt value gt 1 0 0 lt value gt o i views lt attribute gt a filters lt gr
31. tton in the tool bar or selecting the Search Regular expression ignore case item from the Message menu will open the search dialog error A regular expression can be applied to a selected set of text fields Ssarchin Clicking on the Search button starts the search The number of occur rences is displayed and the search arrows can be used to move back _ Sender Host ward and forward in the list of messages found this selects the corre UIT Title sponding message in the list and highlights it Text 5 of 41 3 2 11 Preferences 2 C Message Window Preferences v A x 1 The maximum number of messages 2 Selected Font Max number of Messages 1000 3 Simple beep configuration rele vant for systems without sound Selected Font Dialog plain card or speaker 4 Default sorting at start Beep Configuration beep disabled x 5 Whether auto scrolling is enabled Default Sorting at Start LT vr Auto Scrolling LT ascending SMT SMT ascending FORM 0019 1M 1 logger rtf Copyright by EADS AII Rights Reserved Dok Nr No CGS RIBRE MA 0010 AIRBUS DEFENCE amp SPACE Ausgabe Issue 5 Datum Date 2014 06 25 Seite Page 21 von of 31 3 2 12 Sending Messages The user of the Message Window can send messages to the message server by selecting the Send item from the Message menu MERSEIERTITUOTT i ern Message Class INFO Title _ Acknowledge required FORM 0019 1M 1 logger r
Download Pdf Manuals
Related Search