MS-Access error 2501 when saving a record

Posted on 2014-09-02
Medium Priority
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
Welcome to Experts Exchange

Add your voice to the tech community where 5M+ people just like you are talking about what matters.

  • Help others & share knowledge
  • Earn cash & points
  • Learn & ask questions
LVL 85
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 38

Accepted Solution

PatHartman earned 2000 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.
What Is Blockchain Technology?

Blockchain is a technology that underpins the success of Bitcoin and other digital currencies, but it has uses far beyond finance. Learn how blockchain works and why it is proving disruptive to other areas of IT.


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 38

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

Free Tool: Port Scanner

Check which ports are open to the outside world. Helps make sure that your firewall rules are working as intended.

One of a set of tools we are providing to everyone as a way of saying thank you for being a part of the community.

Question has a verified solution.

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

Phishing attempts can come in all forms, shapes and sizes. No matter how familiar you think you are with them, always remember to take extra precaution when opening an email with attachments or links.
This article describes a method of delivering Word templates for use in merging Access data to Word documents, that requires no computer knowledge on the part of the recipient -- the templates are saved in table fields, and are extracted and install…
In Microsoft Access, learn how to “cascade” or have the displayed data of one combo control depend upon what’s entered in another. Base the dependent combo on a query for its row source: Add a reference to the first combo on the form as criteria i…
Visualize your data even better in Access queries. Given a date and a value, this lesson shows how to compare that value with the previous value, calculate the difference, and display a circle if the value is the same, an up triangle if it increased…
Suggested Courses

752 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