%REMOVE

With the %REMOVE command you revoke the test declarations for the %CONTROLn, %INSERT and %ON commands.

• With target you specify whether AID is to revoke all effective declarations for a particular command or whether only a specific test point or event or a subcommand is to be deleted.

Command	Operand
%REM[OVE]	target

If a subcommand contains a %REMOVE which deletes this subcommand or the associated monitoring condition (test-point, event or criterion), any subsequent commands in subcmd will not be executed. Such an entry is therefore only meaningful as the last command in a subcommand.

The %REMOVE command does not alter the program state.

target

Designates a command for which all the valid declarations are to be deleted, or a test-point to be deleted, or an event which is no longer to be monitored, or the subcommand to be deleted. If target is within a nested subcommand and therefore has not yet been entered, it cannot be deleted either.

target-OPERAND  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 {  %C[ONTROL] | %C[ONTROL]n 
  | %IN[SERT] | test-point
  | %ON | event | %WRITE
  | %•[subcmdname]
 }
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

%C[ONTROL]

The declarations for all %CONTROLn commands entered are deleted.

%C[ONTROL]n

The %CONTROLn command with the specified number (1 ≤ n ≤ 7) is deleted.

%IN[SERT]

All test points which have been entered are deleted.

test-point

The specified test-point is deleted. test-point is specified as under the %INSERT command.
Within the current subcommand, test-point can also be deleted with the aid of %REMOVE %PC->, as the program counter (%PC) contains, at this point in time, the address of the test-point.

%ON

All events which have been entered are deleted.

event

The specified event is deleted. event is specified with a keyword, as under the %ON command. The event table with the keywords and explanations of the individual events can be found under the description of the %ON command.

The following applies for the events %ERRFLG(zzz), %SVC(zzz) and %LPOV(x...x):

%REMOVE event(zzz) deletes only the event with the specified number. %REMOVE event without specification of a number deletes all events of the corresponding group.

%WRITE

The write-event is deleted.

%•[subcmdname]

deletes the subcommand with the name subcmdname in a %CONTROLn or %INSERT command.

%• is the abbreviated form of a subcommand name and can only be used within the subcommand. %REMOVE %• deletes the current subcommand.

As %CONTROLn cannot be chained, the associated %CONTROLn will be deleted as well. Deleting the subcommand therefore has the same effect as deleting the %CONTROLn by specifying the appropriate number.

On the other hand, several subcommands may be chained at a test-point of the %INSERT command. With the aid of %REMOVE %•[subcmdname] you can delete an individual subcommand from the chain, while further subcommands for the same test-point will still continue to exist (see AID Core Manual (Related publications) [1]). If only the subcommand designated subcmdname was entered for the test-point, the test-point will be deleted along with the subcommand.

%REMOVE %•[subcmdname] is not permitted for %ON.

Examples

1. %C1 %CALL <CALL: %D %.
%REM %C1
%REM %.CALL

   Both %REMOVE commands have the same effect: %C1 is deleted.

2. %IN S'58SEA' <SUB1: %D CHAR, QNTY>
%IN S'58SEA' <SUB2: %D RESLT; %REM %.>
%R
...
%REM S'58SEA'
When the test point S’58SEA’ is reached, RESLT is output. Then subcommand SUB2 is deleted, i.e. this subcommand is executed only once. Subsequently CHAR and QNTY are output, and the program continues. Whenever test point S’58SEA’ is reached in the program sequence, subcommand SUB1 is executed. %REM S'58SEA' deletes the test point later on. %REM %.SUB1 would have the same effect, as this subcommand is the only remaining entry for test point S’58SEA’.