DocBag

This Month's Topic

TSO in batch: Alternate programs

IKJEFT01 is the Terminal Monitor Program (TMP) typically used for online TSO sessions. However, there are other options available that may be more appropriate for some uses with batch in TSO:
Program Condition Result
IKJEFT01 Abend:
program, TSO command
Exits with RC=12
RC not zero Continues execution
Final return code set by last command, program, CLIST or REXX executed
IKJEFT1B System abend:
program, TSO command
Abends with S04C abend
User abend:
program, TSO command
Exits with completion code
Non-zero return code:
CLIST
Continues execution
Non-zero return code:
TSO command, program, REXX or
TSO command invoked from CLIST
Exits with return code
IKJEFT1A System or user abend:
program, TSO command
Abend with S04C abend
Non-zero return code:
CLIST
Continues execution
Non-zero return code:
TSO command, program, REXX or
TSO command invoked from CLIST
Exits with return code

Using one of the other TMPs would allows the TSO in batch step to end immediately if a TSO command exits with a non-zero return code, for example. If you have set up a JCL procedure to run TSO in batch, you may wish to include a parameter to allow a different TMP to be specified. For example,

//TSOBATCH PROC TMP=IKJEFT01 //IKJEDIT EXEC PGM=&TMP,DYNAMNBR=140,REGION=4M,TIME=30 //SYSPROC DD sysproc concatenation .... //SYSHELP DD DSN=SYS1.HELP,DISP=SHR //SYSLBC DD DSN=SYS1.BRODCAST,DISP=SHR //SYSPRINT DD SYSOUT=* //SYSTERM DD SYSOUT=* //SYSTSPRT DD SYSOUT=* You could execute this procedure with TMP=IKJEFT1A to specify that IKJEFT1A should be used instead of IKJEFT01.

For other examples related to TSO in batch here, see:

For a description of the behaviour of various TMPs, see EXEC Statement in the JCL Reference.

Feedback

Comments or suggestions can be sent to the author.

Back Issues

Big Iron