Natural Exit Codes

There are two types of Natural exit codes:

  • Startup errors, where exit codes 0 and 1 indicate success and all other exit codes indicate errors.

  • Errors generated by the TERMINATE statement, where exit codes 0 to 255 are possible.


Natural Startup Errors

The following exit codes may occur when starting Natural Studio.

2 Terminal Control String (TCS) capability specified in SAGtermcap or Environment Variable NATTCHARSET.
3 Failed to initialize character conversion table.
4 Error in character conversion file NATCONV.INI.
5 Unable to read database assignments from global configuration file NATCONF.CFG.
6 Unable to find FNAT(dbid,fnr) or FUSER(dbid,fnr). Check your configuration files.
7 Cannot initialize LFILE table.
10 Obsolete.
11 Obsolete.
12 Unable to read specified parameter file. Please verify the parameter file.
13 Unable to read parameter file NATPARM.
14 Storage manager initialization failed.
15 End of input file (EOF) encountered while reading from STDIN.
16 Unable to open buffer pool; contact the Natural system administrator.
17 Unable to read buffer pool assignments from NATURAL.INI file.
18 Invalid FDIC assignment.
19 Invalid FNAT assignment.
20 Invalid FSEC assignment.
21 Invalid FUSER assignment.
22 Unable to load Natural login module.
23 Unable to allocate memory for local data. Reduce USIZE and/or SSIZE parameter.
24 Unable to load Natural display module.
25,26 Error loading shareable image or DLL.
28 Security violation during start of Natural. Natural terminates.
31 NAT0866 Your Natural nucleus is not a Natural Security nucleus.
33 Lock manager cannot create/initialize semaphores.
34 No library is accessible or present in specified FNAT/FUSER. Check system file assignments and file attributes of FNAT and FUSER (directories and files).
35 Internal wfc i/o terminal driver error.
36 Internal XVT error.
37 DCOM Startup error.
38 Creation of runtime context failed.
39 Unable to find NATDIR and/or NATVERS environment variable. If you have set the NATDIR environment variable, please check that it does not contain invalid or whitespace characters! NATVERS should only contain the Natural version. The path must contain a valid drive ID.
40 Natural zmodem error.
41 Creation of TF table failed because there are entries with different database types from older parameter module. Check parameter module with Natural Configuration Utility.
42 Batch mode driver error.
43 Screen window size is too small.
44 Exit from SQL signal handler.
46 Unable to access FNAT library SYSLIB. Insufficient privilege or file protection violation.
47 Unable to read PARM_PATH entry from NATURAL.INI file or directory is not accessible.
48 Unable to read CONFIG_NAME entry from NATURAL.INI file or file is not accessible.
50 Unable to read NATCONV entry from NATURAL.INI file or file is not accessible.
51 Unable to process TMP_PATH entry from NATURAL.INI file. Path 'path' not accessible.
52 Unable to read PROFILE_PATH entry from NATURAL.INI file or directory is not accessible.
53 Unable to open local configuration file NATURAL.INI.
59 Unrecognized option 'option' specified.
60 Not enough memory to initalize internal tables.
61 Execution or compilation error occured.
63 Natural session with active repository already running.
64 Failed to open FNAT's LIBDIR.SAG. Check presence and access protection.
65 The FNAT assigned to this Natural session is out of date.
67 The specified port number is already in use.
68 Invalid syntax ... encountered.
71 Listen on specified port failed.
72 This is an evaluation copy of Natural ... It is valid until...
73 The test period of this evaluation copy of Natural ... has expired. It was valid until...
74 ...Natural error message 'nnnn' received during startup...
75 The port number is not specified.
76 Wrong RPC version.
77 Invalid FDDM assignment.
78 The specified server session ... is not accessible.
79 The port number ... exceeds upper limit (99999).
80 Invalid combination of options encountered.
81 NDV server could not be terminated. Reason: ....
82 Error accessing file 'NDVSERVER.PRU'.
83 Error accessing file 'NDVSERVER.PRU'.
85 Natural runtime startup error during context initialization.
86 Invalid code page [...] specified.
88 Conflicting buffer pool usage.
90 Invalid Client type [...] encountered. Please use ONE, NAT or ANY.
91 No connection to Natural Web I/O Interface.
93 SSL/TLS could not be activated. Reason: ....
94 Pre-loading of OpenSSL libraries failed.
95 RDC environment not found.
96 Failed to create RDC trace buffer.
97 Invalid RDC trace buffer length.
98 Failed to create RDC resource file.
99 Failure on writing RDC resource file.
100 Generic RDC error.
101 Failed to create RDC consolidation buffer.
102 Invalid RDC consolidation buffer length.
103 Cannot create RES subdirectory for storage of RDC data.
104 RDC resource full name (including path) too long.
105 Value of dynamic parameter ITERM must be ON or OFF.
106 Terminate on error during initialization.
107 Profiling with sampling not allowed if code coverage also active.
108 Profiling with event trace not allowed if code coverage also active.
110 Invalid ICU version (custom BS2000 code page support missing).
120 Failed to attach to RDC trace buffer.
121 Failed to write to RDC trace buffer.
122 License check failed.
123 WEBIO=ON is allowed for server sessions only.

Note:
In order to receive the return code, you must run nderun.exe (as opposed to naturalr.exe).