CL Command Reference - ADDPGM
CL Command List > ADDPGM Reference
Description:
The Add Program (ADDPGM) command adds one to twenty programs to the group of programs currently being debugged. When included in debug mode, the specified programs can have breakpoints and traces added to them for controlling and tracing their processing. The values of the programs¡¯ variables can also be displayed and changed.
When debugging one job from another job, debugging affects the running of the programs in the job being debugged, but not the job doing the debugging. You may run programs in a job doing the debugging, however, the programs will not be debugged.
Restrictions:
. You can use this command only in debug mode. To start debug mode, refer to the Start Debug (STRDBG) command.
. You cannot use this command if you are servicing another job, and that job is on a job queue, or is being held, suspended, or ended.
. No more than 20 programs can be debugged at the same time.
. Two or more programs with the same name cannot be debugged at the same time.
. This command cannot be used to add bound programs.
. You must have either *CHANGE authority to the program, or *USE authority to the program and *SERVICE special authority.
Examples:
ADDPGM PGM(QGPL/MYPROG)
This command adds the program MYPROG, located in the QGPL library, to the current debug mode. Breakpoints and traces can be put in MYPROG, and its variables can be displayed and changed by other debug commands. Because DFTPGM was not specified, the default program is not changed.