×
Siemens Industry Online Support
Siemens AG
Entry type: FAQ Entry ID: 25288354, Entry date: 05/07/2015
(1)
Rate

How can you have only selected messages displayed in the WinCC Alarm Control at Runtime?

  • Entry
  • Associated product(s)
This entry describes the various options for displaying selected messages in the WinCC Alarm Control at Runtime. This description refers to the 'WinCC Alarm Control (Classic)' (relevant as from PCS V7.1).

1. Selection dialog
Through the Selection dialog, WinCC Alarm Control provides you with the option of defining messages that are to be displayed at Runtime. You can set the selection criteria (filter criteria) already in the configuration phase or first at Runtime.
    

  • Define the selection criteria in the configuration phase
    In the Graphics Designer open the dialog "WinCC Alarm Control Properties" and switch to the "Message lists" tab. There in the "Data preparation" area you select the "Selection..." button.
     

    Fig. 01
     
    In the "Specify selection" dialog you can now define various selection criteria for displaying selected messages.
      
  • Define the selection criteria at Runtime
    You can also open the Selection dialog at Runtime to change the selection criteria for displaying messages at Runtime. You have the following options:

    You can call the Selection dialog at Runtime by clicking on the icon in in the icon bar of the Alarm Control. For this, in the configuration of the WinCC Alarm Control, the "Selection dialog" keyboard function must be selected in the "WinCC Alarm Control Properties" dialog, in the "Toolbar" tab.
     

    You can use the standard function "AXC_OnBtnSelect()" to open the Selection dialog of the WinCC Alarm Control at Runtime. You can configure this function on the "Mouse Action" event of a picture object (e.g. button).
      


    Fig. 02
     

    Note

    Adapt the second parameter of the function, "lpszObjectName", to the object name concerned of the WinCC Alarm Control in your picture. In this example the object name of the WinCC Alarm Control is "Control1".


    Detailed information is available in the WinCC Information System under "Working with WinCC > Setting up a Message System > Display of Messages during Runtime > Operation during Runtime > How to Select Messages".


2. WinCC Standard function "AXC_SetFilter()"
You can use the function "AXC_SetFilter()" to define selection criteria for the display of messages in the Alarm Control at Runtime. The filter criteria are defined in a structure of the type "MSG_FILTER_STRUCT". This structure is transferred to the function "AXC_SetFilter()" as parameter, or more precisely as pointer.

General information on the standard functions of the WinCC Alarm Control is available in the WinCC Online Help (up to V6.0) under "Alarm Control" and the following entries:
 

  • "Standard functions for operating the WinCC Alarm Control"
     
  • "Sample application of the standard functions of the WinCC Alarm Control"

or in the WinCC Information System (as from V6.2) under:
 

  • "Working with WinCC > Setting up a Message System > Display of Messages during Runtime > Operation during Runtime > Standard functions for operating the WinCC Alarm Control"
     
  • "Working with WinCC > Setting up a Message System > Display of Messages during Runtime > Operation during Runtime > Sample Application of the Standard Functions of the WinCC Alarm Control"

Detailed information on the structure of the "MSG_FILTER_STRUCT" structure, the "AXC_SetFilter()" function and sample applications are available in the WinCC Information System under:
 

  • "Working with WinCC > ANSI-C for Creating Functions and Actions > Function description > Standard Functions > Alarm > AXC_SetFilter" (up to V6.0)"  
     
  • "Working with WinCC > ANSI-C for Creating Functions and Actions > ANSI-C function description > Standard Functions > Alarm > AXC_SetFilter" (as from V6.2)"  

Entry 25287778 shows how to use this function with numerous filter criteria.

 

3. WinCC option "Open Development Kit (ODK)"
The WinCC option "Open Development Kit (ODK)" enables you to filter messages in the WinCC Alarm Control. Here, similar to Option 2, a structure of the type "MSG_FILTER_STRUCT" is filled with the relevant filter criteria. Then the message filter defined in this way is transferred to a function that executes the message filter on the WinCC Alarm Control.

Entry ID 9652128 contains the current contact options.

 

4. Dynamizing the "MsgFilterSQL" property of the WinCC Alarm Control
You can assign a "where" clause to the property "MsgFilterSQL" of the WinCC Alarm Control to display selected messages in the WinCC Alarm Control.

General information is available in the WinCC Online Help under "SQL Statements for Filtering Messages in the Alarm Control".

Entry ID 5668269 contains sample applications and more information.

Warning
Under circumstances using this method you can create selection criteria which make the desired selection, but which cannot be displayed in the Selection dialog of the WinCC Alarm Control.  

The options in step 2, 3 and 4 enable message filters to be set at Runtime without the operator having to make settings in the Selection dialog. Possible cases of application are as follows:
 

  • Different buttons are defined in a process picture with a WinCC Alarm Control. By clicking different buttons the operator can set frequently used filter criteria with a simple mouse click at Runtime.
     
  • In a picture block, only those messages are to be displayed at Runtime that correspond exactly to the measuring point that is being shown at that very moment in the picture block. For this, the filter criteria of the Alarm Control are set accordingly when the picture block is opened.

With the message filtering options described here it is not directly possible to filter messages according to specific comment texts. In order to filter messages according to the contents of the message comments you can incorporate the comments in a user text block and filter according to that user text block. Entry ID 11870927 provides information about how you can incorporate comments in user text blocks.

 

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.
Rate entry
no rating
Requests and feedback
What do you want to do?
Note: The feedback always relates to the current entry / product. Your message will be forwarded to our technical editors working in the Online Support. In a few days, you will receive a response if your feedback requires one. If we have no further questions, you will not hear from us.