Chapter Contents
Previous
Next
Command Directory

disable

Disable Requests

ABBREVIATION
di{sable}

FORMATS
Format 1: disable ACTION-RANGE
Format 2: disable ACTION-RANGE, ACTION-RANGE, . . .
Format 3: disable FUNCTION-NAME|(SECTION-NAME) all
Format 4: disable all
Format 5: disable last

DESCRIPTION
The disable command disables requests. Requests are identified by request number as displayed by the query command. The ACTION-RANGE argument is either ACTION (a single request) or ACTION:ACTION (a request range).

Format 1: Format 1 disables one request or one request range specified by ACTION-RANGE.

Format 2: Format 2 disables several single requests and/or request ranges.

Format 3: Format 3 disables all requests for a section (SECTION-NAME) or function (FUNCTION-NAME).

To use this form of disable, specify the function name or, in parentheses, the section name followed by the keyword all.

Format 4: This format disables all requests for the entire program.

Format 5: This format disables the last request on the list.

After you disable a request, the request is not honored until you enable it again. (See enable.) Disabled requests are marked with an asterisk in the query list next to the request number. (If you try to disable a request that is already disabled, you receive a message.)

In contrast to drop, which permanently removes requests from the query list, disable only makes the command ineffective until you reenable it.

Identical requests: If you issue a request, disable it, and then issue an identical request, the identical request is discarded and the original request is automatically enabled.

EXAMPLES

disable 3
disables request number 3 in the query list.

disable 3:6
disables request numbers 3 through 6 in the query list.

disable 4, 9:13, 7
disables request number 4, request numbers 9 through 13, and request number 7 in the query list.

disable func1 all
disables all requests for the func1 function.

disable (comp23) all
disables all requests for the comp23 section name (compilation).

disable all
disables all requests for the program.

disable last
disables the last request on the list.

SYSTEM DEPENDENCIES
none

COMMAND CAN BE ISSUED FROM

PROFILE yes
configuration file no
Source window prefix d

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

RETURN CODES SET
Successful: a nonzero number
Unsuccessful: 0

SEE ALSO


Chapter Contents
Previous
Next
Top of Page

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