Home
Engineering
Powerful tools for easy or complex engineering tasks.
System Management
The System Management is the central administrative unit for WinCC OA Systems.
Diagnostics
Alert and Event Screen (AEScreen)
The alert and event panel (AEpanel) in WinCC OA is a standard panel and allows displaying alerts and events in table format.
Alarm shelving and suppression
This topic provides an overview of alarm shelving, suppression by design, and out-of-service handling in WinCC OA.
Set up alarm shelving and suppression
Use this procedure to activate the Alarm Shelving feature in a WinCC OA project.

Version Information
Release Notes, Update information, Certifications and Frequently Asked Questions.
Concepts
Your first step into modern and powerful process visualization.
Deployment
Topics you need to know before using WinCC OA.
Security
Go beyond the norm in cybersecurity.
Engineering
Powerful tools for easy or complex engineering tasks.
- Project Administration
  The chapter contains a description of the process monitor as well as the project administration.
- Graphics Editor (GEDI)
  Used for creating and editing panels, provides tools for creating and configuring graphic objects.
- System Management
  The System Management is the central administrative unit for WinCC OA Systems.
  - System management
  - Diagnostics
    - Login Statistics
    - Alert and Event Screen (AEScreen)
      The alert and event panel (AEpanel) in WinCC OA is a standard panel and allows displaying alerts and events in table format.
      - Requirements and installation
      - Alert states
      - View of the Alarm and Event Screen
      - Alert table
      - Event table
      - A&E-Row/Screen
      - Column configuration
      - Customization
      - Properties of the alert table
      - Example of how to add a user-defined column
      - openAES()
        Opens the alert and event panel at the desired position and allows executing an action such as print the upper table of the alert and event panel or save the table.
      - Alarm filtering
      - Alarm shelving and suppression
        This topic provides an overview of alarm shelving, suppression by design, and out-of-service handling in WinCC OA.
        Set up alarm shelving and suppression
        Use this procedure to activate the Alarm Shelving feature in a WinCC OA project.
        Alarm shelving
        This topic explains how operators temporarily suppress individual alert instances in WinCC OA without changing the underlying alert handler configuration.
        Alarm suppression by design
        This topic explains how suppression by design prevents an alert handler configuration from generating alerts in WinCC OA.
        Out-of-service mode
        This topic explains how out-of-service mode swaps alert classes to maintenance classes in WinCC OA while keeping alert generation active.
        Alarm shelving API reference
        This reference summarizes the alarm shelving, suppression, and out-of-service API functions that are available through the AlertServiceClient.ctl CTRL library.
        Alarm shelving restrictions and notes
        This reference summarizes current restrictions, supported system scenarios, and operational notes for the IEC 62682 alarm shelving feature.
    - Event Manager Connections
    - Memory/Disk Resources
    - System Overview
      A panel for the diagnostics of a WinCC OA system.
    - Diagnostic Tool
    - Continuous Monitoring
      The Continuous Monitoring feature of WinCC OA provides an interface for external tools to read and validate log and error messages of Security Events that were generated by the WinCC OA.
  - Reports
  - Database
  - Driver
  - Driver IEC
  - Driver OPC
  - Driver S7
  - SmartSCADA
  - Permission
  - Communication
  - Settings
- Wizard Framework
  Used for easy creation of wizards in a uniform layout style. The key elements "Navigation Bar" and "Bottom Bar" can be customized to fit the needs of the custom wizard.
- XML Panel Format
  The XML (Extensible Markup Language) panel format allows creating WinCC OA panels.
- Simple Symbols, basics
  The "Simple Symbols" functionality is used to simply assign corresponding symbols to datapoint types and increase the working comfort when working with different symbols.
- ScriptWizard
  Simple wizard for creating graphical user interfaces for users without prior programming knowledge.
- Panel topology/Group alert facility
  Tree structure for process panels with integrated group alert system
- Object-Oriented Panel References
  Reusable objects built with the GEDI tools. Insert them within an existing panel to provide a graphical element.
- Multilingual Projects
  WinCC OA is designed to provide both Native Language Support and Multi Language Support.
- Translator
  The WinCC OA Translator functionality supports you in creating and maintaining multilingual projects. It offers a convenient interface for translation of reusable terms.
- Layout management
  Layouts change the size and position of objects according to parameters previously defined in the GEDI.
- Generic Dialog Framework
  The Generic Dialog Framework is an easy way to generate your own dialogs by adjusting a set of prefabricated panels.
- Simple Configuration
  Simple configuration windows and panels support you in combining events (such as a mouse click) with different actions such as setting datapoint values, showing panels or changing attributes.
Data Management
Classify, structure and archive your data.
Business Logic / Control
Endless possibilities in data processing for your projects.
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
Southbound Interfaces
The process connection to the actual machines/sensors.
Northbound Interfaces
Your portal to the cloud or supervising systems.
Web Connectivity / Network Interfaces
Data exchange, APIs and web technologies
User Management
All about authorization, authentication and login-customization.
Availability
How to get your system uptime to the maximum.
Reporting
Create state of the art project reports without limits.
Addons
Useful tools and enhancements for special demands.
Reference Tables
Detailed and extensive content for special project adaptation.
Videos & Tutorials
Explore the capabilities of WinCC OA with our carefully selected collection of video tutorials and guides.
eLearning
Build Your Expertise Step by Step
Documentation
Basic information about terms and functions within the documentation.
Support & Services
An experienced team of support agents, consultants and trainers are ready to facilitate active partnerships with our customers, so they can profit from our comprehensive service.
Disclaimer
A brief clarification of liability exclusions or legal notices.

Set up alarm shelving and suppression

Use this procedure to activate the Alarm Shelving feature in a WinCC OA project.

You have administrator access to the WinCC OA project.

The feature is controlled exclusively through the internal datapoint _AlertService of type _FeatureInterface.

Enable the AlertService by setting the datapoint element _AlertService.Settings.Command to 1.

Set the element to 1 to enable or 0 to disable the AlertService.

The feature is disabled by default.

The change takes effect immediately at runtime without restarting the system. When the feature is disabled, all operations return a service not available error.
Optional: Restart the Alert Event Screen if it was already open before activation.
The overview buttons for shelving, suppression, and out-of-service are only shown after the UI is reloaded.
Figure 1. Overview buttons in the Alert Event Screen after activation

The AlertService is running, and alarm shelving, suppression, and out-of-service functionality are available in the project.

The Shelve entry must be enabled in General AES settings so that it is shown in the Alert Event Screen context menu.

Test the functionality by shelving a test alert from the Alert Event Screen context menu.

For additional AlertService debug output and log messages, start Control Manager 1 with the -dbg alertservice parameter.