GETREXXL Command

ADDRESS AXC Commands › Commands for Automation Tasks › GETREXXL Command

GETREXXL Command

The GETREXXL command returns a list of active and queued REXX programs invoked from within CA Automation Point. (The GETREXXL command cannot detect REXX programs invoked outside CA Automation Point.)

This command has the following format:

"GETREXXL"

Usage Notes:

Use the GETREXXL command with the STOPREXX command to stop active REXX programs or to prevent queued REXX programs from executing.
The GETREXXL command stores the information it returns in the following REXX stem variables:

REXX Stem Variable	Contents After Invoking GETREXXL
GETREXXL.0	The number of active and queued REXX programs invoked from within CA Automation Point (in the default AXC environment).
GETREXXL.n	An internal pointer to REXX program number n, indicating the order in which the program was invoked in relation to the others.
GETREXXL_NAME.n	The name of REXX program n and its command line arguments.

Example:

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

"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