UTMEX3 - Timer Monitor RJE Exit

UTMEX3 is a user-written routine called by UTIMRM at RJE job submission.

This exit has the same parameters and behaves in the same way as UXEEX3 , except that word 2 of the parameter list points to UTMSCOM, the timer common region, instead of UEPDCOM.

A dummy UTMEX3 module is distributed with the Com-plete system as a member of the distribution and load libraries.

This document covers the following topics:

How to Use UTMEX3

Upon entry to UTMEX3, a set of parameters is received in the form of fullword addresses in register 1. Word 1 of the parameter list contains the address of a return code area in which the status of the request is to be indicated. Word 2 of the parameter list contains the address of the UTMSCOM data area.

Word 3 of the parameter list contains the address of the "call-type" byte being passed to UTMEX3; valid character values are:

S start of job submission before the first statement.
sp (space) standard call.
E end of the submission following the last statement.

Note:
If the contents of the areas pointed to by word 2 and word 3 are both binary zero, it is considered to be an 'every minute' exit call. In this case, any service can be filled into the timer record.

Word 4 of the parameter list contains the address of the card image. Word 5 of the parameter list contains the address of the area to be used when inserting statements (return code = 8).

Note that the last two parameters are valid only if the call-type byte is a space.

Upon return to the loading module from UTMEX3, the return code halfword is examined and processed as follows:

0 Normal return; the next statement is processed, unless the final statement has been processed.
4 Delete the current statement. This return code is valid only if the call-type byte is a space.
8 Insert a statement before the current card image statement. The statement to be inserted must be in an area pointed to by the fifth parameter in the parameter list (+16). This return code is valid only for the call-type byte values space and E.
12 Abort the RJE submission.

At the end of the job stream, the call type is set to E. UTMEX3 is called repeatedly until a return code of either 0 or 12 is given.

This allows for the insertion of multiple statements at the end of the job stream.

To modify a statement, place it in the statement work area addressed by the fourth parameter in the parameter list (+12), modify the statement there, and return with a return code 0.

UTMEX3 Conventions

The following table summarizes the UTMEX3 linkage conventions.

Feature Convention
Attributes Reentrant.
Type Thread.
Size No restrictions.
Registers at Entry
Register 1 Address of the parameter list
Register 13 Address of an 18-fullword save area
Register 14 Return address in the calling module
Register 15 Entry address of UTMEX3
Registers at Return Registers 12 through 14 must be unchanged.
Parameters
Word 1 Address of a return code halfword
Word 2 Address of the UTMSCOM data area
Word 3 Address of a flag byte indicating the type of call:
S Start of job submission (before first statement)
sp (space) standard call
E end of the submission (following the last statement)
Word 4 Address of the card image.
Word 5 Address of the area to be used when inserting statements (return code = 8)
Return Codes
0 Normal return. Process the next statement unless end-of-file.
4 Delete the current statement (valid only if call-type =space).
8 Insert a statement before the current card image. Statement to be inserted must be in an area pointed to by word 5 of the parameter area . This return code is valid only for call-types E and sp (space).
12 Abort the submission (HASP only).
Considerations
a Is called by U2TSUB, a subroutine of UTIMRM .
b Linkage is dynamic, with COLOAD.