MS-Access error 2501 when saving a record

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.
Who is Participating?
I wear a lot of hats...

"The solutions and answers provided on Experts Exchange have been extremely helpful to me over the last few years. I wear a lot of hats - Developer, Database Administrator, Help Desk, etc., so I know a lot of things but not a lot about one thing. Experts Exchange gives me answers from people who do know a lot about one thing, in a easy to use platform." -Todd S.

Scott McDaniel (Microsoft Access MVP - EE MVE )Infotrakker SoftwareCommented:
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.
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.

Experts Exchange Solution brought to you by

Your issues matter to us.

Facing a tech roadblock? Get the help and guidance you need from experienced professionals who care. Ask your question anytime, anywhere, with no hassle.

Start your 7-day free trial
Asteroid_MiniicAuthor Commented:
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.
Ultimate Tool Kit for Technology Solution Provider

Broken down into practical pointers and step-by-step instructions, the IT Service Excellence Tool Kit delivers expert advice for technology solution providers. Get your free copy now.

Asteroid_MiniicAuthor Commented:
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.
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:)
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
It's more than this solution.Get answers and train to solve all your tech problems - anytime, anywhere.Try it for free Edge Out The Competitionfor your dream job with proven skills and certifications.Get started today Stand Outas the employee with proven skills.Start learning today for free Move Your Career Forwardwith certification training in the latest technologies.Start your trial today
Microsoft Access

From novice to tech pro — start learning today.

Question has a verified solution.

Are you are experiencing a similar issue? Get a personalized answer when you ask a related question.

Have a better answer? Share it in a comment.