Peter Lorenz German smaller fonts Simulation und Animation

Interactive Debugging

If a program terminates with an execution error or terminates fine but produces improper results an interactive debugging tool is a big help. GPSS/H has such an interactive debugging tool. To reach this tool the program must be started with the parameter TV at the end. The following list shows all interactive debugging commands: (the underlined part of the word gives the shortest possible command.)

CommandOperandsExplanation
ATOne or more Block names or numbers The AT command prompts the user for a list of interactive debugging commands to be executed every time a Transaction reaches any of the designated Blocks. The list of commands ends with an END. The AT effect can be canceled by the UNBREAK command.
BREAKOne or more Block names or numbers The BREAK command sets an global Breakpoint. This Breakpoint can be released by the UNBREAK command.
CHECKPOINTnone The CHECKPOINT command writes an image of the model to the disk. This model can be restored by the RESTORE command.
CONTINUEZero or more Block names or numbers The CONTINUE command is used to resume execution of a model. Any Block names or numbers specified in the CONTINUE command are set as local breakpoints, which remain in effect only for the duration of the CONTINUE command. The enabling and disabling of local Breakpoints has no effect on global Breakpoints.
SCAN, SYSTEM, NEXT Local trap conditions can be set by the CONTINUE command. For a summary of these conditions, see the description of the TRAP command in this table.
CXZero or more Block names or numbers CX stands for Continue eXecution. It operates like the CONTINUE command but the pending model output is suppressed
DISPLAY
Status Display
ATLAT list
ATPAll AT points
BREAll breakpoints
CECCurrent Event Chain
CLOAbs and Rel Clock
COMCommonStorage
CPUCPU time
FECFuture Event Chain
INTInterrup Chain
MATMatching Chains
OUTStandard Output
STACurrent Xact status
TRAAll global traps
Display members of entity classes
AMPAll Ampervariables
BLOBlocks
BMSByte Msavevalues
BSVByte Savevalues
CHAUser Chains
CHRScalar CHAR*n Ampervariables
CHYCHAR*n Ampervariable Arrays
FACFacilities
FLTScalar Floting Point Ampervariables
FLYFloating Point Ampervariable Arrays
FMSFullword Msavevalue
FSVFullword Savevalue
GRPGroups
HMSHalfword Matrix Savevalue
HSVHalfword Savevalue
IVRScalar Integer Ampervariable
IRYInteger Ampervariable Arrays
LMSFloating Point Msavevalue
LOGLogic Switches
LSVFloating Point Savevalues
QUEQueues
STOStorages
TABTables
UCHUser Chain Dump
VCHScalar VCHAR*n Ampervariables
VCYVCHAR*n Ampervariable Arrays
The DISPLAY Command can select a wide variety of model statistics and other useful information for display on the screen.
DSAn optional Block name or number The DS command can be issued only in the TV mode. This command displays the source code for the given block in the source code window of the debugger.
IGNORE A Block name or number, followed by a count The command is used to temporarily suppress a global breakpoint count-times.
NEXT none This command specifies that execution of the model is to proceed until the next active Xact is picked up in the simulators CEC scan.
PRINT see DISPLAY The PRINT command can write a wide variety of model statistics and other useful information for display on the standard output device.
QQnone The QQ command causes the immediate termination of the run without an output.
QUITnone The QUIT command terminates a run. If any model output is pending at the time the QUIT command is issued, a warning is given, and the QUIT command must be typed a second time to suppress the output.
RUNZero or more Block names or members The RUN command is used to initiate execution of the model until it reaches a breakpoint. It is possible to set TRAP conditions for a run.
SCAN
SYSTEM
NEXT
CLOCK[=]n.n
XACT[=]n
RESTOREnone The RESTORE command restores a saved image of a model.
STEPoptional count The STEP command runs through the given number of Blocks.
STOPnoneThe STOP command stops the run.
SET TIME[=]n
TIME[=]nS
TIME[=]nM
TLOG[=]ON
TLOG[=]OFF
TV[=]ON
TV[=]OFF
The SET command can be used to set a CPU time limit which supersedes any currently active time limit, including time limits set by SIMULATE statements within a model. An "S" suffix indicates that the time limit is specified in seconds, and am "M" suffix indicates that the time limit is specified in minutes. An other possibility is to turn the terminal log ON or OFF and to turn the TV mode ON or OFF.
TRAPSYSTEM
NEXT
SCAN
CLOCK[=]n.n
XACT[=]n
The TRAP SYSTEM command specifies that each time the active Xact comes to rest, a message is to be issued, and control returns to the user. Global TRAP SYSTEM conditions can be set by the RUN command.
Local TRAP conditions can be set by the CONTINUE command.
  • TRAP NEXT indicates that each time a new Xact is picked out of the CEC a message is given and the control goes to the user.
  • TRAP SCAN indicates that each time the CEC is checked.
  • The TRAP CLOCK[=]n.n command specifies the time of the absolut clock a message is to be issued, and the control returns to the user.
  • TRAP XACT[=]n indicates that each time the Xact is move a message is to be issued, and the control returns to the user.
UNBREAKOne or more Block names or number The UNBREAK command removes global Breakpoints.
UNTRAPSYSTEM
NEXT
CLOCK[=]n.n
XACT[=]n

"*"
The UNTRAP command removes traps set via the TRAP command. UNTRAP * removes all current traps.

SAHome previous next up Germansmaller fonts Top Line
Last Modified Fri 03-04-05 12:02 GMT Valid CSS!
English Translation:S. Osterburg

Comments please to:pelosim@yahoo.com