Communicating with system REXX

You can use the MODIFY AXR command to either obtain status about system REXX or to initiate the execution of a REXX exec. You can also use the prefix defined in the CPF parameter of the AXR00 parmlib member to replace MODIFY(F) AXR. See the AXR00 information in z/OS MVS Initialization and Tuning Reference for more information.
F AXR,{SYSREXX|SR[_|,]STATUS|ST[,DETAIL|D][REXXLIB|R]             }
      {rexxexecname[,TIMEINT=seconds][{[']arg1arg2..argn[']
                                      |[']arg1 arg2 ..argn[']}]   }

The parameters are:

SYSREXX | SR[_|,]
Indicates that the SYSREXX command is to be run. Either a blank or a comma is permitted between SYSREXX and the subsequent operand. For example, you can enter: 
F AXR,SYSREXX STATUS
or 
F AXR,SYSREXX,STATUS
STATUS | ST
Specifies or indicates that general information about System REXX execs is to be returned to the invoker.
DETAIL | D
Indicates that detailed information about execs that are currently running in System REXX is to be returned to the invoker.
REXXLIB | R
Indicates that information about data sets in the REXXLIB concatenation is to be returned to the invoker. The information includes the following details:
  • concatenation order number
  • data set name
  • volume serial of the data set
rexxexecname
A 1-8 character name of a member of the System REXX library (SYS1.SAXREXEC) where the exec resides. The exec will be executed in a TSO=YES environment with CONSNAME=Name of Issuing Console. See z/OS MVS Programming: Authorized Assembler Services Guide for more information. The invoker should avoid flooding the console with messages because any SAY or TRACE output will be sent to the invoking console.
TIMEINT | T
This is an optional parameter that is used to specify a time limit for the exec. If TIMEINT=0 is specified, no time limit will be applied. The exec exceeds this threshold, it will be halted. A maximum of 21474536 seconds may be specified. The default is 30 seconds.
'arg' or 'arg1 arg2 ... argn' or arg or arg1 arg2 ... argn
The remainder of the command line, after the exec name is passed to the exec as a single argument string.

The format for passing arguments to the REXX exec might include blanks, and might have all or parts of the argument string within quotation marks. An odd number of quotation marks is an error. Any bounding quotation marks are removed, and two consecutive quotation marks within a quoted string result in a single quotation mark that is being included as part of the final argument processed by the REXX exec. System command processing converts all characters of any argument string that are not quoted to uppercase characters. All formats are passed as a single string of data. However, when multiple arguments are to be passed, separating each argument with a blank makes it simpler to parse them into the runtime REXX arguments required by the exec.

Example 1:

To obtain status information, enter the following command:

F AXR,SYSREXX STATUS

AXR0200I SYSREXX STATUS DISPLAY      
SYSTEM REXX STARTED AT 11.00.30 ON 09/18/2006   
PARMLIB MEMBERS:      AXR00                      
CPF:  % (SYSTEM)      AXRUSER:  MEGA             
TIMEINT:              30                         
SUBSYSTEM:            AXR                         
REQUESTS QUEUED:      0  ACCEPTING NEW WORK       
REXX WORKER TASKS:    ACTIVE:   0     TOTAL:   4  
                      IDLE:     4     MAX:    64  
                      ASYNC:    0     SYNC:    0  
                      UNTIMED:  0                 
TSO SERVER SPACES:    ACTIVE:   0     TOTAL:   0  
                      IDLE:     0     MAX:     8  
                      ASYNC:    0     SYNC:    0  
                      UNTIMED:  0

Example 2:

To obtain detailed status information, enter the following command:

F AXR,SYSREXX STATUS,DETAIL

AXR0201I SYSREXX STATUS DETAIL       
EXEC=WAITLOOP CJBN=AXR      CASID=0015 TSO=Y T/L=00.00.30
  REQTOKEN=0000520000000000BF3A704A6511A3B5
  EJBN=AXR02    EASID=0033 TCB=006FF098 CPU=000.004S TIME=005.739S
EXEC=INFINITE CJBN=AXR      CASID=0015 TSO=Y T/L=00.00.30
  REQTOKEN=0000540000000000BF3A704C2088405C
  EJBN=AXR03    EASID=0032 TCB=006FF098 CPU=000.006S TIME=003.925S

Example 3:

To obtain information about data sets in the REXXLIB concatenation, enter the following command:

F AXR,SYSREXX REXXLIB

AXR0202I SYSREXX REXXLIB DISPLAY       
NUMBER   VOLUME         DATA SET
01			    TSTO05         RONN.REXX 
02			    SBOX00         SYS1.SAXREXEC

Example 4:

To invoke a REXX exec from a console with part of its argument string kept as lower case and part converted to upper case by system command processing, enter the following command:

F AXR,TheExec 'here''s a lower case string'  here''''s an uppercase string
Parent topic: MODIFY command