VIQMEL table — Maintenance Notification View for List Selection
VIQMEL is the database view SAP uses to select and list plant maintenance notifications, joining the generic notification header table QMEL with the PM-specific extension that carries equipment, functional location and breakdown data. One row is one notification. It underlies notification list transactions such as IW28 and IW29 and most custom PM notification reports, rather than being a table application code writes to directly.
VIQMEL is the standard join view behind PM notification list and selection screens, combining the generic notification header with the maintenance-specific extension holding equipment and functional location. This page covers the fields worth selecting on, how the view relates to equipment, functional location, order and partner tables, and the mistakes consultants make treating it as if it were a real, directly maintained table.
Published 16 Sept 2026· 1,062 words
What it stores
One row in VIQMEL represents one maintenance notification as seen from the list and selection perspective. The view exists because notification data is split across tables: the generic notification header (type, text, dates, status-relevant fields, created-by) lives in the core notification table, while PM-specific attributes such as equipment number, functional location, malfunction start and end, and breakdown duration live in a separate maintenance-specific extension record created only for PM-type notifications. VIQMEL joins these so that a single flat read returns everything a list transaction needs without the calling program having to know about the split. It is read-heavy infrastructure: reports, matchcodes and the notification worklist run against it, but nothing writes to it directly. QM notifications and other non-PM notification types will show blank in the PM-specific columns because the join partner record does not exist for them.
Key fields
- QMNUM - notification number, the primary key and join field to every other notification table
- QMART - notification type, distinguishes malfunction report, activity report, maintenance request and similar types
- QMTXT - short text describing the notification
- EQUNR - equipment number affected, populated only when the notification references equipment
- TPLNR - functional location, populated only when the notification references a location
- AUFNR - maintenance order number if one has been created against the notification
- PRIOK - priority code
- INGRP - planner group responsible
- MAWERK - maintenance plant
- STRMN - required start date for processing
- ERDAT and ERNAM - creation date and creating user
How it joins the data model
- VIQMEL-EQUNR = EQUI-EQUNR to reach equipment master data
- VIQMEL-TPLNR = IFLOT-TPLNR to reach the functional location master
- VIQMEL-AUFNR = AFIH-AUFNR to reach the maintenance order header extension when an order exists
- VIQMEL-QMNUM = IHPA-OBJNR (via object number derived from QMNUM) to reach notification partners such as reported-by or responsible person
- VIQMEL-QMNUM is the anchor for notification items and causes held in the separate item and cause tables, not exposed as columns in this view
How to read it safely
There is no client field visible on VIQMEL itself in the usual sense because the view already resolves within the current client context, but every selection still runs client-dependent underneath, so cross-client comparisons require going to the source tables directly. QMNUM is unique and highly selective; always lead with it, a date range on ERDAT or STRMN, or MAWERK plus INGRP when scanning a worklist. Avoid open-ended selects on QMART or PRIOK alone in a productive system with years of notification history, the view can return an enormous result set because it inherits the full row count of the underlying notification table. Restrict by plant and date first, then narrow further.
How to prove it in the data
Symptom: a notification appears in an equipment's history in IW28 but a custom report using EQUNR as a filter misses it. Select VIQMEL where EQUNR equals the equipment number and compare QMART and the presence of AUFNR against what the report actually filtered on. If the notification is a QM-type notification rather than PM-type, EQUNR in VIQMEL will be blank even though the equipment is referenced elsewhere, because the PM-specific extension record was never created for that notification type. That confirms the report's join logic, not the master data, is at fault.
ECC vs S/4HANA
VIQMEL continues to exist on S/4HANA and is still the view most PM notification list transactions read from. The underlying notification header table structure is largely unchanged from ECC. Some newer Fiori-based notification apps read from CDS views built for OData exposure rather than from VIQMEL directly, but classic transactions and most custom ABAP reports still hit VIQMEL exactly as they did before. No wholesale replacement of VIQMEL by a compatibility view has occurred; it is not one of the tables affected by the simplified data model changes that hit inventory or finance objects.
Common pitfalls
- Treating VIQMEL as a maintained table and trying to update it directly, changes must go through the notification transactions or their BAPIs, never through direct table maintenance
- Assuming a blank EQUNR or TPLNR means the notification has no object reference, when it may simply be a non-PM notification type whose PM-specific extension record does not exist
- Forgetting that AUFNR is only populated once an order has actually been created against the notification, an empty AUFNR does not mean no work was ever planned, it may mean the order was created later and the view was read from a cached list
- Building custom reports directly against VIQMEL and then complaining about performance on a full-table scan, the view carries no additional indexing beyond what its base tables provide
- Using VIQMEL to judge notification status, the completion and release status fields are status-management driven and need to be checked against the object's status table, not inferred from a date field being filled
- Comparing notification counts between VIQMEL and a QM-side report and expecting the same universe, VIQMEL is scoped toward PM-relevant content even though quality notifications share the same underlying header table
Whose problem this is
The PM functional consultant or maintenance planner owns questions about why a notification does or does not show equipment or location data, since that traces back to notification type configuration. The ABAP or reporting developer owns performance and join-correctness issues when VIQMEL is used inside a custom report. Nobody owns direct data correction on this view, because it is not writable.
Related SAP objects
Reviewed pages this object connects to in the ERPClimb knowledge graph.
Source: ERPClimb — https://erpclimb.com/sap-tables/viqmelERPClimb is an independent platform and is not affiliated with SAP SE. Reference pages are written and reviewed by SAP consultants for learning and troubleshooting.