Debug and user interface

NAME

: debug, simerror, user_draw - Debug Errors and Visual Interface

SYNTAX

:

      debug ( char *options, char *fmt [, arg] ... )

      simerror ( int stat, int errkind, char *err_mesg )

      user_draw ( char *fmt [, arg] ... )

DESCRIPTION

:

• debug places output in the standard debug file if the specified options are among the debug options that have been given at the begining of the execution or interactivelly during the execution.Converts, formats and prints arguments (if any) under the control of the second argument fmt. fmt is a string format like that one C-function printf uses.

  The options used and their effects are:
  

  -a	Protocol automaton transitions.
  -t	Timers.
  -p	Protocol debug messages (user specified).
  -d	Step and delay samples.
  -e	Events.
  -s	Statistics. ( Add results i.e. mean numbers of total time of execution and number
  	message sent, in specific file )
  -g	Screen debugging.( Debug messages printed on screen )

• simerror prints an error message on the display depending on errkind. If stat has the predefined value FATAL, the execution is aborted. Else if WARNING is used, the execution will not be interrupted, and also warning message will be printed in standard debug file.
  The only user available value for errkind is PROTOCOLERROR. Err_mesg will be printed if PROTOCOLERROR is used.

• user_draw prints a string of up to 15 characters on the 3rd line of each process display window. The arguments are formated and printed, in this string, under the control of fmt.

RESTRICTIONS

In user_draw the maximum number of args is three(3). Instead in Debug no restricion exists on the number of args.

SEE ALSO: Debugging and Metrics (Section 7.1), User interface (Section 3), Simulerr.h and Errors.h.