LE z/VSE Attention Routine Commands - How they can help
LEzVSE 0600025UDN Visits (5899)
Today I thought I would make a entry on the LE z/VSE Attention Routine commands that have been available since z/VSE 4.2. How they can be used to help with tuning, "test and try" experiments and application monitoring.
So long as the attention routine initialisation job has been run at IPL (and not removed/disabled) you can make quick changes to LE z/VSE run-time options "on-the-fly". Then, when you've finished, simply re-instate your system default optons. All without the need to submit or tailor any JCL.
Just as there is the CLER CICS transaction for the CICS environment, the equivilent for BATCH is the LE z/VSE attention routine (AR) commands. By accessing the console and entering the AR commands you can over-ride almost any LE z/VSE run-time option active in your system's BATCH enviroment.
So, for example, imagine you wanted to get a storage usage report for a new program you were developing without having to modify the JCL each time. Using the LE z/VSE AR commands, you can simply activate the appropriate run-time option, run your new application, then deactivate the option or restore the original systems default setting.
Using the above as an example, here are the commands you would issue to accomplish this result :
At the console, before the new JCL is executed, issue : S CEE,OPTS=RPTSTG(ON)
Optionally, to verify your over-ride is set, issue : D CEE,OPTS
The console should report :
AR 0015 CEL4020I RPTS
Next, run your new application. When the application has completed succesfully you will find a storage usage report in the output log of the application.
Now, to deactivate our over-ride setting, we would issue on the console : S CEE,CLEAR
The console will return :
AR 0015 CEL4019I Language Environment for z/VSE command complete.
Optionally, to verify our over-ride has been removed, we can issue: D CEE,OPTS
The message " CEL4020I No LE/VSE Option Over-rides" will be displayed to confirm the system default run-time option values are now set.
A few points on the use of the LE z/VSE AR commands :
Other useful option over-rides for application tuning or development would be HEAPCHK and TERMTHDACT.
See the LE z/VSE Debugging Guide, section "1.3.2. Using Attention Routine Interface Commands" for more information on the LE z/VSE Attention Routine commands.