tcl.log-msg Verb: Access/TCL

tcl.log-msg

Command tcl.log-msg Verb: Access/TCL
Applicable release versions: AP
Category TCL (746)
Description records the time and date that a particular macro is executed. The log entry is placed into the "dm,errors," file. This command is executed by the "power-off" process.

This verb can be used within a macro, for example, to note when the macro was executed.
Syntax log-msg message
Options
Example
log-msg application event

sort errors by date

page   1      errors                07:31:34 02 Oct 1991

errors.... date. time. r mode-addr........... user   error.........

867553651  10/01 14:54   Coldstart after      dm (0) log-msg
                         abnormal shutdown
867625376  10/02 07:02   Coldstart after      dm (0) log-msg
                         normal shutdown
867626224  10/02 07:17   application event    dm (1) log-msg

[405] 3 items listed out of 3 items.

Legend:

"errors"      is the system-generated job number (item-id) for this 
item.

"date"        is the date that this error was logged.

"time"        is the time that this error was logged.

"r"           is the register address (0 - f) which triggered the 
error condition (e.g. forward link zero, referencing illegal frame aborts, etc.)

"mode-addr"   is the description of the error, or address of the 
program when it generated the error.

"user (pib)"  is the user-id who was running the process along with 
the port.number.

"error"       is the process which caused this error message to be 
placed in the log.
Purpose
Related tcl.log-status
tcl.startlog
tcl.stoplog
tcl.txlog
filename.errors
tcl.txlog-status