NATLOG - Natural Log File

#### Search Results

Search

# NATLOG - Natural Log File

This Natural profile parameter is used to log messages that will not (or could not) be written to the standard output in interactive mode or to the output file `CMPRINT` in batch mode.

Possible settings | `OFF` | Disables the log mechanism.
`ERR` | Logs error messages.
`INF` | Logs information and success messages.
`WRN` | Logs warning messages.
`ALL` | Logs all types of messages.
Default setting | `OFF` |
Dynamic specification | yes |
Specification within session | no |

Notes:

1. The location of the `NATLOG` file is the `TEMP` directory of Natural (specified in the local configuration file NATURAL.INI). If this path is unknown, Natural creates the file in the current directory.
2. Natural tries to create the following file name, if the `user-ID`/`et-ID` information could be retrieved: NATURAL_<user-ID>_<et-ID>.LOG
3. If `user-ID` and `et-ID` could not be retrieved, then the following file name is used: NATURAL.LOG.
4. Example File Names: A Natural batch process is running with `user-ID=SYSTEM` and `et-ID=14`, then the resulting file name is NATURAL_SYSTEM_14.LOG.
5. If the `user-ID` could not be retrieved (which is the case if an error occurs during the initialization phase of Natural), then the resulting file name is NATURAL.LOG.

## Examples

The following example shows the contents of a Natural log file. At top of the file, there is a header with some environment information, for example the Natural Version, the parameter file currently in use and so on. Two entries follow. The first one an entry which displays the I/O channels needed for batch mode. The second entry shows an error message. Both messages are counted in the statistics summary.

Example `NATLOG` Output Contents for Linux:

    # ####################################################
    #           N a t u r a l   L o g   F i l e
    # ####################################################
    #
    # Logging started at : 06-Mar-2007 08:08:38.023
    #                    :
    # Natural Version    : V v.r.s SAG 2003
    # Server Type        : (none)
    # Device             : BATCH  (real)
    # Parameter File     : NATPARM
    #                    :
    # User ID            : NATURAL
    # ET ID              : TEST
    # Network User ID    : NATURAL
    #                    :
    # Host Name          : hpn2
    # Machine Class      : UNIX
    # Operating System   : HP_HPUX  B.10.20A
    #                    :
    # Process ID         : 17921
    #                    :
    # NATLOG Option      : ALL
    #
    # ####################################################
    #
    # ------------------------------------------------------------------------------
    # 08:08:38.025  NATURAL     INFORMATIONAL  STATISTICS:  INF=1  WRN=0  ERR=0
    # ------------------------------------------------------------------------------
    setting of parameter CMSYNIN (command file)
    $HOME/tmp/batch.cmd
    setting of parameter CMOBJIN (input file)

    setting of parameter CMPRINT (output file)
    $HOME/tmp/batch.out
    # ------------------------------------------------------------------------------
    # 08:08:38.028  NATURAL     ERROR          STATISTICS:  INF=1  WRN=0  ERR=1
    # ------------------------------------------------------------------------------
          NATURAL Startup Error:  42
          Batch mode driver error.
          Parameter CMOBJIN not set.