This Natural profile parameter provides the name of the program which receives control if an error condition is detected during Natural program execution.
| Possible settings | 1 to 8 characters | Program name for error transaction. |
|---|---|---|
| blank | With ETA=' ' (blank), no error transaction program
is called.
|
|
| Default setting | blank | |
| Dynamic specification | yes | |
| Specification within session | yes | |
| Application Programming Interface | USR1041N |
With USR1041N you can install your own error
transaction, where USR1041P serves as example how to build such a
routine. See SYSEXT -
Natural Application Programming Interfaces in the
Utilities documentation.
|
The setting of this parameter can be modified by a user program with the
system variable *ERROR-TA.
Note:
Error transaction programs must be in the library to which you are
currently logged on or a current steplib library.
When an error occurs, Natural executes a STACK TOP DATA statement and
places the following information at the top of the stack:
Error number (N4 if session parameter SG=OFF; N5 if
SG=ON)
Line number (N4)
Status (A1)
Program name (A8)
Level (N2)
This information can be used as INPUT data by an error
transaction. The status can be one of the following settings:
| Setting | Explanation |
|---|---|
C |
Command processing error (The line number will be 0.) |
L |
Logon processing error (The line number will be 0.) |
R |
Error on remote server (in conjunction with Natural RPC) |
O |
Object time error |
S |
Non-correctable syntax error |
If Natural Security is installed, the following rules apply:
If an error occurs during the first logon to Natural, the
program specified with the ETA parameter applies. The
error transaction must be in the library SYSLIB or in
SYSTEM on the FNAT or FUSER system file
at the time of the first logon.
If an error occurs after the first logon, the program
specified as error transaction in the security profile of the current library
applies. If no error transaction is specified, the ETA
parameter applies.
For additional information concerning the definition and use of error transaction programs, see Transactions in the Natural Security documentation.
