MS-Access error 2501 when saving a record

Posted on 2014-09-02
Last Modified: 2016-06-15
Starting form is Activity/Command and goes to Equipment form.  Equipment form is filtered by the Activity, and has a subform for Locks (but for now lets ignore it).

I can create an Equipment record (and tblActivityEquipXref record) manually using just the Equipment form's underlying query (see below).   tblEquipment and tblActivityEquipXref records are created at the same time (actually tblActivityEquipXref is created first as it is the parent).  tblEquipment and tblActivityEquipXref are related but I do not enforce referential integrity.  I set tblActivityEquipXref.Activity_FK in Form_BeforeInsert from a global variable (set in the Activity form).  And yes, the global variable is valid when the Equipment form loads.

I can create a record using the "Add" button (uses DoCmd.RunCommand acCmdRecordsGoToNew) in the Equipment form after an Equpment record has been created for the same Activity.  I tested this by creating a record using the form's query datasource, then loading the Equipment form for that same Activity and creating a second equipment record.  Records are saved in the Equipment form using "DoCmd.RunCommand acCmdSaveRecord" (cmdSave_Click).

The problem occurs (I get Error 2501 executing DoCmd.RunCommand acCmdSaveRecord) when there are no Equipment records (for a given Activity) so I am entering equipment data for the first time for a given Activity and the Equipment form loads in insert/add mode.

It seems Access makes a distinction between a form loading in "Insert/Add" mode and using "DoCmd.RunCommand acCmdRecordsGoToNew".  Why does my form behave differently in these two contexts?  This is the crux of the issue and what I need an expert explain to me.

Query (qFrmEquipment) for the Equipment form is:

SELECT tblActivityEquipXref.Activity_FK
, tblActivityEquipXref.Equipment_FK
, tblActivityEquipXref.BuildingNumber
, tblEquipment.Equipment_PK
, tblEquipment.Model_FK
, tblEquipment.Manufacturer_FK
, tblEquipment.SerialNumber
, tblEquipment.Comments
, tblEquipment.RoomNumber
, tblManufacturer.ManufacturerAbbrev
, tblModelNumber.EquipmentType_FK
, tblModelNumber.ModelNumber
, tblEquipmentType.EquipmentType
, tblContainerLockConfig.NumberOperator
, tblContainerLockConfig.NumberOfLocks
FROM tblEquipmentType INNER JOIN
  ((tblContainerLockConfig RIGHT JOIN
    (tblModelNumber INNER JOIN
      (tblManufacturer INNER JOIN tblEquipment ON tblManufacturer.Manufacturer_PK = tblEquipment.Manufacturer_FK)
    ON tblModelNumber.Model_PK = tblEquipment.Model_FK)
   ON tblContainerLockConfig.LockConfig_FK = tblModelNumber.ContainerLockConfig_FK)
     INNER JOIN tblActivityEquipXref ON tblEquipment.Equipment_PK = tblActivityEquipXref.Equipment_FK)
     ON tblEquipmentType.EquipmentType_PK = tblModelNumber.EquipmentType_FK;

I tried eliminating all tables in the query above, except for tblActivityEquipXref and tblEquipment, but still error 2501.

I tried moving Me.Activity_FK = g_lActivityPK to just before "DoCmd.RunCommand acCmdSaveRecord" (in cmdSave_Click), but still error 2501.

I tried changing the "DoCmd.RunCommand acCmdSaveRecord" statement to "Me.Dirty = False", it doesn't make a difference (other than a different error msg), the record still won't save.
Question by:Asteroid_Miniic
LVL 84
ID: 40300687
Error 2501 is "The DoCmd Action is canceled". This can occur for a variety of reasons, and does not always mean that the user clicked Cancel - the Access codebase can, apparently, generate a "Cancel" event of it's own, and the downstream code acts accordingly.

Your question is somewhat rambling, and without a sample database is hard to follow. From what I can tell, you have a form you're opening in "Insert/Add mode", which I assume means you've set DataEntry = Yes, or something to that effect, and at some point you get a 2501 error. If you could distill this down to a concrete question or two, we might be able to provide better help.

That said, I think it's your query causing the troubles. In general, trying to add Parent and Child records at the same time (which, I believe, is what you're trying to do) is troublesome at best, and should generally be avoided. Access expects to find a valid Parent record before it can add a Child record, and using a JOIN query in that manner does not allow you (or Access) the luxury of checking before you add it. In general, a Form in Access should act on ONE and ONLY ONE entity at a time. Use Subforms if you must show Parent/Child relationships.
LVL 35

Accepted Solution

PatHartman earned 500 total points
ID: 40301039
This error should be trapped and usually ignored.  I find it most frequently when I have a procedure that forces a save with DoCmd.RunCommand acCmdSaveRecord.  If the BeforeUpdate event is cancelled because of some validation error, then the calling procedure receives the 2501 error.  Normally, the user has already gotten an appropriate error message from the BeforeUpdate event so the calling procedure simply traps for the error and then resumes next.  Another common place for this error is when opening a report.  If you have code in the NoData event that cancels opening the report, the calling procedure will get the 2501 error which can be ignored.

PS - if you use the Me.Dirty = False trick to force a save and the BeforeUpdate event is cancelled preventing the save, you will also get an error but it won't be 2501, it will be something else but the exact number escapes me at the moment.

Author Comment

ID: 40301944
Gents, thank you for your comments.  I'll simplify:

1) I can manually create records using my query qFrmEquipment, no problem

2) My form frmEquipment uses query qFrmEquipment as it's data source

3) If frmEquipment opens with existing equipment records (for a given Activty), I can create new equipment records

4) When no Equipment records exist (for a given Activity), frmEquipment loads empty.  I enter data to create a new equipment record and when "DoCmd.RunCommand acCmdSaveRecord" executes (in cmdSave_Click), I get error 2501

Why are actions 3 and 4 different?  

I apologize for lack of code, but the application exists on a secure private network and I'm not allowed to export code.
Complete VMware vSphere® ESX(i) & Hyper-V Backup

Capture your entire system, including the host, with patented disk imaging integrated with VMware VADP / Microsoft VSS and RCT. RTOs is as low as 15 seconds with Acronis Active Restore™. You can enjoy unlimited P2V/V2V migrations from any source (even from a different hypervisor)


Author Comment

ID: 40302008
Thank you PatHartman!

You were right, after double-checking my BeforeUpdate event, there was a line of code Canceling the event if action 4 conditions are met.  It always seems the simplest answer is the solution.  I must have stared at that code hundreds of times in the past 2 days and just didn't recognize it.  The disadvantage of being the only IT guy in the dept (in the building)-- no one to bounce ideas off.
LVL 35

Expert Comment

ID: 40302329
My programmers used to think I was Karnack the Magnificent (from the Johnny Carson show if you are to young to recognize the name).  They would explain their symptoms and I would tell them what was wrong with the code.  You have to make a lot of mistakes to get to the point of debugging from afar.  My curse is remembering most of them:)
LVL 27

Expert Comment

ID: 41655167
No comment has been added to this question in more than 21 days, so it is now classified as abandoned.

I have recommended this question be closed as follows:

Accept: PatHartman (https:#a40301039)

If you feel this question should be closed differently, post an objection and the moderators will review all objections and close it as they feel fit. If no one objects, this question will be closed automatically the way described above.

Experts-Exchange Cleanup Volunteer

Featured Post

Three Reasons Why Backup is Strategic

Backup is strategic to your business because your data is strategic to your business. Without backup, your business will fail. This white paper explains why it is vital for you to design and immediately execute a backup strategy to protect 100 percent of your data.

Question has a verified solution.

If you are experiencing a similar issue, please ask a related question

Introduction The Visual Basic for Applications (VBA) language is at the heart of every application that you write. It is your key to taking Access beyond the world of wizards into a world where anything is possible. This article introduces you to…
Preparing an email is something we should all take special care with – especially when the email is for somebody you may not know very well. The pressures of everyday working life stacked with a hectic office environment can make this a real challen…
In Microsoft Access, learn how to use Dlookup and other domain aggregate functions and one method of specifying a string value within a string. Specify the first argument, which is the expression to be returned: Specify the second argument, which …
Access reports are powerful and flexible. Learn how to create a query and then a grouped report using the wizard. Modify the report design after the wizard is done to make it look better. There will be another video to explain how to put the final p…

821 members asked questions and received personalized solutions in the past 7 days.

Join the community of 500,000 technology professionals and ask your questions.

Join & Ask a Question