Medialon MxMs' Help  
   
Name : Medialon EventLog
Version : 1.0.3
Available for : Manager V5 (PRO/LITE)
Limitation In :
Device Mark : Medialon
Positrack Compatible : No
Resources type : None
 
Compatible hardware interfaces - available resource modules (MRC) :

 

 

> Overview | > Installation (MXM) | > Creation (Device) | > Commands (List Of) | > Variables (List Of) | > Support


Overview :

MXM EventLog is designed to trace messages and events for a reporting system. It provides functions to store, sort, export and print events listed by date and time.
A classic application of EventLog MXM is a tracer file in show controller to report all defaults and alarms which occured during the show.

EventLog MXM provides a set of functions to manage events.
All traced events are stored in the current log file which is part of the log database of events. The events storage file could be changed automatically every period which could be defined as every : Day, Week, Month or Year.

Two lists of events are available. The first one display current events (real time incomming events) whereas the second is used to manipulate events. Events manipulations could be sort events, print events, export events etc...

The length of an event message in the EventList or in the SelectedEventList is limited to 252 chars plus the header of the message (date, time and time). However, the full message length is stored in the database file.

> Top


Installation (MXM) :

No special installation required.

> Top


Creation (Device) :

Device creation window :



Event Log File Path :
Path of the directory on which the log files will be stored.

Base file name (log) :
This is a base file name which will be used to create the current log file name. Ex : EventLogFile.2000.M10.lbd

Switch file frequency :
Specify every time the log file must be changed. Every Month cause the log file to be changed ( a new file created) every month.

Event window width (event) :
Specify the number of last events maintained in the CurrentEventList. When an event is traced, it's both store in log file and added into the CurrentEventList. If the number of elements of CurrentEventList becomes larger than this value, the first element of the list is removed but not from the log file.

Event types setting :
Enumerate all the available types of events. Custom events types could be created. This types could be used in commands to select desired type of events.

Printer :
Specify the printer used to print events list.

> Top


Commands (List Of) :

Trace Event :

      Description : Store a new events in the log file and the CurrentEventList.
      Parameters :
      Date : [Type : Date] : Date of event.
      Time : [Type : Time] : Time of event.
      Type : [Type : Enum] : Type of event.
          Availables values :
          "Info" : 1rst default type.
          "Alarm" : 2nd default type.
          "Error" : 3 thd default type.
          Other custom value are autorized.
Clear Events :
      Description : Clear CurrentEventList variable
      Parameters : no parameter.
      Usage : This command only clear the variable, events in log file are maintained.
Set File Switch Frequency :
      Description : Set the frequency to swap the log file to new file.
      Parameters :
      Every : [Type : Enum] : Frequency.
          Availables values :
          "Day" : a new file will be created each day.
          "Week" : a new file will be created each week.
          "Month" : a new file will be created each month.
          "Year" : a new file will be created each year.
Set Event Window :
      Description : Change the number of last maintained events in the CurrentEventList.
      Parameters :
      Wifth : [Type : Integer] : Number of max events.
Select Events :
      Description : Select events from a log file and store them in SelectedEventList.
      Parameters :
      From Date : [Type : Date] : Beginning Date from when select events.
      To Date : [Type : Date] : Ending Date to when select events.
      From Time : [Type : Time] : Beginning Timefrom when select events.
      To Time : [Type : Time] : Ending Time to when select events.
      Type of Event: [Type : Enum] : Type of event to be selected.
          Availables values :
          "All" : Events are selected without consideration of the type.
          ... One of the default values or created values.
      LBD File Name : [Type : String] : Name of the log file from which select events (optional, if not set, the current file is used).
      Usage : when the command completed, 'SortedEventList' variable contains selected events.
Print Events :
      Description : Print an events list.
      Parameters :
      Event List : [Type : Enum] : List of events to be printed.
          Availables values :
          "Events List" : Print from current events list.
          "Selected Events List" : Print from selected events list.
      Title : [Type : String] : Title of printed document.

Export Events :
      Description : Export as text file an events list.
      Parameters :
      Event List : [Type : Enum] : List of events to be exported.
          Availables values :
          "Events List" : Print from current events list.
          "Selected Events List" : Print from selected events list.
      FileName : [Type : String] : Name of the exported file.

Change Event Log File Path :

      Description : Change the folder path where are stored log files.
      Parameters :

    Log File Path : [Type : String] : Path of the new folder.
    Transfert Log Files : [Type : Enum] : Enables or not the transfert of log files from the old folder to the new one.

        Availables values :
        "No" : Transfert is not done.
        "Yes" : Transfert is done.

Select & Export Events :

      Description : Select events from a log file and export them into a text file.
      Parameters :
      From Date : [Type : Date] : Beginning Date from when select events.
      To Date : [Type : Date] : Ending Date to when select events.
      From Time : [Type : Time] : Beginning Timefrom when select events.
      To Time : [Type : Time] : Ending Time to when select events.
      Type of Event: [Type : Enum] : Type of event to be selected.
          Availables values :
          "All" : Events are selected without consideration of the type.
          ... One of the default values or created values.
      Export File Name : [Type : String] : Name of the exported file.
      LBD File Name : [Type : String] : Name of the log file from which select events (optional, if not set, the current file is used).

> Top


Variables (List Of) :

Status:

      Type : Enum.
      Description : Current status of the device.
      Available Values :
        "Idle" : No operation is in progress.
        "Busy" : An operation is in progress.
        "Error" : An error occured during the pending operation.
        "Export Error" : An error occured during exportation.
EventCount :
      Type : Integer.
      Description : Number of events in the CurrentEventList.
EventList :
      Type : String.
      Description : Current list of last events.
SelectedEventCount :
      Type : Integer.
      Description : Number of events in the SortedEvenList.
SelectedEventList :
      Type : String.
      Description : List of seleted events.
PrinterStatus :
      Type : Enum.
      Description : Current status of the printer.
      Available Values :
        "No Printer" : No printer is available.
        "Ready" : No printing is in progress.
        "Printing" : Printing is in progress.
PrintedPage :
      Type : Integer.
      Description : Number of page printed.
CurrentLogFilePath :
      Type : String.
      Description : Current log file folder path.

> Top


Support (Difference with previous versions) :

V 1.0.1:

  • Fixed: Now when a new event type is created in the setup, or when an event type is deleted, this new list is saved in the project.

V 1.0.2:

  • Fixed: Event type changes are not updated in cues parameters.

V 1.0.3:

  • Fixed: Exported event lines are truncated by 1 caracter.
  • Added: 'New Folder' button in folder browsers.

> Top