/sys$common/syshlp/SDA.HLB  —  SEARCH
    Scans a range of memory locations for all occurrences of a
    specified value or string. If you press Ctrl/T while using
    the SEARCH command, the system displays how far the search has
    progressed.

    Format

      SEARCH  [/qualifier] range [=] {expression | string}

1  –  Parameters

 range

    Location in memory to be searched. A location can be represented
    by any valid SDA expression. To search a range of locations, use
    the following syntax:

    m:n  Range of locations to be searched, from m to n
    m;n  Range of locations to be searched, starting at m and
         continuing for n bytes

    You must use either an equals sign or a blank to separate range
    from expression or string.

 expression

    Value for which SDA is to search. SDA evaluates the expression
    and searches the specified range of memory for the resulting
    value. For a description of SDA expressions, type HELP
    EXPRESSIONS.

 string

    Character sequence for which SDA is to search. If all characters
    in the sequence are printable characters, the string is enclosed
    in quotes, for example,
    "My_String". If the character sequence contains nonprintable
    characters, it must be specified as a comma-separated list
    composed of quoted strings and hexadecimal numbers; for example,
    ("My_String",0C00,"More") would specify a search for "My_
    String<NUL><FF>More". Each hexadecimal number can be no more
    than 8 digits (4 bytes) in length. Nonprintable sequences of more
    than 4 bytes must be split into multiple hexadecimal numbers.
    The maximum length of a search string is 127 bytes. Note that the
    quote character itself cannot be included in a quoted string and
    must be specified as a hexadecimal number.

2  –  Qualifiers

2.1    /IGNORE_CASE

    Specifies that searches for strings are not to be case-specific.
    (By default, searches look for an exact match.) This qualifier is
    ignored for value searches.

2.2    /LENGTH

       /LENGTH={QUADWORD | LONGWORD | WORD | BYTE}

    Specifies the size of the expression value that the SEARCH
    command uses for matching. If you do not specify the /LENGTH
    qualifier, the SEARCH command uses a longword length by default.
    This qualifier is ignored for string searches.

2.3    /MASK

       /MASK=n

    Allows the SEARCH command finer qranularity in its matches.
    It compares only the given bits of a byte, word, longword, or
    quadword. To compare bits when matching, you set the bits in the
    mask; to ignore bits when matching, you clear the bits in the
    mask. This qualifier is ignored for string searches.

2.4    /PHYSICAL

    Specifies that the addresses used to define the range of
    locations to be searched are physical addresses.

2.5    /STEPS

       /STEPS = {QUADWORD | LONGWORD | WORD | BYTE | value}

    Specifies the step factor of the search through the specified
    memory range. After the SEARCH command has performed the
    comparison between the value of expression or the given string
    and memory location, it adds the specified step factor to the
    address of the memory location. The resulting location is the
    next location to undergo the comparison. If you do not specify
    the /STEPS qualifier, the SEARCH command uses a step factor of
    a longword for value searches, and a step factor of a byte for
    string searches.
Close Help