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