	DEBUG [taskname]

 DEBUG forces a task on an RSX-11M-PLUS system to trap to a debugger by
 setting  the T-bit in the task's Processor Status Word.  The task must
 have been built using the /DEBUG qualifier to the LINK command or have
 issued  the  SVDB$  Executive  directive (Specify SST Vector Table for
 Debugging Aid).  

 Nonprivileged users can issue this command for any nonprivileged  task
 running  from their terminal.  Privileged users can name any task, but
 the command must be issued from the same terminal  the  task  was  run
 from.  


Parameter

taskname

     Specifies the name of the task you wish to trap.  If you  do  not
     specify  a  task  name,  the  default  is  a task named after the
     terminal from which the command was issued, such as TT56.  

Example

     	>RUN JOE
     	>SHOW TASKS/ACTIVE
     	MCR...		(TT56:)
     	SHOT56		(TT56:)
     	TT56		(TT56:)
     	   .
     	   .
     	   .
     	>DEBUG
     	TE:002452
     	

     In this example, the task was  built  including  ODT.   The  user
     issued the DEBUG command, which defaulted to the task named after
     the terminal.  The display from ODT  gives  the  T-bit  exception
     code  and  the address following the location in error and issues
     its prompt.   The  user  can  proceed  with  debugging.   ODT  is
     documented in the IAS/RSX-11 ODT Reference Manual.  

Notes

     The DEBUG command is useful when a task is caught in an  infinite
     loop  between  breakpoints,  or  is  waiting  for an incorrect or
     nonexistent event flag.  

     See the RSX-11M/M-PLUS Executive Reference Manual for information


                                                                PAGE 2



     on the SVDB$ directive.

     The /DEBUG qualifier to the LINK command is equivalent to the /DA
     switch  on  a  TKB  command.   See  also  the RSX-11M/M-PLUS Task
     Builder Manual.


Error Message

     	"time" *** "taskname" does not contain a debugging aid

     Explanation:  An attempt was made to debug a task  that  was  not
     build with a debugging aid.  

     User Action:  None.  This cannot be done.



