/START PGM command

Use the /START PGM command to specify the application program that is to be started.

This command also clears the indicator preventing a program from scheduling when I/O prevention has not completed. The integrity of a GSAM database residing on DASD can be affected if I/O prevention has not been done on a failing active system.

/START PGM does not start a CPI Communications driven transaction program.

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 /START PGM command and keywords
Command / Keywords	DB/DC	DBCTL	DCCTL
/START	X	X	X
PGM	X	X	X

Syntax


                      .---------.     
                      V         |     
>>-+-/START-+--PGM--+---pgmname-+-+----------------------------><
   '-/STA---'       '-ALL---------'

Usage notes

The /START 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.

Equivalent IMS type-2 commands

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

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

Examples

The following are examples of the /START PGM command:

Example 1 for /START PGM command

Entry ET:

/START PROGRAM ALL

Response ET:

DFS058I  START COMMAND COMPLETED

Explanation: All application programs are started.

Example 2 for /START PGM command

Entry ET:

/START PROGRAM APPLETRE

Response ET:

DFS058I  START COMMAND COMPLETED

Explanation: Application program APPLETRE is started.