CAAPE User's Manual - ALSTOM Signaling Inc.

Simulator Reference12.4. PREDEFINED SIMULATOR LOGIC FUNCTIONSThese special functions can be accessed from simulation logic with subroutine CALLs.12.4.1. User Message Logging FunctionsThese allow the user to log text and variable data to the Message Window and the logfile. They can be used to log information on the status of the application, the fact thatsimulation reaches a given point in the logic, etc.Function: LOG_TEXT( text )Logs the specified text whenever this function is encountered in the logic.• text is the user specified text, enclosed in quotes.For example:* log a message if variable VAR1 is TrueIF( VAR1==TRUE )CALL LOG_TEXT( "VAR1 is true!!" )Function: LOG_VAL( variable,text )Logs the value of the specified variable plus optional text whenever this function isencountered in the logic.• variable is a reference to some variable in the logic.• text is the user specified text, enclosed in quotes.For example:* log the value of variable ARRAY[10]CALL LOG_VAL( ARRAY[10] )* log the value of integer variable COUNT1 plus a messageCALL LOG_VAL( COUNT1, "Loop count for checking messages" )P2512A, Rev. Oct/09 12–21 Alstom Signaling Inc.