How To: Understand Khaos Control error messages


When Khaos Control is unable to carry out an action, it should popup an error dialog saying what went wrong. Whilst we strive to ensure that error messages are meaningful, some of them are necessarily couched in technical language.

Here are some examples:

Access Violation

Should Khaos Control attempt to access an area of your computer's memory that does not contain any valid data, it will throw an access violation.

This type of error, which may indicate an error in the underlying program language, is extremely difficult to track down. In order to help us reproduce the error in our development environment, it would be very helpful if you can:

  1. email us the exact error message;
  2. describe exactly what you were doing immediately before the access violation occurred;
  3. tell us what other Khaos Control screens were open at the time; and
  4. let us know what version of Windows you were running.

Connection Lost

This error message indicates the network connection between the computer running Khaos Control and your database server has failed:
Likely causes include:
  • A network connection has become unplugged;
  • The KhaosControl database server has been turned off, or is being rebooted (or has developed a fault);
  • An item of network equipment (such as a hub, router or switch) that should connect the computer running Khaos Control to your database server has been turned off (or has developed a fault).

Action:

  1. If you can immediately fix the problem (e.g. if your network cable has fallen out, plug it back in), do so and then press the "YES" button. Khaos Control will then attempt to reconnect to your database server.
  2. Otherwise press the "NO" button and stop using Khaos Control until the problem is fixed.
  3. If you don't press either button within a reasonable time, you may see other error messages, such as:
    "Invalid pointer operation",
    "[DBNETLIB][ ConnectionOpen (Connect()).] SQL Server does not exist or access denied.",
    "TKosBase: Attempt to use KosMessageDlg callback function when it's not assigned.", or
    "Database Connection Failure: KhaosControl has been unable to connect to the database for over 5 mins."
    At this point, you may wish to call or email Support.

EUnrecoverable errors

Cannot post a payment to a bank account with differing currencies

The error message:

EUnrecoverable
Cannot post a payment to a bank account with differing currencies.

is seen when attempting to create a sales order against a customer, where the system has identified a problem with the bank account (setup in System Data).

Default Customer / Supplier Class

The error message:

Invalid System Data Default Company Class specified, unable to continue

may be displayed when creating new customer after updating from a version prior to KCX 7.25.3f. It is an unwanted side effect that results from improved validation checks which were introduced in KCX 7.25.3f and is caused by the Default Customer Class (or Default Supplier Class) in System Values being set to a customer class that no longer exists.

Please contact email Support who will assist you in resolving this error.


KPAF licensing

The error message:

Error initialising TKosKAPF Check your KPAF licensing

may be displayed whenever either of the following conditions exist:

  1. The user is not KPAF-enabled; or
  2. All the KPAF licenses are in use.

Additional information concerning KPAF can be found elsewhere on KhaosWiki, for example: "How To: Give a User KPAF rights" has a suggestion for freeing up KPAF Licenses.

No valid currency conversion

This message may be seen when processing a Supplier Return:

There is no valid currency conversion defined for Pound Sterling, 
it is possible that the definition has expired.

Please contact email Support who will assist you in resolving this error.

Potentially invalid zero value

Should a discrepancy in the Sales Order value be identified when attempting to process orders through Sales Invoice manager stages, the following error message will be displayed:

???: Potentially invalid zero value Invoice Item line detected for Stock Code: XXXX Sales order: XXXX

Please edit and save this order before proceeding further. If you continue to experience issues then please {{emailSupport}}.

Opening and re-saving the affected sales order(s) will clear this message.

Should several sales orders be affected (e.g. resulting from system failure when booking in stock), we suggest using Sales Invoice manager's "Filter (F4)" to see orders that include the affected stock item.

Profile message - update the user profiles

This message may be seen by users after applying an update:

Profile message: the layout of these tabs has changed. 
Please ask your administrator to update the user profiles

To clear this message, a user with Administrator permission should:

  1. Open a System Data screen (show me how).
  2. Go to the "User" screen
  3. Right-click anywhere in the grid and select "Define Profiles" from the context menu.
  4. A message, warning that each screen will be opened in turn, will appear.
  5. Answering "Yes" to this message causes each screen to be opened in turn, following which the 'Define Profiles' dialog will be displayed.
  6. Press the "Refresh Profiles" button, which can be found towards the top-right of this dialog. This causes any screen/tab changes to be written to the profile.
  7. Check each profile you are using to ensure profile users are seeing screens/tabs/areas appropriate to their roles.
  8. Click the "OK" button to save these changes and close the dialog.

String or binary data would be truncated

This error message may occur when attempting to save a record, where one of the fields contains more characters than have been allowed for in the database. The text following 'insert into' identifies the exact error:

String or binary data would be truncated[insert into ... ... ... ].

Whilst many screens have been set to ensure that a field's background colour turns pink if too many characters have been entered, there are some places where this hasn't happened yet.

User account exceeded

This message indicates the user count (i.e. number of Khaos Control licenses available for use) has been exceeded. It may be seen by any user who attempts to login when all the user licenses are in use:

User account exceeded, the system will release bad session locks (if any exist) in 3-20 minutes.

It may also appear when a user's session has been terminated abnormally (e.g. as a result of communication failure between the user's PC and the SQL Server running Khaos Control.

Value Proportion not available

This message is displayed on the Stock screen's Relationship tab when attempting to unbuild stock, where one or more child stock items have zero value proportion:

Value proportion not available and system failed trying to calculate 
it from parent/child stock values.

For stock to be successfully unbuilt, each child stock item should have a value proportion set against it (the Value Proportion page explains how to set value proportions) and this should total to a value less than the parent's stock value (if set).


See Also


Did you find this article helpful?