Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Examples

Parameters

Qualifiers

range-format

/ALL

/IDENTIFIER

/NEXT

/STRING

DEBUG SEARCH — MicroVMS 4.5B

     Directs the debugger to search the source code for the  specified
     string  and  to  display  the  source line or lines containing an
     occurrence of the string.

     The range parameter designates a program region to be searched.

     The string parameter specifies the  source  code  characters  for
     which  to  search.  If the string parameter is not specified, the
     debugger uses the last specified  search  string,  that  is,  the
     string parameter specified in the last SEARCH command.

 Format:

     SEARCH[/qualifier[/qualifier]] range string

Additional information available:

ExamplesParametersQualifiers

Examples

     To see the first occurence of string "XYZ" in module M:

     DBG> SEARCH M XYZ
     module M
     10:        XYZ := 3

     To see the next occurence of string XYZ in module M:

     DBG> SEARCH
     module M
     13:     XYZ := XYZ + 1

     To see all occurences of string "XYZ" in module M:

     DBG> SEARCH/ALL M XYZ
     module M
     10:        XYZ := 3
     13:     XYZ := XYZ + 1

Parameters

 range

     Limits the debugger's search for occurrences  of  the  string  to
     specified program regions.  These program regions may be given in
     any of the specified formats (see range-format for more detail).

 string

     Specifies the string in the source code for which to search.  The
     string  parameter  may  be  enclosed in quotation marks (") or in
     apostrophes ('), or may be specified without delimiters.  If  the
     string  is delimited by either quotation marks or apostrophes, it
     may contain spaces and tabs,  as  well  as  any  alphanumeric  or
     special characters.

Additional information available:

range-format

range-format

    o   MODNAME indicates a search of the specified module  from  line
        number 0 to the end of the module

    o   MODNAME\LINE-NUM indicates a search of  the  specified  module
        from the specified line number to the end of the module

    o   MODNAME\LINE-NUM:LINE-NUM indicates a search of the  specified
        module  beginning  at the line number specified to the left of
        the colon and ending at the line number specified to the right
        of the colon

    o   LINE-NUM indicates a search of the module  designated  by  the
        current  scope  setting  from the specified line number to the
        end of the module

    o   LINE-NUM:LINE-NUM indicates a search of the module  designated
        by  the  current  scope  setting  beginning at the line number
        specified  to  the  left  of  the  colon  and  ending  at  the
        line-number to the right of the colon

    o   NULL (that is, no entry) indicates a search of the same module
        as  that  from which a source line was most recently displayed
        (as a result of either a TYPE or an  EXAMINE/SOURCE  command),
        beginning  at  the first line following the line most recently
        displayed and continuing to the end of the module

Qualifiers

Additional information available:

/ALL/IDENTIFIER/NEXT/STRING

/ALL

     Specifies that the debugger search for  all  occurrences  of  the
     string  in  the specified range and display every line containing
     an occurrence of the string.

/IDENTIFIER

     Specifies that the debugger  search  for  an  occurrence  of  the
     string  in  the specified range but display the string only if it
     is bounded on either side by a character that cannot be  part  of
     an identifier in the current language.

/NEXT

     Specifies that the debugger search for the  first  occurrence  of
     the  string  in  the  specified  range  and only display the line
     containing this occurrence.  This is the default.

/STRING

     Specifies that the debugger search for and display the string  as
     specified,   and   not   interpret  the  context  surrounding  an
     occurrence of the string, as it does in the case of  /IDENTIFIER.
     This is the default.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026