UTMEX3 - Timer Monitor RJE Exit

#### Search Results

Search

# 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

- UTMEX3 Conventions

## 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.

### On this page

- How to Use UTMEX3
- UTMEX3 Conventions