INFO system

The INFO system is a summary of information that can be viewed in the running application in the special window. The INFO system is provided for designers and it allows them to find the current state of the system, states of its parts including diagnostics and statistics. For example it is possible to find all data values in the application, to get the statistics of the success rate of the data transfer over the serial link, display debug texts written in scripts in the Debug_info item, and another information.
INFO system can be configured in the PmRoot object:
- Disable viewing - see permission PmRoot > Permissions > InfoShow.
- Disable editing and methods calling - see permission PmRoot > Permissions > InfoEdit.
- Some INFO system parameters can be set in INFO system setup page.
How to open the INFO system:
In runtime the INFO system can be opened:
- from the predefined tool bar
- by Ctrl-I keypress (see Example)
- by a script using the OpenView("/#glob/infosystem") method
IN the development environment the INFO systemu can be opened:
- from the tool bar
- by Ctrl-I keypress (see Basic control of application editor)
In WEB browser, the INFO system can be opened if the PROMOTIC application acts as WEB server and if the application contains the PmWebInfo object.
The INFO system window consists of three parts. On the left there is a tree of individual pieces of information (of items). In between there are page windows from which it is possible to view chosen information (most information have more parts and that's why they are divided into pages). On the right there is a set of control buttons:
- Open new: Opens new INFO system window. This way it is possible to open up to 3 more windows (maximum number of open windows is 4). It is possible to observe several different indicators simultaneously.
- Refresh: Refreshes window content. It is also possible to activate autorefresh by the "Start" button instead.
- Print to file: Saves the tab content into a text file. The filename entry window is opened before saving (the file is preset based on the "File to print the content" configurator). It is also possible to define whether to save only the selected tab or all pages of the corresponding INFO item. See also the Pm.InfoWriteToFile method.
- Actions: In some INFO system tab some actions can be executed. These actions can be initiated by this button or by clicking the right mouse button (local menu) in corresponding tab. This can be done only if the permission PmRoot > Permissions > InfoEdit is fullfiled. The action can be performed over the information also by algorithmic method Pm.InfoAction.

For example:

- It is possible to delete all records over the Debug_info items.
- It is possible even to enter new value over the information about the PmData or PmDataTable objects.
- Syntax of displayed numeric value: Here, it is possible to define the syntax of numeric values:
- Binary: Display as binary
- Octal: Display as octal
- Decimal: (default) Cisplay as decimal
- Hexa: Display as hexadecimal
- Bits: Display as bits
- Start: Starts / stops value autorefresh.
- Period (s): Autorefresh period (in seconds).
The INFO system remembers its state (position and size of the window, last opened page, width of columns, refreshing period) and when opening the INFO window, the last state is set. But this state is stored only in the memory by default and so it isn't preserved when closing the PROMOTIC system.

The state of the INFO system can be stored even in the application INI file. It is performed by setting the StoreType key in the section [InfoSystem] - see Description of keys in the [InfoSystem] section.

The item list of the left window follows:


Probably the most important information are global application errors (Errors item). When the application runs and for example a division by zero occurs, then the system doesn't break down of course but it is an error that is written into the INFO system. Than a designer can come to the application after some days, watch the INFO system, find out the errors that occurred and make an update of the application accordingly. Errors item is divided into several pages:
- Global: list of all errors
- Panel: detailed list of panels errors
- Script: detailed list of scripts errors (including qualification of events, row and column numbers)
- Comm: detailed list of communication errors

The print-out of global errors can also be done into the Debug_info item in parallel. It is performed by setting the "ErrRedir" key in the application INI file.


In the Warnings item, there is only one page so far, named Obsolete. On this page, the obsolete components used in the application are being displayed. Some of these obsolete components may not be functional in further PROMOTIC versions. The designer can transfer these obsolete components into new concepts.

See: A description of the "Warnings" item in the INFO system..


The PROMOTIC system itself takes care about writing into most INFO items. But the item Debug_info exists and it contains "Debug1" and "Debug2" pages. The designer can write into them. It is done by the Pm.Debug method. The text in the parameter of this method is added as a new line into the relevant page. The designer can watch in a simple way how the watched process runs.

The lines count in "Debug1" and "Debug2" pages is limited (default 1000 lines). If this limit is reached, then the oldest line is deleted. This limit can be modified in the Max. number of rows in Debug_info item configurator.

It is possible to set the "EnableDebug" key in the Application.ini file in the [Log] section so that writing into Debug_info is done into the LOG file in parallel.


In this part some global system information can be found. SYSTEM item is divided into several pages:
- Application: Several global information regarding the application, for example the PROMOTIC version (See also: How to find PROMOTIC version), OS Windows version, VBScript version, running time, application folder, local IP address, etc.
- Memory: Information regarding the OS Windows memory usage. See also the Pm.MemoryUsage or Watching running PROMOTIC application property.
- Statistics: Complete application statistics. Displayed information:
- number of running scripts and number of script errors
- number of opened panels
- number of changes in alarms
- number of saved trends
- number of correct and incorrect communication transfers
- DisabledObjects: A list of all disabled Promotic objects. The object can be disabled in the Disabled object configurator.
- Licence: An overview of purchased licences for this application. See Price list of PROMOTIC system and PROMOTIC modes according to the licence.


From this item it is possible to find out the information (statics, current values, settings, etc.) about the communication with external sources. Here is for example:
- The ClientLicence page offers the information regarding the network licences PmData(Web)Client. This information is also available via the Pm.LicenceInfo property.
- The Connected_Users page offers the information regarding connected network users.
- The information about the state of the PROMOTIC communication driver. There is a list of the communication drivers used (PmComm objects) each with the information pages:
- Statistic: Transfer statistics, for example the number of valid transfers, invalid transfers of certain types, etc.
- State: The current state of the driver, for example processing state, transfer parameters, etc.
- Monitor: The contents of transferred data and completed actions. It is a detailed transfer history using a cyclic line list. Each line contains either the character (in decimal, hexadecimal or ASCII form) or the completed action including the parameter.
- Log: This page is included only in specific communications displaying the event history digestedly but in less detail compared to the "Monitor" page.
- The WebServer item provides the information regarding the status of the WEB communication. (the HTTP trasmission statistics, the contents of last transmissions, etc.). This item can be found in the INFO system only if the PmWeb object is present in the application.
- The DDE item provides the information regarding the status of the DDE communication. This item can be found in the INFO system only if the DDE enabled configurator is checked in the application.


The designer can observe the current state of any PROMOTIC object in this item. For example, he can watch current values in the PmData object, how many times the event occurred in any object, etc.

The PmRoot item is displayed in the INFO system window only in runtime, only if the permission PmRoot > Permissions > InfoShowApp is granted.

If the PmRoot > Permissions > InfoEdit permission is granted then some object have the "Actions" button active, where it is possible to change the properties (e.g. in PmData object change the property Value of the variables) or call methods (e.g. in PmCommData object call the Refresh method).

© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice