/STOP PGM command

The /STOP PGM command specifies the application program that is to be stopped.

Subsections:

Environment
Syntax
Usage notes
Equivalent IMS type-2 commands
Examples

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the commands and keywords.

Table 1. Valid environments for the /STOP PGM command and keywords
Command / Keywords	DB/DC	DBCTL	DCCTL
/STOP	X	X	X
PGM	X	X	X

Syntax


                     .---------.     
                     V         |     
>>-+-/STOP-+--PGM--+---pgmname-+-+-----------------------------><
   '-/STO--'       '-ALL---------'

Usage notes

The /STOP PGM command does not stop CPI Communications driven transaction programs.

Start of change The /STOP PGM command is not allowed for a program that is marked bad with the NOTINIT-57-REPOCHGLIST reason code because the IMS™ change list processing is not complete for the program or the change list processing failed. End of change

Equivalent IMS type-2 commands

The following table shows variations of the /STOP PGM command and the IMS type-2 commands that perform similar functions.

Table 2. Type-2 equivalents for the /STOP PGM command
Task	/STOP PGM command	Similar IMS type-2 command
Stops program scheduling.	/STOP PGM `pgmname`	UPDATE PGM NAME(`pgmname`) STOP(SCHD)

Examples

The following is an example of the /STOP PGM command:

Entry ET:

/STOP PROGRAM APPLETRE

Response ET:

DFS058I  STOP COMMAND COMPLETED

Explanation: Application program APPLETRE is stopped.