×
Siemens Industry Online Support
Siemens AG
Entry type: FAQ Entry ID: 24543977, Entry date: 02/09/2007
(1)
Rate

What options are there for the output of a message sequence report?

  • Entry
  • Associated product(s)

Configuration Notes:
With the message sequence report you can output all the messages on a printer in chronological order. This entry compares various options for generating a message sequence report.

Notes:
In WinCC a message sequence is created by default with the WinCC Report Designer. For this there is the system print job "@Report Alarm Logging RT Message sequence". You can choose between outputting the messages line by line or page by page. Detailed information on this topic is available in the WinCC Online Help under:

  • "WinCC Information System > Working with WinCC > Documentation > of Configuration and Runtime Data > Runtime Documentation > Reporting Messages in Runtime > Outputting Runtime Data with the Message Sequence Report".
  • "WinCC Information System > Working with WinCC > Documentation > of Configuration and Runtime Data > Runtime Documentation > Reporting Messages in Runtime > Creating a User-Defined Message Sequence Report".

You can also configure the message sequence report on WinCC clients. In order to output the messages of multiple servers in the message sequence report you load the server data of the servers concerned and select them in the print job for the message sequence report.
 

No. Configuration option
1 Report Designer: Message sequence report in the line layout
The line layout is used to output a message on a printer at the time of its occurrence.

The message sequence report in line layout has the following characteristics:

  • The associated printer must support line-by-line printouts. Dot-matrix or ink-jet printers are generally suitable as line printers, unlike laser printers.
  • The line printer must be connected locally (parallel interface) to the reporting computer. It is not possible to use a network printer.
  • Messages that occur are transferred line-by-line to the printer as ASCII characters. Printing requires relatively little system resources (CPU load of the computer). However, it is not possible to incorporate standard graphics objects in the printout (e.g. lines, polygons, polylines, ... or picture files).
  • You can configure two substitute printers for all alternative printouts in case of a printer failure. But if a substitute printer cannot be found when a message occurs during Runtime, an operating system message is issued. The print job is not automatically output to a file.
2 Report Designer: Message sequence report in the page layout
If you configure the message sequence report in page layout, by default the messages occurring during Runtime are only output on the printer when the configured number of messages per page is reached. Entry ID 24182772 shows how to use the C function "MSRTPrintMProt()" to print a page of a message sequence report in the page layout before the configured number of messages per page is reached.

The message sequence report in page layout has the following characteristics:

  • The page printer must not necessarily be connected locally to the reporting computer. It is thus possible to use a network printer for the printout.
  • Messages that occur are transferred to the printer page-by-page. In this case the page to be printed is prepared as a graphics object and then transferred to the printer. It is possible to incorporate standard graphics objects in the printout (e.g. lines, polygons, polylines, ... or picture files).
  • Printing requires a lot of system resources (CPU load) for processing the graphics objects and the subsequent printout. It might happen that when the graphics objects are being processed, other actions (like picture change) might be delayed.
  • You can configure two substitute printers for all alternative printouts in case of a printer failure. If a substitute printer cannot be found at the time of printout, the printer job is automatically output in an EMF graphics file (Enhanced Meta File). More information on output of a print job to a file is available in Entry ID 24178015.
     
3 Global Script C: Output of the messages in ASCII format
You have the option of triggering an action as well when a message occurs.
If the option "triggers an action" is check marked in the "Parameters" tab of the parameterization dialog for a message, then when a message occurs the C function "GMSGFunction()" is executed by default. This function is located in the installation path of WinCC under "SIEMENS\WinCC\aplib\Alarm". By default this function provides relevant message information (message number, status, time stamp, information on user text blocks and process-associated values) in the "Global Script Diagnostics" window or "APDIAG" output window. You can change this function to format the messages that occur to suit your requirements and output them to a text file.

Notes:
  • You can use the C function "fprintf()" to write a message to a text file.
  • When writing to text files you must make sure that sufficient hard disk memory is available.
  • By default the user text blocks of a message are available as text reference (TEXT_ID) in the GMSGFunction(). The WinCC Open Development Kit (ODK) gives you detailed information on how you can obtain the associated message text from the text reference in the language required. Information on the ODK is available in Entry ID 9652128.

Note:
Entry ID 22578952 provides more options for accessing archived messages.

Security information
In order to protect technical infrastructures, systems, machines and networks against cyber threats, it is necessary to implement – and continuously maintain – a holistic, state-of-the-art IT security concept. Siemens’ products and solutions constitute one element of such a concept. For more information about cyber security, please visit
https://www.siemens.com/cybersecurity#Ouraspiration.