Remove Program (RMVPGM)

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

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.