ADDRESS AXC Commands › Commands for Automation Tasks › STOPREXX Command

STOPREXX Command

The STOPREXX command stops an executing REXX program or cancels execution of a queued REXX program. The STOPREXX command can stop a REXX program only if the program is running within CA Automation Point.

Note: You must issue the GETREXXL command before issuing the STOPREXX command.

This command has the following format:

"STOPREXX rexxprognum"

rexxprognum

Specifies the internal REXX pointer for a specific REXX program (acquired by a previously issued GETREXXL command).

Usage Note:

It is possible for the STOPREXX command to stop the issuing REXX program, meaning that your REXX program could terminate itself. Be sure that your REXX code allows for such a scenario when checking the GETREXXL_NAME.n variables generated by the GETREXXL command.

Example:

Suppose that you want to stop all instances of a particular program. Your REXX statements could look like these:

"GETREXXL"

/* GETREXXL populates GETREXXL.0 with the number   */
/* of active and queued REXX programs, the         */
/* GETREXXL_NAME.i variables with the name and     */
/* arguments of a program, and GETREXXL.i with the */
/* number used by STOPREXX to terminate the program*/   

DO I = 1 TO GETREXXL.0
   parse upper value GETREXXL_NAME.i with rxname.
   IF rxname  = token THEN
   "STOPREXX "GETREXXL.I
END