The Remove Program (RMVPGM) command removes one or more programs from the current debugging session. All breakpoints and traces defined in each program are removed, and the programs are returned to their normal state. If a program is added again, breakpoints and traces must be specified again.

Restrictions:

1. You can use this command only in debug mode. To start debug mode, refer to the Start Debug (STRDBG) command.
2. You cannot use this command to remove bound programs from a debugging session.

Parameters

Keyword	Description	Choices	Notes
PGM	Program	Single values: *DFTPGM, *ALL Other values (up to 20 repetitions): Name	Optional, Positional 1

Top

Program (PGM)

Specifies which programs are removed from the current debugging session.

Single values

*DFTPGM

The program currently specified as the default program in the debugging session is the program to be removed. The debugging session no longer has a default program unless one is specified later.

*ALL

All the programs that are currently in debug mode are removed.

Other values (up to 20 repetitions)

name

Specify the name of the program to be removed from the current debugging session.

Examples

RMVPGM   PGM(PGMX  PGMY  PGMZ)

This command removes the three programs PGMX, PGMY, and PGMZ from the current debugging session. All breakpoints and data traces are removed from the programs.

Error messages

*ESCAPE Messages

CPF1999

Errors occurred on command.