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.
8 Obsolete.
9 Obsolete.
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 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.
27 Login cancelled. Natural terminates.
28 Security violation during start of Natural. Natural terminates.
29 Security violation during start of Natural. Login aborted due to too many login failures.
30 Natural system error message raised.
31 NAT0866 Your Natural nucleus is not a Natural Security nucleus.
32 Password check failed.
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.
45 Unable to load add-on product.
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.
54 Unable to read NATCONF.CFG for NATOSDEP.
55 Unable to read NATURAL.INI for NATEXTLIB.
57 Not used.
59 Unrecognized option 'option' specified.
60 Not enough memory to initalize internal tables.
61 Batch error occurred, but processing continued due to CC=ON parameter.
62 More than one Natural session with active repository not allowed.
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.
66 The port number is missing.
67 The specified port number is already in use.
68 Invalid syntax ... encountered.
69 Initialization of Pal package failed.
70 Invalid port number 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 test period of this evaluation copy of Natural ... has expired. It was valid until...
79 The port number ... exceeds upper limit (99999).
85 Natural runtime startup error during context initialization.
86 Invalid code page [ name ] specified.
88 Conflicting buffer pool usage.
91 No connection to Natural Web I/O Interface.

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