PLBCS_LOGNAME Keyword

     PLBCS_LOGNAME={logfile}

or

     PLBCS_LOGFILE={logfile}

This optional keyword enables server logging. If this keyword is not defined, server logging is disabled.

When a leading '#' character is specified, any new log entries are appended to the end of a currently existing log file.

The log file name format for PLBSERVE supports an embedded control of '@T' or '@t'. This control is replaced with the current clock time in the log file name and may be used with other file name controls

The {logfile} can have the string '@d' embedded into the specified log file name. The '@d' string is replaced with the current date in YYMMDD form. This causes a new log file to be started for every day that an Application Server is started.

Example:

     PLBCS_LOGFILE=lt@d.log

This creates a log file with a name 'lt041215.log' if the date was December 15, 2004.

Example 2:

     PLBCS_LOGNAME=#lt.log

In this case, the current logfile named 'lt.log' is used. If the 'lt.log' exists when the server is started, any new log data is appended to the end of the existing log file.

Example 3:

     PLBCS_LOGNAME=lt@D_@T.log

In this case, the current logfile name includes the current date and time as part of the log file name. This gives a unique log file name that should never conflict with any previously existing log files. The log file name could resolve to a name such as "lt070620_110823.log".

Example Log Entry 1:

Server logging provides date information about processing and any errors that might occur. The format of a log file entry is:

     YYYY-MM-DD HH:MM:SS NNNN L DATA

Where:

03-03-04 15:18:77 0002 0 Admin Child Start.....: 127.0.0.1, 2

This example shows the connection of an admin child task from IP address 127.0.0.1. The two (2) indicates the admin task id number.

Example Log Entry 2:

2007-01-09 07:30:23 0123 0 Cmd: 20560 Last Cmd: 20546 Error: I03 Errno: 2

                           Run: '3' Ver: '9006'

                           Prog: 'myprogram.plc'

                           FileName........: mydatafile.txt

                           ExtendedError...: WINERR:0x2

See Also: PLBSERVE Keywords, PLBSERVE Command Syntax