Version 6.3.8 for OpenVMS
 —  Parameter Reference  —

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  

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.

Natural tries to create the following file name, if the user-ID/et-ID information could be retrieved:

NATURAL_<user-ID>_<et-ID>.LOG

If user-ID and et-ID could not be retrieved, then the following file name is used: NATURAL.LOG.

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.

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 OpenVMS:

# ####################################################
#           N a t u r a l   L o g   F i l e
# ####################################################
#
# Logging started at : 28-May-2008 15:28:19.048
#                    : 
# Natural Version    : V v.r.s   Software AG 2008
# Server Type        : (none)
# Device             : BATCH  (real)
# BufferPool Name    : BPNATAN2
# Parameter File     : NATPARM 
#                    : 
# User ID            : NATURAL
# ET ID              : TEST 
# Network User ID    : NATURAL 
#                    : 
# Host Name          : NATAN2 
# Machine Class      : VMS 
# Operating System   : OVMS/IA6V8.3-1H1 
#                    : 
# Process ID         : 21E51D3A 
#                    : 
# NATLOG Option      : ALL
#
# ####################################################
#
# ------------------------------------------------------------------------------
# 15:28:19.052  NATURAL     INFORMATIONAL  STATISTICS:  INF=1  WRN=0  ERR=0
# ------------------------------------------------------------------------------
Value of parameter CMSYNIN (command file)
alf9$user:[tmp]batch.cmd
Value of parameter CMOBJIN (input file)

Value of parameter CMPRINT (output file)
alf9$user:[tmp]batch.out
# ------------------------------------------------------------------------------
# 15:28:19.069  NATURAL     ERROR          STATISTICS:  INF=1  WRN=0  ERR=1
# ------------------------------------------------------------------------------
  Natural Startup Error:  42
  Batch mode driver error.
  Parameter CMOBJIN not set.

Top of page