Version 4.2.6 for Mainframes (Update)
 —  Messages and Codes  —

Natural System Error Messages 3951-4000

NAT3951: CSECT :1: is missing.

Text CSECT ... is missing.
Expl. This error may be caused by one of the following:
- The module indicated in the message is missing in the link-edit
stream.
- The CSECT instruction is missing in the source of the module.
- The module name in the CSECT instruction has been changed.
Actn. Make sure that the module is included in the link-edit stream;
make sure that the source of the module is complete/correct.

NAT3952: INIT call failed with status code :1:.

Text INIT call failed with status code ....
Expl. The Natural DL/I initialization routine issues an INIT call to
inform IMS/TM that it is prepared to accept status codes "BA" and "BB"
regarding the unavailability of data.
This call failed, and DL/I has returned the status code indicated
in the message.
Actn. Refer to the respective IBM documentation for a detailed explanation
of the status code.

NAT3953: Versions of NDLNUC and :1: do not match.

Text Versions of NDLNUC and ... do not match.
Expl. The modules included in the Natural DL/I link-edit must be
of the same version.
Module name: NDLSINIT
Actn. Check NDLNUC, NDLSIO00 and NDLPARM.

NAT3954: DLISIZE must be greater than :1:.

Text DLISIZE must be greater than ....
Expl. If DLISIZE is not "0", it must be large enough to hold all buffers
that are required by Natural for DL/I.
Actn. Set DLISIZE to the value indicated in the error message.

NAT3955: Error :1: in GETMAIN in Natural for DL/I buffer.

Text Error ... in GETMAIN in Natural for DL/I buffer.
Expl. An error occurred when Natural for DL/I attempted to acquire
its buffer from the thread.
Actn. Increase the size of the thread.

NAT3956: Error :1: in GETMAIN in Natural for DL/I subpool :2:.

Text Error ... in GETMAIN in Natural for DL/I subpool ....
Expl. An error occurred when Natural for DL/I attempted to acquire
the subpool (as indicated in the error message) from its buffer.
Actn. Contact Software AG support.

NAT3957: No DBID marked as DL/I in NTDB macro.

Text No DBID marked as DL/I in NTDB macro.
Expl. Natural for DL/I has been invoked, but in the NTDB macro
no database has been reserved for DL/I.
Actn. If you do not wish to invoke Natural for DL/I, invoke Natural
with DLISIZE=0; otherwise correct error in NTDB macro.

NAT3959: XRST call failed with DL/I status code :1:.

Text XRST call failed with DL/I status code ....
Expl. When starting a BMP, the Natural DL/I initialization routine issues
an extended restart (XRST) call.
This call failed, and DL/I returned the status code indicated in the
message.
Actn. Refer to the respective IBM documentation for a detailed explanation
of the status code.

NAT3960: No valid PSB name was provided.

Text No valid PSB name was provided.
Expl. The address pointing to the PCB address list is blank or zero.
This happens if a DLISIZE other than zero has been specified and
1) Natural is not running under the control of the DL/I region
controller (DFSRRC00 for z/OS, DLZRRC00 for z/VSE); or
2) Natural is running under control of the DL/I region controller,
but, due to an internal error, the PCB address list has not been
passed to Natural for DL/I; or
3) the PSB name in the JCL does not match the PSB name on CMSYNIN.
Module name: NDLSINIT.
Problem determination: Check the JCL used to start Natural.
Actn. For 1: Run Natural under the control of the DL/I region controller,
or run Natural with DLISIZE=0. For 2: Contact Software AG support.
For 3: Correct the PSB name in the JCL or in CMSYNIN.

NAT3961: NSB :1: not found on FDIC system file.

Text NSB ... not found on FDIC system file.
Expl. The PSB which is used to start Natural has not been defined on
the FDIC system file or could not be read (due to an unexpected
return code from the database).
Module name: NDLSINIT.
Problem determination: Check if the correct system file has been
assigned.
Actn. Specify correct FDIC, or run NATPSB procedure to store the NSB on the
FDIC system file. Set DLISIZE=0 if you do not want an NSB associated
with the transaction (because it does not need to access DL/I).

NAT3962: Error in loading global area.

Text Error in loading global area.
Expl. The NDPSGLBA module is not included the link step; therefore it
cannot be loaded dynamically.
Module name: NDPSGLBA
Problem determination: Obtain a link-edit listing.
Actn. Either include NDPSGLBA in the link step (batch and CICS) or
specify it in the STEPLIB DD card (IMS/TM).

NAT3963: Natural for DL/I initialization failed.

Text Natural for DL/I initialization failed.
Expl. The reason for this failure is explained by the more detailed
error message issued together with this error message.
Actn. See explanation of detailed message.

NAT3970: Error when loading NDB/NSB.

Text Error when loading NDB/NSB.
Expl. The NDB, or the NSB, could not be loaded from the load library
(under z/VSE, from the core image library).
Module names: NDLBINDB, NDLBINSB.
Problem determination: Item 11 or Item 12.
Actn. 1. Check whether the load (core) library contains the NDB/NSB.
2. Check the results of the assembly and link steps of the
NATDBD/NATPSB procedures which produce the above modules.

NAT3971: Error in END TRANSACTION command.

Text Error in END TRANSACTION command.
Expl. Due to an error when issuing the "ET" command, the NDB (or the NSB)
could not be stored into the Natural system file.
The message "SYSDLI: 1004" contains the I/O response code received
from the Natural I/O processor.
The I/O codes are described in the Adabas or Natural documentation
respectively.
Module names: NDPBNDB1, NDPBNSB1.
Problem determination: Item 11 or Item 12.
Actn. Contact your database administrator.

NAT3972: DBD has too many (over 468) DL/I fields.

Text DBD has too many (over 468) DL/I fields.
Expl. A DBD with more than 468 (13 * (26 + 10)) DL/I fields cannot
be processed. This is a design restriction.
Module name: NDPBSESH
Problem determination: Items 4, 11.
Actn. Reduce the number of DL/I fields.

NAT3973: Error in acquiring a work area (storing NDB/NSB).

Text Error in acquiring a work area (storing NDB/NSB).
Expl. An error message was returned by the GETMAIN/GETVIS macro after
Natural DL/I attempted to acquire a work area while processing
a logical DBD.
Module name: NDPBNDB1
Problem determination: Item 11.
Actn. Increase the partition/region size.

NAT3974: Error when storing the NDB/NSB.

Text Error when storing the NDB/NSB.
Expl. During the STORE operation of an NDB/NSB, an error message
was returned either by the Adabas "N1" command or by a VSAM "PUT".
The error message "SYSDLI: 1103" contains the I/O response code
received from the Natural I/O processor.
The I/O codes are described in the Adabas or Natural documentation
respectively.
Module names: NDLBSNDB, NDLBSNSB.
Problem determination: Item 11.
Actn. Correct the condition that caused the I/O error.

NAT3975: DBD/PSB name does not match the load module name.

Text DBD/PSB name does not match the load module name.
Expl. The NAME parameter in the DBD/PSB macro does not match the load
module name in the load (in z/VSE, core) library which contains
the output of the assembly and link steps of the NATDBD/NATPSB
procedure.
Module names: NDLBINDB, NDLBINSB.
Problem determination: Items 4/5, 11/12.
Actn. Check the name of the load module containing the output of the assembly
step of the NATDBD/NATPSB procedure; change it accordingly to match
the NAME parameter. Ensure that SAG macros are used during the assembly.

NAT3978: NDB not found.

Text NDB not found.
Expl. Internal error.
Module name: NDPBRNDB
Problem determination: Items 1 (trace parameter = (CMD,REQ,SER)), 11.
Actn. Contact Software AG support.

NAT3979: Error in acquiring a work area.

Text Error in acquiring a work area.
Expl. An error message was received from the GETMAIN/GETVIS macro
while acquiring the I/O area into which the first slot of the
old copy of the NDB being processed was to be read.
Module name: NDPBRNDB
Problem determination: Item 11.
Actn. Increase the partition/region size.

NAT3980: Error in acquiring a work area.

Text Error in acquiring a work area.
Expl. An error message was received from the GETMAIN/GETVIS macro
while acquiring the I/O area into which the old copy of the
NDB being processed was to be read.
Module name: NDPBRNDB
Problem determination: Item 11 or item 12.
Actn. Increase the partition/region size.

NAT3981: Error in reading an NDB.

Text Error in reading an NDB.
Expl. The new NDB copy could not be stored on the Natural system
file due to an error which occurred while reading the old copy.
The error message "SYSDLI: 1004" contains the I/O response
code received from the Natural I/O processor.
The I/O codes are described in the Adabas or Natural documentation
respectively.
Module name: NDPBRNDB
Problem determination: Item 11.
Actn. Correct the condition that caused the I/O error.

NAT3982: Error in reading an NDB.

Text Error in reading an NDB.
Expl. The new NDB copy could not be stored on the Natural system
file due to an error which occurred while reading the old copy.
The error message "SYSDLI: 1004" contains the I/O response
code received from the Natural I/O processor.
The I/O codes are described in the Adabas or Natural documentation
respectively.
Module name: NDPBRNDB
Problem determination: Item 11.
Actn. Correct the condition that caused the I/O error.

NAT3983: Error in reading an NDB.

Text Error in reading an NDB.
Expl. An error occurred while the old copy of an existing NDB
(or NSB) was being read for update. The error message
"SYSDLI: 1004" contains the I/O response code received
from the Natural I/O processor.
The I/O codes are described in the Adabas or Natural documentation
respectively.
Module names: NDPBDNDB, NDPBDNSB.
Problem determination: Item 11 or item 12.
Actn. Correct the condition that caused the I/O error.

NAT3984: Error in reading an NDB.

Text Error in reading an NDB.
Expl. An error occurred while the old copy of an existing NDB
(or NSB) was being read for update. The error message
"SYSDLI: 1004" contains the I/O response code received
from the Natural I/O processor.
The I/O codes are described in the Adabas or Natural documentation
respectively.
Module names: NDPBDNDB, NDPBDNSB.
Problem determination: Item 11 or item 12.
Actn. Correct the condition that caused the I/O error.

NAT3985: Error in deleting an NDB.

Text Error in deleting an NDB.
Expl. An error occurred while the old copy of an NDB was being
deleted. The error message "SYSDLI: 1004" contains the
I/O response code received from the Natural I/O processor.
The I/O codes are described in the Adabas or Natural documentation
respectively.
Module name: NDPBDNDB
Problem determination: Item 11.
Actn. Correct the condition that caused the I/O error.

NAT3986: NDB/NSB not found.

Text NDB/NSB not found.
Expl. This error occurs when an NDB (or NSB) is being read for update
before being deleted. The error is originated by the "L3" command
(Adabas system file) or by the VSAM GET (VSAM system file).
The error message "SYSDLI: 1004" contains the I/O response code
received from the Natural I/O processor.
The I/O codes are described in the Adabas or Natural documentation
respectively.
Module names: NDPBDNDB, NDPBDNSB.
Problem determination: Item 11 or item 12.
Actn. Correct the condition that caused the I/O error.

NAT3987: Error in building a logical NDB.

Text Error in building a logical NDB.
Expl. The work area used for building a logical NDB is too small.
Module name: NDPBNDBL
Problem determination: Item 11.
Actn. Contact Software AG support.
Software AG will change YLOG in NDPBNDB1 and relink NDLB0001.

NAT3988: Sequence-field error in building a logical NDB.

Text Sequence-field error in building a logical NDB.
Expl. More than one sequence field was found for a segment which
is NOT a logical virtual child.
Up to five sequence fields may be defined ONLY for logical
virtual child segments.
Module name: NDPBNDBL
Problem determination: Items 4, 11.
Actn. Ensure that the DBDGEN procedure was successfully executed
for this DBD, as this error should be detected by DBDGEN.

NAT3989: Error in building AIX links in a logical NDB.

Text Error in building AIX links in a logical NDB.
Expl. Internal error.
Module name: NDPBNDBL
Problem determination: Items 4, 11.
Actn. Contact Software AG support.

NAT3990: Error in acquiring a work area for a logical NDB.

Text Error in acquiring a work area for a logical NDB.
Expl. A GETMAIN/GETVIS macro was invoked to acquire a work area where a
logical NDB was to be built. A non-zero response code was returned.
Module name: NDPBNDB1
Problem determination: Item 11.
Actn. Increase the partition/region size.

NAT3991: Segment referred to as source was not found.

Text Segment referred to as source was not found.
Expl. While processing a segment with a SOURCE parameter, the
specified segment was not found in the NDB corresponding to
the DBD specified in the SOURCE keyword.
Module name: NDPBNDBL
Problem determination: Item 11.
Actn. Ensure that the ACBGEN procedure was successfully executed
for this DBD, as this error should be detected by ACBGEN.

NAT3992: Error in acquiring a work area for a logical NDB.

Text Error in acquiring a work area for a logical NDB.
Expl. A GETMAIN/GETVIS macro was invoked to acquire a work area where a
logical NDB was to be built. A non-zero response code was returned.
Module name: NDPBNDB1
Problem determination: Item 11.
Actn. Increase the partition/region size.

NAT3993: NDB not found in Natural system file.

Text NDB not found in Natural system file.
Expl. While processing a segment with a SOURCE parameter, the NDB
corresponding to the DBD specified in the SOURCE keyword was
not found in the Natural system file.
Module name: NDPBNDBL
Problem determination: Item 11.
Actn. Ensure that the DBDGEN procedure was successfully executed
for this DBD, as this error should be detected by DBDGEN.

NAT3994: Inhibit flag of segment in "SOURCE" keyword set to "ON".

Text Inhibit flag of segment in "SOURCE" keyword set to "ON".
Expl. The procedure NATDBD is executed for a logical DBD. This
DBD contains a SOURCE=((segname,,dbname)) statement to
identify segment type "segname" in physical database "dbname".
However, the NDB corresponding to "dbname" contains one or more
segment types which are marked as inhibited. These segment types
were inhibited by Natural during the execution of NATDBD against
"dbname" because not all references to the real logical child
segment type could be resolved.
Module name: NDPBNDBL
Problem determination: Item 11.
Actn. Before executing NATDBD for a logical DBD, execute NATDBD for all
physical DBDs referred to. If the logical relationship is the result of
a recursive structure, run NATDBD for the physical DBD at least twice.

NAT3995: Overflow of source error table.

Text Overflow of source error table.
Expl. The table which contains the list of segments with an error flag
is too small.
Module name: NDPBNDBL
Problem determination: Item 4.
Actn. Contact Software AG support.

NAT3996: Physical NDB referenced as source was not found.

Text Physical NDB referenced as source was not found.
Expl. While processing a segment with a SOURCE parameter, the NDB
corresponding to the DBD specified in the SOURCE keyword was not found
in the Natural system file. (The NDB has been stored in the Natural
system file with some segments having the inhibit flag set to "ON".)
Module name: NDPBNDBL
Problem determination: Item 4.
Actn. Re-execute the NATDBD procedure.
For details, see the section on logical databases in the Natural DL/I
documentation.

NAT3997: Error when scanning NSB (CMPAT=YES).

Text Error when scanning NSB (CMPAT=YES).
Expl. Module name: NDPBNSB1
Actn. Check the PSB definition.

NAT3998: Natural nucleus not found.

Text Natural nucleus not found.
Expl. When running NDL batch under z/VSE, NDLSINID tries to load
the Natural phase whose name has been specified in the JCL.
This phase was not found.
Module name: NDLSINID
Actn. Check the name of the Natural phase in the JCL.

NAT3999: Not enough memory to load Natural nucleus.

Text Not enough memory to load Natural nucleus.
Expl. When running NDL batch under z/VSE, NDLSINID tries to load the
Natural phase whose name has been specified in the JCL.
This phase could not be loaded, because there was not enough memory
available.
Module name: NDLSINID
Actn. Check the size of the Natural batch phase, and specify the SIZE
parameter in the JCL accordingly.

NAT4000: Natural error text 4nnn cannot be displayed.

Text Natural error text 4nnn cannot be displayed.
Expl. For error NAT4nnn, there is no specific error message available.

Top of page