Executes a debugger command procedure.

    Format

      @file-spec [parameter[, . . . ]]

1  –  Parameters

 file-spec

    Specifies the command procedure to be executed. For any part
    of the full file specification not provided, the debugger uses
    the file specification established with the last SET ATSIGN
    command, if any. If the missing part of the file specification
    was not established by a SET ATSIGN command, the debugger assumes
    SYS$DISK:[]DEBUG.COM as the default file specification. You can
    specify a logical name.

 parameter

    Specifies a parameter that is passed to the command procedure.
    The parameter can be an address expression, a value expression
    in the current language, or a debugger command; the command must
    be enclosed within quotation marks (").  Unlike with DCL, you
    must separate parameters by commas. Also, you can pass as many
    parameters as there are formal parameter declarations within the
    command procedure. For more information about passing parameters
    to command procedures, see the DECLARE command.

2  –  Description

    A debugger command procedure can contain any debugger commands,
    including another execute procedure (@) command. The debugger
    executes commands from the command procedure until it reaches an
    EXIT or QUIT command or reaches the end of the command procedure.
    At that point, the debugger returns control to the command stream
    that invoked the command procedure. A command stream can be the
    terminal, an outer (containing) command procedure, a DO clause in
    a command such as SET BREAK, or a DO clause in a screen display
    definition.

    By default, commands read from a command procedure are not
    echoed. If you enter the SET OUTPUT VERIFY command, all commands
    read from a command procedure are echoed on the current output
    device, as specified by DBG$OUTPUT (the default output device is
    SYS$OUTPUT).

    For information about passing parameters to command procedures,
    see the DECLARE command.

    Related commands:

       DECLARE
       (SET,SHOW) ATSIGN
       SET OUTPUT [NO]VERIFY
       SHOW OUTPUT

3  –  Example

  DBG> SET ATSIGN USER:[JONES.DEBUG].DBG
  DBG> SET OUTPUT VERIFY
  DBG> @CHECKOUT
  %DEBUG-I-VERIFYICF, entering command procedure CHECKOUT
   SET MODULE/ALL
   SET BREAK SUB1
   GO
  break at routine PROG5\SUB2
   EXAMINE X
  PROG5\SUB2\X:  376
       . . .
  %DEBUG-I-VERIFYICF, exiting command procedure MAIN
  DBG>

      In this example, the SET ATSIGN command establishes
      that debugger command procedures are, by default,
      in USER:[JONES.DEBUG] and have a file type of .DBG.
      The @CHECKOUT command executes the command procedure
      USER:[JONES.DEBUG]CHECKOUT.DBG. The debugger echoes commands
      in the command because of the SET OUTPUT VERIFY command.