API for Natural Error Codes

This document describes the error codes you may encounter while using the application programming interface for Natural.

    0004
    Explanation

    Unsupported version.

    Action

    Correct the version in the ADRAPI-INTERFACE and re-run.


    1004
    Explanation

    General processing error.

    Action

    Contact Software AG


    1008
    Explanation

    Unknown API function.

    Action

    Correct error and re-run. If the problem persists, contact Software AG.


    1020
    Explanation

    LFILE 152 not set.

    Action

    This run mode requires the setting of LFILE 152. Correct error and re-run.


    1021
    Explanation

    Error setting LFILE 152

    Action

    The program could not set LFILE 152. Check that the files used for the Repository and the To-Do Listare available to the program. Correct the error if possible and re-run, otherwise contact Software AG.


    1024
    Explanation

    Error accessing LFILE 152. Response: xxx Subcode: yyy.

    Action

    The program could not access LFILE 152. The response and subcode are reported. Correct the error if possible, otherwise contact Software AG.


    1028
    Explanation

    Unknown Group/Plan/Action.

    Action

    Check specified Group/Plan/Action, correct as necessary and re-run.


    1032
    Explanation

    Unable to validate Group/Plan/Action status.

    Action

    Ensure that this Group/Plan/Action is correctly defined and re-run.


    1050
    Explanation

    Invalid number of Source Files specified in the ADRAPI-NUM-FILES parameter (must be >0, <256).

    Action

    Correct and re-run.


    1054
    Explanation

    Invalid Source File(s) specified. One or more of the Source File(s) specified does not match the Source File names configured in the UI for the Action.

    Action

    Correct and re-run.


    1058
    Explanation

    Invalid number of files in the Source File/s list (must be >0, <256). The number of Source files passed by the API must match the number configured in the UI for the Action.

    Action

    Correct and re-run.


    1062
    Explanation

    Invalid number of Target Files specified in the ADRAPI-NUM-TARGET-FILES parameter (must be >0, <256).

    Action

    Correct and re-run.


    1066
    Explanation

    Invalid Target File(s) specified. One or more of the Target File(s) specified does not match the Target File names configured in the UI for the Action.

    Action

    Correct and re-run.


    1072
    Explanation

    Invalid number of files in the Target File/s list (must be >0, <256). The number of Target Files passed by the API must not exceed the number configured in the UI for the Action.

    Action

    Correct and re-run.


    1100
    Explanation

    A general processing error occurred during the creation of a To-Do list.

    Action

    Contact Software AG.


    1104
    Explanation

    An attempt was made to create a To-Do list but a To-Do list already exists for the specified Group/Plan/Action.

    Action

    Use the REMOVE function to delete the existing To-Do list before attempting to create a new one.


    1200
    Explanation

    An attempt was made to insert a new business object into a To-Do list but the specified business object ID is zero.

    Action

    Specify a valid business object ID in ADRAPI-OBJECT-ID and re-run.


    1204
    Explanation

    An attempt was made to insert a new business object into a To-Do-list which does not exist.

    Action

    Use the CREATE function to create a new To-Do list before attempting to use the INSERT function to insert business objects.


    1208
    Explanation

    An attempt was made to insert a new business object into a To-Do list but the specified Activity-ID does not match the Activity-ID belonging to the current To-Do list.

    Action

    Ensure that the Activity-ID specified in ADRAPI-ACTIVITY-ID of the INSERT function matches that returned by the corresponding CREATE function.


    1212
    Explanation

    An error occurred inserting a new business object into a To-Do list.

    Action

    In the UI, select the node To-Do List from within the corresponding Group/Plan/Action to display the status of the current To-Do list. New business objects can only be inserted into a To-Do list when the status is “in-progress”.


    1250
    Explanation

    An attempt was made to delete a To-Do list but the specified Activity-ID does not match the Activity-ID belonging to the current To-Do list.

    Action

    Ensure the Activity-ID of the current To-Do List is specified in the REMOVE function.


    1300
    Explanation

    An attempt was made to close a To-Do list which does not exist.

    Action

    Review the specified Group/Plan/Action to ensure the correct To-Do list is attempting to be closed.


    1304
    Explanation

    Invalid options specified on the CLOSE function.

    Action

    Review the specified options.


    1400
    Explanation

    An attempt was made to start a To-Do list activity for the specified Group/Plan/Action but the To-Do list does not exist.

    Action

    Review the specified Group/Plan/Action to ensure the correct To-Do list is attempting to be started.


    1404
    Explanation

    A general processing error occurred during the starting of a To-Do list activity.

    Action

    Contact Software AG.


    1408
    Explanation

    An attempt was made to start a To-Do list activity for the specified Group/Plan/Action but the To-Do list was not in the “ready-to-run” state.

    Action

    In the UI, select the node To-Do List from within the corresponding Group/Plan/Action to display the status of the current To-Do list. A To-Do list can be started only when the status is “ready-to-run”. If appropriate, perform a CLOSE function to set the To-Do list state to "ready-to-run" and then re-issue the ARCHIVE function.


    1450
    Explanation

    An attempt was made to recall a To-Do list archive for a Group/Plan/Action but no To-Do list has ever been created for the specified Action.

    Action

    Review the specified Group/Plan/Action to ensure the correct To-Do list archive is attempting to be recalled.


    1454
    Explanation

    A general processing error occurred during the recalling of a To-Do list archive.

    Action

    Contact Software AG.


    1500
    Explanation

    An attempt was made to open a To-Do list activity for the specified Group/Plan/Action/Activity-ID but the To-Do list does not exist.

    Action

    Review the specified Group/Plan/Action/Activity-ID to ensure the correct To-Do list is attempting to be opened.


    1504
    Explanation

    An attempt was made to open a To-Do list but the specified Activity-ID does not match the Activity-ID belonging to the current To-Do list.

    Action

    Ensure that the Activity-ID specified in ADRAPI-ACTIVITY-ID of the OPEN function matches that returned by the corresponding CREATE function.


    1508
    Explanation

    An attempt was made to open a To-Do list for the specified Group/Plan/Action but the To-Do list was not in the “in-progress” state.

    Action

    In the UI, select the node To-Do List from within the corresponding Group/Plan/Action to display the status of the current To-Do list. A To-Do list can be opened only when the status is “in-progress”.


    1600
    Explanation

    An attempt was made to delete a business object from a non-existent To-Do list.

    Action

    Review the Group/Plan/Action/Activity-ID to ensure the correct To-Do list is being specified.


    1604
    Explanation

    An attempt was made to delete a business object from a To-Do list but the specified Activity-ID does not match the Activity-ID belonging to the current To-Do list.

    Action

    Ensure that the Activity-ID specified in ADRAPI-ACTIVITY-ID of the ERASE function matches that returned by the corresponding CREATE function.


    1608
    Explanation

    An attempt was made to delete a business object from a To-Do list for the specified Group/Plan/Action but the To-Do list was not in the “in-progress” state.

    Action

    In the UI, select the node To-Do List from within the corresponding Group/Plan/Action to display the status of the current To-Do list. A business object can be erased from a To-Do list only when the status is “in-progress”.


    1612
    Explanation

    An attempt was made to delete a business object from a To-Do list for the specified Group/Plan/Action/Activity-ID but the business object was non-existent.

    Action

    Review the Group/Plan/Action/Activity-ID/Object-ID to ensure the correct business object is being specified.


    1700
    Explanation

    An attempt was made to determine the status of a non-existent To-Do list.

    Action

    Review the Group/Plan/Action to ensure the correct To-Do list is being specified.


    1800
    Explanation

    Invalid parameter list.

    Action

    Review the parameter list for the specified function.


    1801
    Explanation

    This function necessitated a change in Activity status but competing processes meant this was not possible.

    Action

    Re-issue the function.


    1802
    Explanation

    An attempt was made to resume an Activity not in the ‘paused’ state.

    Action

    Wait until the Activity has reached the paused state before re-issuing the RESUME function.


    1803
    Explanation

    No current activities were found appropriate to the function being requested.

    Action

    No action is required.


    1804
    Explanation

    Invalid argument.

    Action

    Review the arguments for the specified function.


    1805
    Explanation

    An attempt was made to restart an Activity that was not in the "failed" state.

    Action

    The RESTART function can only be issued for Activities that are in a "failed" state. If the Activity is in a "paused" state, the RESUME function should be used.


    4999
    Explanation

    Error in API call, refer to manual for code: NNNN.

    Action

    Various errors from the processing layer. The error message contains an error number that is explained below:

    Processing Layer Errors (Error 4999)

    Error number Explanation
    2 Error; contact Software AG
    3 Memory allocation error
    4 Record not found
    5 To-Do list already exists for the Group, Plan, Action
    7 No more records
    8 Invalid parameter list
    9 Required resources held by another process
    10 Caller is using a different thread to the one used for the CREATE/OPEN calls
    30 Incorrect API version
    31 Incorrect number of arguments
    32 Natural parameter description read error
    33 Incorrect Natural parameter description information
    34 Incorrect calling of API function; contact Software AG