LOG

The LOG command is used to control the user session log file. When logging is active, a record of various events is made in the log file, such as the assignment of parameters and the launching of EASI programs.

 LOG START
 LOG START file_name
 LOG START level_number

The LOG START command is used to activate session logging. The default filename is EASI.LOG, which would be created in the local directory. If another filename is supplied in the LOG START command, it will override the default name. If the log file already exists when logging is initiated, additional log entries will be appended to the end of the log file.

If LOG START is given a numeric level number as an argument, the "Level of Interest" can be modified. The default level is four.

• Level 1: Record only user commands.
• Level 2: Record only messages from the LOG command.
• Level 3: Record LOG command messages, and all EASI program executions.
• Level 4: (the default) Record LOG command messages, EASI program executions and assignments to parameters.

 LOG STOP

The LOG STOP command is used to terminate logging.

 LOG LIST

The LOG LIST command will dump the contents of the currently active log (or EASI.LOG if logging is not active) to the terminal.

 LOG DELETE

The LOG DELETE command will terminate logging and delete the current log file. If logging is not active, the file EASI.LOG will be deleted.

 LOG string_expression

The LOG command can be given an arbitrary string expression as an argument. The contents of the string expression will be appended to the log file.

Log files record the things that occur in a session in such a way that the session can be reconstructed to some extent. If the logfile is renamed as a .EAS procedure, it is possible to run the file and reinvoke the commands. To some extent new "macros" can be created by recording user actions. The records in the log file have the following format:

! HH:MM:SS operation message

where

[HH:MM:SS]is the current time.
[operation]is the type of log entry
[message] is a short description message

Other uses of the LOG commands are to record a session for debugging by PCI or other users and to record progress and timing for batch operations.

Example:

The following example records a couple of simple steps into a .EAS file so that it can be played back later as shown. Type:

 log start "MYMACRO.EAS"
 file="$PCIHOME/demo/irvine.pix"
 run cdl
 log stop
 run mymacro

The MYMACRO.EAS file will be created with the following information:

! 23:59:54  LOG STARTED  31-Dec-03
file = "$PCIHOME/demo/irvine.pix"
! 23:59:54  BEGIN        CDL
RUN CDL
! 00:00:03  END          CDL
! 00:00:03  LOG STOPPED  01-Jan-04