Natural System Error Messages 0951-1000

NAT0951: Normal end of execution.

Text
Normal end of execution.
Explanation
This message indicates the successful execution or completion
of a Natural batch job.
Action
No action required.

NAT0952: Database loop processing limit exceeded.

Text
Database loop processing limit exceeded.
Explanation
The processing limit of a HISTOGRAM/FIND/READ database loop is
specified via a numeric constant or a numeric user-defined variable.
When this limit is exceeded, this does not necessarily indicate an
error condition; however, the records which met the search criteria
in a database loop but which are beyond the limit have not been
processed.
Note: The general limit for processing loops may also be set with the
      Natural session parameter LT.
Action
Increase the limit value or ignore this error message.

NAT0953: Time limit exceeded.

Text
Time limit exceeded.
Explanation
In TP mode, this message means that the time-out parameter specified
for the TP monitor at system generation time is not sufficient to
handle current program requirements. In batch mode, after determining
that the program is not in an endless loop, the MT parameter (via a
SET GLOBALS statement or GLOBALS command) can be used to increase the
CPU-time factor.
Action
Check program and correct it if necessary.
If program is correct, contact your Natural administrator.

NAT0954: Abnormal termination :1: during program execution.

Text
Abnormal termination ... during program execution.
Explanation
An abnormal termination has occurred during the
execution of a Natural object program.
A common cause of this error is the use of an arithmetic operand
which does not contain valid numeric data at execution time.
Action
Check program and correct error.

NAT0955: Abnormal termination :1: during program compilation.

Text
Abnormal termination ... during program compilation.
Explanation
An internal abnormal termination has occurred during
the Natural syntax/compilation phase.
Action
Contact your Natural administrator.

NAT0956: Abnormal termination :1: during command analysis.

Text
Abnormal termination ... during command analysis.
Explanation
An abnormal termination of the Natural system has occurred during
the evaluation of a command.
Action
Contact your Natural administrator.

NAT0957: Database loop limit reached with 'LE=ON'.

Text
Database loop limit reached with 'LE=ON'.
Explanation
The limit specified for a database processing loop in a FIND, READ or
HISTOGRAM statement was reached.
This leads to a termination of the loop statement and the program flow
continues normally with the statement following the aborted loop. At
the end of the program, error message NAT0957 is encountered, if
parameter "LE=ON" is set.
The limit may be either set with an explicit value supplied in the
database loop statement (e.g. FIND (10) ..) or, if no explicit limit
was given, globally in a program with the LIMIT statement
(e.g. LIMIT 10).

In batch mode, Natural will continue processing only if the session
parameter CC is set to 'OFF'.
Action
Increase the limit value or set 'LE=OFF'.

NAT0958: Invalid usage of ODA (object data area) in method :1:.

Text
Invalid usage of ODA (object data area) in method ....
Explanation
Object data areas (ODAs) are defined in methods to use class-specific
data. If an ODA is defined in a subprogram, this subprogram can only be
called as a method of a class (statement SEND METHOD). Also the ODA
defined in a method must be compatible to the ODA defined in the class.
The method is either being called without using SEND METHOD, or the
ODA defined in the method contains a different number of variables
than the ODA defined in the class.
Action
Activate the method using SEND METHOD. Ensure that the ODA defined in
the method contains the same number of variables as the ODA defined
in the class.

NAT0959: Inconsistent ODA structure in class :1: and method :2: (:3:).

Text
Inconsistent ODA structure in class ... and method ... (...).
Explanation
Object data areas (ODAs) are defined in methods to use class-specific
data. Therefore, the structure of the ODA defined in the class must
match the structure of the ODA defined in the method.
An inconsistency was detected for the variable shown in brackets.
Action
Ensure that the variables contained in the ODA of a method and its
class have the same format and length.

NAT0960: SAVE/CATALOG/PURGE/UNCATALOG terminated unsuccessfully.

Text
SAVE/CATALOG/PURGE/UNCATALOG terminated unsuccessfully.
Explanation
The operation was attempted repeatedly and a
response code of '9' for transaction back-out
was received from Adabas when XREF data
were processed.
Action
Ask your Natural administrator to review the maximum transaction
duration time setting for Adabas.

NAT0961: Concurrent SAVE/CAT/PURGE/UNCAT; or hold queue full.

Text
Concurrent SAVE/CAT/PURGE/UNCAT; or hold queue full.
Explanation
The same source program/object module is currently being processed
for update by another user.
This error condition can also be produced when Adabas response code
'145' is received while attempting to delete the 'old' copy of the
Natural source or object program. A common reason for this error is
an overflow of the Adabas hold queue.
Action
Retry operation later.
If problem persists, notify your Natural administrator.

NAT0962: Invalid access to Natural system library.

Text
Invalid access to Natural system library.
Explanation
An attempt was made to access/replace a program in the Natural system
library 'SYSLIB'. The use of 'SYSLIB' is restricted to Natural system
routines; a user must not use library ID 'SYSLIB'.
Action
Do not attempt to access the system library 'SYSLIB'.

NAT0963: Security violation during program execution (:1:).

Text
Security violation during program execution (...).
Explanation
The current user has attempted to execute a Natural
program which has a restricted status.
Action
Contact your Natural administrator.

NAT0964: Subroutine/Function :1: already exists as member :2:.

Text
Subroutine/Function ... already exists as member ....
Explanation
Names of subroutines/functions within a library must be unique.
Action
Choose another name for the subroutine/function.

NAT0965: ConvError returning RESULT parameter :1: (:2: :3:/:4:/:5:/:6:)

Text
Conversion error returning RESULT parameter :1: (:2: :3:/:4:/:5:/:6:)
Explanation
While returning the value of parameter :1:, which was defined with the
attributes BY VALUE RESULT in object :3: (of type :2:, loaded from
library :4: from database :5: file number :6:), a conversion error
has occurred.
Check if the current value complies with the 'Rules for Arithmetic
Assignment' described in the Natural documentation.
Action
Correct error in program.

NAT0966: ConvError assign BY VALUE parameter :1: (:2: :3:/:4:/:5:/:6:)

Text
Convs. error assigning BY VALUE parameter :1: (:2: :3:/:4:/:5:/:6:)
Explanation
During assignment of the value of parameter :1:, which is defined with
the attributes BY VALUE (RESULT) in object :3: (of type :2:, loaded
from library :4: from database :5: file number :6:), a conversion error
has occurred.
Check if the current value complies with the 'Rules for Arithmetic
Assignment' described in the Natural documentation.
Action
Correct error in program.

NAT0967: Function :1: not permitted in current context.

Text
Function ... not permitted in current context.
Explanation
The function indicated is not permitted in a certain context, e.g.
while the 3GL callnat interface, a SEND METHOD or a PARSE is active.
Action
Correct error in program.

NAT0968: Mandatory parameter :1: not specified (:2: :3:/:4:/:5:/:6:)

Text
Mandatory parameter ... not specified (... .../.../.../...)
Explanation
The parameter, which is not specified as optional in the PDA, was
not passed. The called object is described by type, name, database ID,
and file number.
This error can occur also if too few parameters are passed.
Action
Check program(s) and correct the error.

NAT0969: Dynamic parameter :1: mismatch (:2: :3:/:4:/:5:/:6:)

Text
Dynamic parameter ... mismatch (... .../.../.../...)
Explanation
The parameters, which are used by reference, must be either both dynamic
in caller and declaration, or both non-dynamic in both caller and
declaration.
The parameter number is given and the called object is described by
type, name, database ID, and file number.
Action
Check program(s) and correct the error.

NAT0970: Source line limit for program creation is zero.

Text
Source line limit for program creation is zero.
Explanation
When the security authorization for this user in this application was
defined, the user was allowed to create source programs but the limit
for the number of source lines to be created was erroneously set to '0'.
Action
Contact your Natural Security administrator.

NAT0971: Source line limit reached.

Text
Source line limit reached.
Explanation
In the security authorization for this user in this application,
a limit of source lines to be created in new programs has been
defined. The user cannot exceed this limit when creating new
programs.
Action
Either reduce program size or ask your Natural Security administrator
to increase the limit of source lines.

NAT0972: User is not authorized to use this command: :1:.

Text
User is not authorized to use this command: ....
Explanation
In the security authorization for this user in this application,
only specific commands have been made available.
The user is not allowed to use the command specified.
Action
Do not use this command in this environment, or contact your
Natural Security administrator for authorization.

NAT0973: User is not authorized to use this statement.

Text
User is not authorized to use this statement.
Explanation
In the security authorization for this user in this application,
only certain statements have been made available.
The user is not allowed to use the specified statement.
Action
Do not use this statement, or ask your Natural Security administrator
for authorization.

NAT0974: User is not authorized to use this file.

Text
User is not authorized to use this file.
Explanation
In the security authorization for this user in this application,
only certain files have been made available.
The user is not allowed to use the specified file.
Action
Either do not use this file or contact your Natural Security
administrator for authorization.

NAT0975: User is not authorized to update this file.

Text
User is not authorized to update this file.
Explanation
In the security authorization for this user in this application,
only certain files have been made available for updating.
The user is not allowed to update the specified file.
Action
Do not update this file, or contact your Natural Security
administrator for authorization.

NAT0976: Inconsistent security definition for command selection.

Text
Inconsistent security definition for command selection.
Explanation
An inconsistent definition may occur if the Natural administrator
has selected commands on the selection screen in the Natural Security
system that are not defined to the system.
Action
Contact your Natural administrator.

NAT0977: Inconsistent security definition for statement selection.

Text
Inconsistent security definition for statement selection.
Explanation
An inconsistent security definition may occur if the Natural
administrator selects statements that are not defined to the system.
Action
Contact the Natural administrator.

NAT0978: Invalid use of default format definition (N7).

Text
Invalid use of default format definition (N7).
Explanation
Natural Security allows specification of the user characteristics;
one option of these is whether the user is allowed to use the default
format definition (N7).
For this user in this application, the option is not allowed.
Action
You must explicitly specify the format/length of variables.

NAT0979: Specification of the library not allowed.

Text
Specification of the library not allowed.
Explanation
In a security-protected environment, a user may not access a library
by merely specifying the library ID in a command.
The user must properly log on to the library and may then access it.
This protection is also valid in a non-security environment for a
library ID that starts with 'SYS'.
Action
Log on to the desired library and then re-issue the command.

NAT0980: Invalid use of database file number.

Text
Invalid use of database file number.
Explanation
The use of a file number in a database access
statement is not allowed.
Action
Use the view name instead of a file number.

NAT0981: Use of 2-character database short-name field not allowed.

Text
Use of 2-character database short-name field not allowed.
Explanation
A reference to a 2-character database short-name field is not permitted,
1)- when running under Natural Security;
2)- inside the definition of a data-view (DEFINE DATA);
3)- when a DEFINE DATA LOCAL was previously used to define variables;
4)- when the compiler option DBSHORT=OFF is set.
Action
Do not use 2-character database short-name fields.

NAT0982: Internal error; invalid system command requested.

Text
Internal error; invalid system command requested.
Explanation
A system command was requested that requires a Natural program which
is not defined.
Action
Contact your Natural administrator.

NAT0983: Update commands not authorized by Natural Security.

Text
Update commands not authorized by Natural Security.
Explanation
You are not allowed to issue update commands.
Action
Contact your Natural administrator concerning Natural Security
definition/authorization.

NAT0984: This file is not defined in Natural Security.

Text
This file is not defined in Natural Security.
Action
Check program and correct error, or contact your Natural Security
administrator.

NAT0985: Return value not defined in function :1: (:2:/:3:/:4:).

Text
Return value not defined in function ... (.../.../...).
Explanation
A return value is required by the calling object, but not defined in the
called function.

The name of the function, its library, DBID and FNR are indicated
in the error message.
Action
Check program and correct error.

NAT0986: Format/length conflict in return variable (:1:/:2:/:3:/:4:).

Text
Format/length conflict in return variable (.../.../.../...).
Explanation
The return variable specified in the DEFINE PROTOTYPE statement
is defined with a format/length different from that of the
corresponding return variable defined in the called function.

The name of the function, its library, DBID and FNR are indicated
in the error message.
Action
Check program/function and correct error.

NAT0987: Conversion error in BY VALUE variable (:1:/:2:/:3:/:4:).

Text
Conversion error in BY VALUE variable (.../.../.../...).
Explanation
While returning the value of a return variable which is defined with
the attribute BY VALUE in a function, a conversion error has occurred.

Make sure that the value specified in the DEFINE PROTOTYPE statement
matches the 'Rules for arithmetic assignment' described in the Natural
documentation.

The name of the function, its library, DBID and FNR are indicated
in the error message.
Action
Correct error in program.

NAT0988: Dynamic return variable mismatch (:1:/:2:/:3:/:4:).

Text
Dynamic return variable mismatch (.../.../.../...).
Explanation
A return variable which is used by reference must be either dynamic
in both the DEFINE PROTOTYPE statement and the function declaration,
or non-dynamic in both the DEFINE PROTOTYPE statement and the function
declaration.

The name of the function, its library, DBID and FNR are indicated
in the error message.
Action
Check program/function and correct error.

NAT0989: Parameter format not allowed for call from 3GL.

Text
Parameter format not allowed for call from 3GL.
Explanation
A Natural subprogram which is invoked from a third-generation
language like Cobol, PL/I, or C, cannot use parameters
defined as DYNAMIC variable, X-array, or variable array (1:V).
Action
In a Natural subprogram to be invoked from a 3GL,
define as parameters only static variables and arrays with fixed index
bounds.

NAT0997: Invalid format buffer for STORE/UPDATE statement.

Text
Invalid format buffer for STORE/UPDATE statement.
Explanation
Natural has detected a format buffer for a STORE/UPDATE statement
with a length of zero. This is invalid.
Action
Check program and correct error.

NAT0998: Internal error :1:.

Text
Internal error ....
Action
Contact your Natural administrator.

NAT0999: Internal error.

Text
Internal error.
Action
Contact your Natural administrator.

NAT1000: FIND set name not found in RETAIN table.

Text
FIND set name not found in RETAIN table.
Explanation
A reference was made to a set name which had not been placed in
the FIND set table by a FIND ... RETAIN statement.
Action
Enter correct set name.