Natural System Error Messages 0250-0299

#### Search Results

Search

# Natural System Error Messages 0250-0299

#### NAT0250: Error in GIVING clause of Natural "PROCESS" statement.

    Text
    Error in GIVING clause of Natural "PROCESS" statement.
    Action
    Check program and correct error.

#### NAT0251: File/DDM not defined for PROCESS statement.

    Text
    File/DDM not defined for PROCESS statement.
    Action
    Check program and correct error.

#### NAT0252: Library must not be specified in security environment.

    Text
    Library must not be specified in security environment.
    Explanation
    In an environment which is protected by Natural Security,
    the specification of a library is not possible.
    Action
    Do not specify a library.

#### NAT0253: Statement not allowed for Db2 access.

    Text
    Statement not allowed for Db2 access.
    Explanation
    The following statements and constructions are not supported by Db2:
    1. FIND UNIQUE
    2. FIND COUPLED
    3. FIND FIRST
    4. FIND ... RETAIN AS
    5. GET
    6. any reference to *ISN
    7. END TRANSACTION within an open database loop
    8. BACKOUT TRANSACTION within an open database loop
    Action
    Correct error in program.

#### NAT0254: Receiving field of VAL function has invalid format.

    Text
    Receiving field of VAL function has invalid format.
    Explanation
    The VAL function extracts a numeric value from an alphanumeric or
    Unicode field. The content of the field must be the character
    representation of a numeric value. Leading or trailing blanks are
    permitted. Decimal character and leading sign character will be
    processed. The result can be assigned to a field of format Packed,
    Numeric, Floating, Integer, Date or Time.
    Action
    Do not assign the result of the VAL function to a field with a format
    other than P/N/F/I/D/T.

#### NAT0255: General syntax error detected in program.

    Text
    General syntax error detected in program.
    Explanation
    A general syntax error was detected while syntax checking a source
    program.
    This message is output for various miscellaneous syntax errors
    for which Natural does not provide specific error messages.
    Action
    Check program and correct error.

#### NAT0256: Invalid entry in command line.

    Text
    Invalid entry in command line.
    Explanation
    The structure of the command does not require the parameters that
    have been specified in the command line.
    Natural checks that the parameter specification agrees with the
    parameter structure expected by the individual command.
    Another reason for this error is that ADHOC is missing in batch mode.
    Action
    Check command structure and resubmit.

#### NAT0257: Only operators "EQUAL", "NOTEQUAL" valid with MASK/SCAN.

    Text
    Only operators "EQUAL", "NOTEQUAL" valid with MASK/SCAN.
    Explanation
    It is not possible to evaluate the operators GREATER or LESS THAN for
    a value when only certain positions are included in the comparison.
    Therefore, the only logical operator that are allowed with the special
    compare function MASK and SCAN are "EQUAL" and "NOTEQUAL".
    Action
    Restructure the logical criteria to only use operators "EQUAL"
    or "NOTEQUAL" with the functions MASK and SCAN.

#### NAT0258: Incorrect MASK argument construction.

    Text
    Incorrect MASK argument construction.
    Explanation
    The mask value must be enclosed in parentheses and may only
    contain the elements as described in the Natural
    documentation; see also extended error message NAT0017.
    Action
    Check program and correct error.

#### NAT0259: Invalid MASK construction for date check.

    Text
    Invalid MASK construction for date check.
    Explanation
    When a date check is to be performed, the specification for
    month/day/year must be 2 characters each (MM/DD/YY);
    for year, 4 characters (YYYY) may also be used.
    Action
    Check program and correct error.

#### NAT0260: Error in text list construction; contact administrator.

    Text
    Error in text list construction; contact administrator.
    Explanation
    A discrepancy was detected in the number of alternative entries
    in the text list and the syntax list.
    The error is caused by an invalid modification of the text list.
    New entries can only be inserted in the text list by using the
    macro CSYN for synonym, not the macro CALT for alternative.
    Action
    Retain the keyword on which the error has been detected
    and contact your Natural administrator.

#### NAT0261: END statement missing.

    Text
    END statement missing.
    Explanation
    The last statement of a Natural program must always be END.
    Alternatively, a period "." may be used.
    Action
    Check program and correct error.

#### NAT0262: Incorrect number of digits, or value out of range.

    Text
    Incorrect number of digits, or value out of range.
    Explanation
    For a field of format N or P, the overall maximum number
    of digits is 29, and the maximum number of digits after
    the decimal point is 29.
    For a field of format F, the value specified must be in the range of
    values as described in the Natural documentation on
    floating-point constants.
    Action
    Correct error in program.

#### NAT0263: Invalid MASK construction for range check.

    Text
    Invalid MASK construction for range check.
    Explanation
    If a range check is to be performed, both values for the supplied
    range must have the same number of positions.
    Leading zeros must be supplied, as it is a check for positions in
    the value and the number of digits supplied in the range value.
    The number of positions to be included in the range check must also
    be specified.
    Action
    Check program and correct error.

#### NAT0264: Length of alphanumeric or unicode constant is zero.

    Text
    Length of alphanumeric or unicode constant is zero.
    Explanation
    The length of an alphanumeric or unicode constant must be
    greater than zero.
    Action
    Check program and correct error.

#### NAT0265: Error in hexadecimal constant: :1:.

    Text
    Error in hexadecimal constant: ....
    Explanation
    1) Invalid hexadecimal character found.
       A hexadecimal constant may consist only of characters 0-9 or A-F.
    2) Invalid number of characters specified.
       - The hexadecimal notation for constants of format A (H"..") requires
         2 characters to represent one byte. Therefore, the number of
         hexadecimal characters supplied must be a multiple of 2.
       - The hexadecimal notation for constants of format U (UH"..")
         requires 4 characters to represent one Unicode code unit.
         Therefore, the number of hexadecimal characters supplied must be a
         multiple of 4.
    Action
    Correct error.

#### NAT0266: Number of bytes defined by hexadecimal constant > 80.

    Text
    Number of bytes defined by hexadecimal constant > 80.
    Explanation
    Hexadecimal constants are converted to internal byte representation
    in an intermediate buffer of 80 bytes.
    If literal constants of more than 80 bytes internal representation
    are to be defined, use the notation "XXXXXX"-"XXXXXX" to enter
    the value in multiple segments.
    Action
    Check program and correct error.

#### NAT0267: Invalid file specification in COUPLED clause.

    Text
    Invalid file specification in COUPLED clause.
    Explanation
    The file specified in a COUPLED clause must be an Adabas file which has
    been physically coupled using the appropriate Adabas utility program.
    The file must not be a logical Natural system file.
    Action
    Check program and correct error;
    or contact your Natural administrator about the file status.

#### NAT0268: Invalid format/length for database count variable.

    Text
    Invalid format/length for database count variable.
    Explanation
    The format of the count variable for a periodic-group name or
    multiple-value field must be N or P.
    No decimal digits are permitted.
    Action
    Check program and correct error.

#### NAT0269: Invalid descriptor in SORTED BY clause.

    Text
    Invalid descriptor in SORTED BY clause.
    Explanation
    The descriptor specified in the SORTED BY clause cannot be within
    a periodic group. If the descriptor is a multiple-value field, an
    index value must not be used.
    Action
    Check program and correct error.

#### NAT0270: Invalid use of variable index notation.

    Text
    Invalid use of variable index notation.
    Explanation
    1. Variable index notation is not permitted with a
       search variable in the WITH clause of a FIND statement.
    2. A variable array index (1:V) must not be used for redefine fields.
    Action
    Check program and correct error.

#### NAT0271: Page width (line size) exceeded in DISPLAY statement.

    Text
    Page width (line size) exceeded in DISPLAY statement.
    Explanation
    The total number of positions required for all columns
    resulting from a DISPLAY statement must not exceed the
    logical page size.
    Action
    Reduce number of fields being displayed, or reduce spacing between
    columns, or increase the logical page size (where applicable), or
    place multiple values vertically in the same column.

#### NAT0272: Invalid value format or incompatible field format.

    Text
    Invalid value format or incompatible field format.
    Explanation
    In a SCAN condition, the
    - format of the value to be scanned for must be "A", "B" or "U";
    - format of the field to be scanned must be "A", "N", "P" or "U";
    - length of the value must be less than the length of the field.
    In a MASK condition, the
    - format of the field to be tested must be "A", "N", "P" or "U";
    - format combination of first and second operand must be compatible;
    - first operand must not be smaller than the mask.
    Action
    Check program and correct error.

#### NAT0273: Error :1: in line :2: of data area :3: processing :4:.

    Text
    Error ... in line ... of data area ... processing ....
    Explanation
    As indicated in the error message, an error has occurred in a
    specific line of a data area while processing a variable.
    Action
    Correct error in data area.

#### NAT0274: Error :1: in line :2: of copycode :3: processing :4:.

    Text
    Error ... in line ... of copycode ... processing ....
    Explanation
    As indicated in the error message, an error has occurred in a
    specific line of a copycode while processing a variable.
    Action
    Correct error in copycode.

#### NAT0275: RETRY statement only allowed in ON ERROR statement block.

    Text
    RETRY statement only allowed in ON ERROR statement block.
    Explanation
    The RETRY statement can only be used as a response to error NAT3145,
    which indicates that a record to be read for update is currently
    in "hold" status for another user.
    Action
    Check program and correct error.

#### NAT0276: Invalid reference to count of field in periodic group.

    Text
    Invalid reference to count of field in periodic group.
    Explanation
    When referencing the count of the number of occurrences of an
    elementary field within a periodic group, the name of the periodic
    group must be used, not the name of the elementary field.
    Action
    Check program and correct error.

#### NAT0277: A global variable must not redefine another variable.

    Text
    A global variable must not redefine another variable.
    Explanation
    For reasons of addressability, parameter variables must not be defined
    by redefining an already existing variable.
    Action
    Check program and correct error.

#### NAT0278: Value to be used in SET CONTROL must be format "A".

    Text
    Value to be used in SET CONTROL must be format "A".
    Explanation
    The value (constant or variable) used to specify a terminal
    command with a SET CONTROL statement must be alphanumeric.
    Action
    Check program and correct error.

#### NAT0279: Count requested for a non-array field.

    Text
    Count requested for a non-array field.
    Explanation
    The count field only exists for database fields that are defined
    as multiple-value fields, periodic groups, or multiple-value fields
    within a periodic group.
    If the count of a multiple-value field within a periodic group is to be
    accessed, an index must be specified to indicate the occurrence of the
    multiple-value field in the periodic group for which the count is being
    requested.
    The field for which you have requested a count of occurrences is
    neither a multiple-value field nor a periodic group.
    Action
    Check program and correct error.

#### NAT0280: Index entry incorrectly specified for field.

    Text
    Index entry incorrectly specified for field.
    Explanation
    An index was specified for a variable for which indexing is not
    permitted.
    Index specifications may only be used when defining/referencing an
    array. A database array can only be defined for a multiple-value field
    and for fields within a periodic group. If used as a search-variable in
    the WITH clause of a FIND statement, a multiple-value field must not be
    supplied with an index.
    When referencing an array, an index range specification was detected
    which exceeds the index range defined for one of its dimensions.
    Action
    Check program and correct error.

#### NAT0281: Index entry missing or invalid for an array.

    Text
    Index entry missing or invalid for an array.
    Explanation
    When a multiple-value field or a field within a periodic group is
    referenced, an index must be specified to indicate the occurrence of
    the value to be selected.
    Default indices are created in WRITE or DISPLAY statements based on
    the setting of the session parameters MC and PC.
    A variable to be used as a variable index must have been previously
    defined before it can be used as an index notation.
    If a non-database field has been defined as an array, an index for
    each dimension must be specified when referencing the field.
    Action
    Check program and correct error.

#### NAT0282: Only one index/range specification allowed.

    Text
    Only one index/range specification allowed.
    Explanation
    For multiple-value fields, or fields within a periodic group,
    only one index or range of indices may be specified.
    Two indices are only allowed for multiple-value fields within
    a periodic group.
    Action
    Check program and correct error.

#### NAT0283: Field or variable :1: defined more than once.

    Text
    Field or variable ... defined more than once.
    Explanation
    If DEFINE DATA is used:
    A variable declared on level 1 must not be defined a second time,
    neither on level 1 nor on any other level.
    Without DEFINE DATA:
    A variable or database field can only be defined once using a
    format/length specification. When the variable is referenced in the
    program, no further format/length specification is possible.
    If the first field definition was made in a data area (LDA,GDA)
    which was included with a "DEFINE DATA .. USING .." statement, a further
    message (NAT0297) is put on the error stack, which indicates the data
    area name, the library and DB/FNR from which the field was included
    first. This message can be displayed with the system command LASTMSG.
    Action
    Check program and correct error.

#### NAT0285: Field reference error; reference invalid or missing.

    Text
    Field reference error; reference invalid or missing.
    Explanation
    Probable reasons for this error message:
    - You mistyped the variable name.
    - The variable name you specified has not yet been declared.
    - A specific database reference has been supplied, but the field is
      not present in the file referenced.
    - The value of a Natural system function has been referenced in the
      form *FUNCTION(FIELD), but no evaluation of the referenced system
      function has occurred for the field.
    Action
    Check program and correct error.

#### NAT0286: Invalid use of function, system function or sys. variable.

    Text
    Invalid use of function, system function or sys. variable.
    Explanation
    - Natural system functions and Natural system variables may only
      be used in a specific statement syntax within a Natural program.
    - The value of a system function or system variable may be assigned
      to a variable and then referenced.
    - In an INPUT statement, most system functions can only be used as
      output fields, but not as input fields.
    - The only system variable that can be used as an argument in the
      system function POS is *COM.
    - A Natural function call is not allowed in this context.
    For further information on Natural functions, Natural system functions
    or Natural system variables, see the Natural documentation.
    Action
    Correct error in program.

#### NAT0287: No access to database field; or REDEFINE variable exists.

    Text
    No access to database field; or REDEFINE variable exists.
    Explanation
    Either the access to a database field is not possible at this point;
    or a variable to be used in a REDEFINE statement has previously been
    defined.
    A database field can only be referenced within an active processing
    loop. If the loop has been closed, a reference to fields from that
    database access is no longer possible. If you wish to use a value of
    a database field outside an active processing loop, assign the value
    to a user-defined variable.
    This error also occurs if a 4-digit array occurrence is incorrectly
    specified. 4-digit array occurrences must be preceded by a slash;
    for example, #ARRAY(/1000), not #ARRAY(1000).
    Action
    Correct error in program.

#### NAT0288: Index/format not permitted in Natural system function.

    Text
    Index/format not permitted in Natural system function.
    Explanation
    Format or length must not be specified for the reference to a Natural
    system function that had been previously evaluated nor for the reference
    to a Natural system variable.
    Action
    Check program and correct error.

#### NAT0289: Referenced field is not a descriptor.

    Text
    Referenced field is not a descriptor.
    Explanation
    The reference to a database field at this point requires that the
    field is a descriptor.
    Descriptors are required in the WITH clause of a FIND statement, as
    sequence fields in a READ LOGICAL statement, or when indicating the
    field for which values are to be provided in a HISTOGRAM statement.
    Action
    Correct error in program.

#### NAT0290: Sub/super/hyper/phonetic descriptor field improperly used.

    Text
    Sub/super/hyper/phonetic descriptor field improperly used.
    Explanation
    A sub/superfield or sub/superdescriptor may be read from the database
    with an access statement (READ, FIND, HISTOGRAM, GET), but cannot be
    referenced in an update statement (STORE, UPDATE).
    The value for a hyper- and phonetic descriptor can only be used in a
    search criterion, but cannot be read from the database.
    Action
    Correct error in program.

#### NAT0291: Format for database field incompatible.

    Text
    Format for database field incompatible.
    Explanation
    The format used for a database field is not compatible with the
    format of the field as defined in the data dictionary.
    Action
    Check program and correct error.

#### NAT0292: Requested field is not integer or has invalid length.

    Text
    Requested field is not integer or has invalid length.
    Explanation
    The operation requires the value of an integer field. This can be an
    integer constant, or a user-defined variable or database field of
    integer format.
    This error occurs if:
    - the field is of a format other than integer, or
    - the length of the field is not valid.
    Action
    Use an integer format/length valid for the operand.

#### NAT0293: Index range entry specified where not allowed.

    Text
    Index range entry specified where not allowed.
    Explanation
    A single index entry is required for this type of function; an index
    range is not permitted.
    Single index entries are required, for example, in the WITH clause
    of a FIND statement to indicate a specific occurrence of a periodic
    group field, or to specify the descriptor to be used for sequence
    control in a READ LOGICAL statement.
    Action
    Check program and correct error.

#### NAT0294: Intermediate storage overflow in arithmetic statement.

    Text
    Intermediate storage overflow in arithmetic statement.
    Explanation
    An overflow of an internal stack has occurred during the evaluation
    of an arithmetic expression.
    The internal stack is used to sequence the execution of arithmetic
    operations according to the parenthetical structure.
    Action
    Reduce the number of operations to be performed within a single
    arithmetic operation.

#### NAT0295: Operand in arithmetic statement is not numeric.

    Text
    Operand in arithmetic statement is not numeric.
    Explanation
    Only operands of format "N" (numeric unpacked) or "P" (packed numeric)
    are allowed in arithmetic expression. A numeric operand can be defined
    as a constant or as the content of a variable.
    Action
    Check program and correct error.

#### NAT0296: Invalid search criteria in FIND statement.

    Text
    Invalid search criteria in FIND statement.
    Explanation
    When evaluating complex search criteria, such as one with logical
    operator "OR", several separate database calls may be required.
    For a single FIND statement, a maximum of 64 database calls can be
    generated internally.
    Action
    Reduce the number of search criteria.

#### NAT0297: Field :1: previously defined in (:2:/:3:/:4:/:5:).

    Text
    Field :1: previously defined in (:2:/:3:/:4:/:5:).
    Explanation
    The variable :1: was declared twice. The first definition of the field
    was included via data area :2:, which was loaded from library :3:,
    database :4:, file number :5:.
    Action
    Correct error in program.

#### NAT0298: Incorrect parameters specified in SET KEY statement.

    Text
    Incorrect parameters specified in SET KEY statement.
    Explanation
    A push-button (PB=), menu (ME=), or bitmap (BM=) clause
    was detected in a SET KEY statement, but the corresponding
    parameters were incorrectly specified.
    Action
    See the Natural documentation for detailed information.

#### NAT0299: Total length of intermediate result exceeds 31 digits.

    Text
    Total length of intermediate result exceeds 31 digits.
    Explanation
    Natural supports operands up to a length of 31 digits.
    The length of intermediate results as operands is evaluated
    according to the rules for arithmetic operations.
    See the Natural documentation for details.
    Action
    Check the digits of intermediate results according to the rules.
    Separate the arithmetic expression into several statements using
    explicit intermediate results.