IW21 — Create PM Notification
IW21 creates a plant maintenance notification, the record used to document a malfunction, damage, or maintenance request against a piece of equipment or a functional location. It is separate from a maintenance order: the notification captures what happened and why, the order (created separately or from the notification) plans and executes the work and carries the cost.
IW21 is the entry transaction for creating a PM notification, the first document in the reactive maintenance process. This page covers the notification type structure that drives screen behavior, the tables the save actually writes, and the diagnostic categories behind the most common IW21 complaints: missing catalog codes, absent partner defaults, and notifications that never turn into orders.
Reviewed by an ERPClimb SAP consultant on 15 Sept 2026· 1,091 words
Purpose
IW21 creates a maintenance notification: a structured record of a fault, a completed activity, or a request for work, tied to a technical object (equipment or functional location) or, less often, standing alone. The single structural fact that explains most confusion is that the notification type is not cosmetic. It is a configuration key that determines which screen tabs appear, which catalog profile supplies the damage/cause/activity codes, which partner functions default, and whether a maintenance order is generated automatically. Two notifications that look identical to the end user can behave completely differently in the system if their notification types are configured differently. The notification itself carries no cost and consumes no budget; that only happens once an order is linked to it.
When it is used
IW21 is reached for whenever a fault, request, or observation needs to be logged before or independent of planning the work, which is the standard reactive maintenance entry point in most plants. Field technicians, shift supervisors, or a service desk raise the notification; a planner later reviews it, adds a cause and task list if needed, and either releases the automatically generated order or creates one manually. In S/4HANA landscapes many end users now raise notifications through a Fiori app instead, but the underlying object and the configuration behind it are unchanged, so IW21 remains the transaction consultants use to reproduce and diagnose issues raised against the Fiori equivalent.
How to use it in practice
- Call IW21 and select the notification type (malfunction report, activity report, maintenance request, or a custom type) - this choice fixes the rest of the transaction's behavior
- Enter the technical object: equipment number or functional location, or search by object type if the number is not known
- Check that location and account assignment tab fields (planning plant, maintenance plant, cost center, work center) defaulted correctly from the object master
- Enter a short text and, on the item/damage tab, select or free-text a coding using the catalog assigned to this notification type
- Fill in the required date fields (malfunction start, required end) and priority if the notification type demands them
- Add partners on the partner tab if they did not default, then save
Key data objects
- QMEL - notification header: notification number, type, object reference, dates, priority, status
- QMFE - notification items, one row per damage/problem coding entered on the item tab
- QMUR - causes recorded against a notification item
- QMMA - activities and tasks logged on the notification
- JEST and JCDS - current and historical system/user status for the notification, driving what actions are still allowed
- VIQMEL - the standard reporting view joining header fields with object and partner data, used by most list transactions
How to prove it in the data
Pull the notification number from QMEL and confirm QMTYP (notification type), QMDAT (creation date), and STRMN/STRUR (malfunction start) match what the user reported. Check JEST for the active status entries against that notification number and object type QMEL, joined on OBJNR, to confirm whether it was ever put in process or completed. If the complaint is a missing catalog code, check QMFE for the notification and compare the catalog fields against the catalog profile configured for that notification type; a blank row usually means the code was never valid in that catalog, not a save failure.
ECC vs S/4HANA
The notification data model (QMEL and its item/cause/activity tables) is unchanged on S/4HANA. IW21 still runs as-is in the SAP GUI. Many end users now create notifications through a Fiori app for maintenance notifications instead of the GUI transaction, but that app writes to the same tables through the same underlying logic, so a discrepancy reported in the Fiori app can usually be reproduced and diagnosed directly in IW21.
Common pitfalls and how to diagnose them
- Catalog codes not selectable: the notification type has no catalog profile assigned, or the profile exists but the plant-specific catalog has no valid entries for that coding group. Check the notification type configuration before assuming the catalog itself is broken.
- Partners not defaulting: the partner determination procedure is not linked to this notification type, or the object master (equipment/functional location) has no partners maintained to inherit from. Confirm the object's own partner tab before touching notification config.
- Wrong or missing cost center and work center: these default from the technical object master, not from the notification type. If they are wrong, the equipment or functional location master data is wrong, not IW21.
- Notification created but no order appears: automatic order creation is a per-notification-type setting, not a default. If it is off, the order must be created manually and referenced back to the notification; this is normal, not a defect.
- Status stuck at 'outstanding': the notification was saved but never explicitly put in process. Downstream reports filtering on in-process or completed status will not show it, which reads to end users as the notification having disappeared.
- Duplicate notifications for the same fault: multiple people reporting the same equipment fault through different channels (a call and a Fiori entry) is a process gap, not a system error; check for near-duplicate creation timestamps against the same object number before investigating further.
Whose problem this is
Functional PM/EAM consultant territory: notification type configuration, catalog profiles, partner determination, and status profiles are all customizing. ABAP is only involved for custom fields added via the standard enhancement points or a BAdI implementation. A clean handover states the notification number, notification type, expected versus actual field or code behavior, and whether the issue is reproducible on a new notification of the same type.
Related SAP objects
Reviewed pages this object connects to in the ERPClimb knowledge graph.
Source: ERPClimb — https://erpclimb.com/sap-tcodes/iw21ERPClimb is an independent platform and is not affiliated with SAP SE. Reference pages are written and reviewed by SAP consultants for learning and troubleshooting.