Skip to content

What Do Domino Error Messages really mean

February 15, 2012

How many times have you read an error message from the Domino server that you thought meant one thing only to find the cause was something else altogether?

What is an “Item not found exception”.   Obviously somethings not where it was expected to be , but what  & how do you fix it.

Eventually I found that the most likely cause of the above error is an <input> element on a form that doesn’t have a corresponding Notes field of the same name.

This is a list I started for WCC’s own domino developers.  Please feel free to add your own favourite domino error messages ( I can’t believe that I just typed that!)

  • HTTP Web Server: Item not found exception

<input> element added to the form as Pass-thru HTML with no corresponding Notes field of the same name. All text input elements must have the equivalent Notes field!

  • Lotus Notes Exception – Note item not found

If your form has a Computed Subform and this Subform contains a field with the same name as one on the main form you will see this error.

  • Lotus Notes Exception – A view of that name cannot be found in the specified database

The view specified in your @DBLookup/Column formula doesn’t exist, is inaccessible or is spelt incorrectly

  • Lotus Notes Exception – Incorrect data type for operator or @Function: Text Expected

Most probably one of your Computed Text areas or @Formulas is trying to concatenate a date or a number with a string. For example “The total amount is ” + aNumberField or “The date is ” + @Now would cause this error. Use @Text to convert dates and number to a string. They can be tricky to find in a complex form. Usually best to remove formulas one by one until you find the offending party.
Can also happen if you blank out the name of a query save/open agent so that it reads @Command([ToolsRunMacro]; “”) instead of @Command([ToolsRunMacro]; “<Your agent goes here>”). To rectify this, either remove the whole line and save the form or enter the name of the agent that you require. Note that you cannot simply type in “<Your agent goes here>” to return it to the default.

  • Lotus Notes Exception – Incorrect data type for operator or @Function: Number expected

Check for things like double ++ in your @Formulas. For example, I sometimes have “<style>” + @NewLine + on one line and then + “tr {” + @NewLine + on the next line of my $$HTMLHead field. Because the second line starts with a + and the first one ends in one we get ++. Remove one of them.

  • Lotus Notes Exception – File does not exist

The database filename you specified in an @DBLookup/Column formula doesn’t exist.

The name of the view that preceeds a “?SearchView&Query=” URL does not exist or is spelt wrongly.

  • Lotus Notes Exception – Unsupported trigger and search type for agent being run in the background

Make sure your Web Query Open/Save agents have the option “Run Once (@Commands may be used)” selected in “Which documents should it act on” and “Manually from the Agent list” selected in “When should this agent run?”. (Thanks to Patrick Correya)

  • Lotus Notes Exception – Error validating user’s agent execution access

Usually occurs because the ID that is being used to run the Agent is not listed in the Domino Direcotry (NAB) and being allowed to run Agents.

  • Lotus Notes Exception – Invalid document identifier

If your Web Query Save/Open agent is named wrongly or doesn’t exist.
Could also be that a Shared Field on the form has been removed from the database or has been renamed.
URLs that end in “?DeleteDocument” will throw this error if the view that is specified does not exist. It is okay when using “?OpenDocument” or “?EditDocument” to use any string in place of the view name, yet not when deleting. Try using a view you know exists or using “/$DefaultView/”.

  • Lotus Notes Exception – Entry Not Found in Index

Your @DBLookup may have failed as the entry you looked for is not in the first sorted column of the view. To avoid this assign your lookup to a variable and then use @IsError to check whether a value is returned.

  • Lotus Notes Exception – The Address Book does not contain a cross certificate capable of validating the public key

Check that any agents you are running are signed by an ID in the domain that the server is in or that have been cross-certified.

  • Lotus Notes Exception – Special Database Object cannot be located

Usually due to the database not having a defualt form and you try to open a document without a correct form in the “Form” field or no “Form” field at all. Can also be caused by URLs ending in “$help” and there being no “Using this database” document created or if the “on web launch” property is set to open the “About Database” page and this has not been created yet or you use “$DefaultView” in a URL and a default view has not been specified

  • Lotus Notes Exception – @Function is not valid in this context

Sounds quite an obvious one but usually due to an Hotspot that uses something like @Command([FileSave]) when the document is in read-mode.

  • Application Exception – Documents treated as HTML cannot be edited

If you have a form for whom you have turned on the “Treat document contents as HTML” property then you need to ensure that URLs that call the form end in “?ReadForm” rather than “?OpenForm”

  • HTTP Web Server: Graphic Background Not Found Exception

If you are opening a Navigator (or a form that contains an Embedded Navigator) make sure that the Navigator’s property “Web browser compatible” is enabled.

  • Lotus Notes Exception – Unable to interpret Time or Date

This problem can be down to the fact that the Notes server and the OS on the machine have been set up to use different date formats. Both need to be the same.

Could also be that the Date field on the form has its value set incorrectly in the Web Query Open agent and consequently Domino cannot render it properly.

  • HTTP Web Server: Corrupt Data Exception

Not that common an error in practice. Usually due to a change in the design of a form taking place after a user opens it and before they submit it.

  • HTTP Web Server: Invalid URL Exception

Make sure that everything after the “db.nsf/” portion appears legal. Something like “/dir/db.nsf/test?OpenDocument” would cause this error as there is no view specified

  • HTTP Web Server: Unknown Command Exception

Check for URL typos “?OpnForm”

  • HTTP Web Server: Lotus Notes Exception – Invalid UNID;UNID must be a 32-digit hex string

Are you using @GetDocField in one of your fields on a child form to get a value from its parent? If so check the resulting UNID is correct.

  • HTTP Web Server: Lotus Notes Exception – Unsupported trigger and search in the background or embedded agent

This occurs when you run a webquerysave agent without the option
Run Once (@Commands may be used) option in
Which documents should it act on ?

  • *”Special Database Object Not Found” or similarly “Special Database Object cannot be located”.

You get this if you try to open a URL with something like /dir/db.nsf/$DefaultView and there is no default view. Similarly if you try and open $Help and there is no “Using This Database” document. Others include $DefaultForm and $About.

  • * Error 500 HTTP Web Server: Lotus Notes Exception – The data types of two matching results are incompatible

The data types of two matching results are incompatible. If an @DbColumn is being performed on an integer column, and there is a document in the view with a null integer field — a blank field — you will get this error message.

  • * This is what all the numbers returned with errors signify:
  • 2xx Success
  • 200 OK; the request was fulfilled.
  • 201 OK; following a POST command.
  • 202 OK; accepted for processing, but processing is not completed.
  • 203 OK; partial information–the returned information is only partial.
  • 204 OK; no response–request received but no information exists to send back.
  • 3xx Redirection
  • 301 Moved–the data requested has a new location and the change is permanent.
  • 302 Found–the data requested has a different URL temporarily.
  • 303 Method–under discussion, a suggestion for the client to try another location.
  • 304 Not Modified–the document has not been modified as expected.
  • 4xx Error seems to be in the client
  • 400 Bad request–syntax problem in the request or it could not be satisfied.
  • 401 Unauthorized–the client is not authorized to access data.
  • 402 Payment required–indicates a charging scheme is in effect.
  • 403 Forbidden–access not required even with authorization.
  • 404 Not found–server could not find the given resource.
  • 5xx Error seems to be in the server
  • 500 Internal Error–the server could not fulfill the request because of an unexpected condition.
  • 501 Not implemented–the sever does not support the facility requested.
  • 502 Server overloaded–high load (or servicing) in progress.
  • 503 Gateway timeout–server waited for another service that did not complete in time.
  • Lotus Notes Exception – Insufficient arguments for database function
  • Usually in an @DBLookup and you forgot to specify the key or the column number. Check your @DBLookups
  • Lotus Notes Exception – @Function is not valid in this context
  • Probably you are trying to do something like create a response document (@Command([Compose];”rq”) from a page that is NOT a document. Could also be an “Edit” link (@Command([EditDocument])) on a form or a new document or a view etc…
  • * Error 404
  • Not found – file doesn’t exist or is read protected [even tried multi]
  • If you type the wrong extension name( insead of .nsf anything say .nsd or .nsx ) above error’ll come.
  • * Error 500
  • HTTP Web Server: Lotus Notes Exception – Formula or value requires too much memory
  • This error normally occurs when the return value of a @DbLookup or @DbColumn exceeds the memory limit.
Leave a Comment

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

%d bloggers like this: