Chapter Contents

Previous

Next
Command Directory

query

Display Breakpoint/Action Requests

ABBREVIATION
q{uery}

FORMATS

Format 1: query

Format 2: query
FUNCTION-NAME | (SECTION-NAME)
Format 3: query
FUNCTION-NAME | (SECTION-NAME) LINENO
Format 4: query
FUNCTION-NAME | (SECTION-NAME) LINENO:LINENO
Format 5: query
FUNCTION-NAME | (SECTION-NAME) calls/entry/return

DESCRIPTION
The query command shows you a query list (a numbered list of the break, trace, ignore, monitor, and on requests currently in effect), as well as a summary of the auto options.

Format 1: The query command issued with no arguments produces the numbered list of all requests. The list also shows the current setting of the auto command options in effect: echo|noecho, id|noid, list|nolist, nullptr|nonullptr, wrap|nowrap, cmacros|nocmacros, and linesize.

Format 2: The query command used with a section name (SECTION-NAME) or a function name (FUNCTION-NAME) produces only a list of actions in effect for the function or section without a summary of auto options.

Format 3: Format 3 enables you to issue a query command for requests in effect at a particular source line (LINENO) of a particular function or section. You must use either a function name or section name with the LINENO argument.

Format 4: Format 4 produces a query list for a particular section (SECTION-NAME) or function (FUNCTION-NAME) of all requests within a line number range (LINENO:LINENO). LINENO is a source line number. The list can include requests that begin or end outside the specified range. For example, if you specify a range of 25:28 for a particular function, query displays a list of all requests that involve that range, such as a request beginning on line 20 but ending on line 26.

Format 5: Format 5 produces a query list of requests in effect for a particular function or section as follows:

EXAMPLES

query
displays the current settings of the auto command plus a list of all the actions and monitors in effect for the entire program.

query func1
displays the actions and monitors in effect for the func1 function.

query (comp23)
displays the actions and monitors in effect for the comp23 compilation.

query func1 e
displays the actions and monitors in effect upon entry into the func1 function.

query func1 10:50
displays the actions and monitors in effect for lines 10 through 50 of the func1 function.

SYSTEM DEPENDENCIES
none

COMMAND CAN BE ISSUED FROM

PROFILE yes
configuration file no
Source window prefix q

SCOPE
The query command is not affected by changes in scope.

RETURN CODES SET:
Successful: 2, number of last request satisfying the 2 arguments of the query command
Unsuccessful: 0

SEE ALSO


Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.