User Exits and Macros › Installing User Exits › Using the TLMXBGN Macro for User Exits

Using the TLMXBGN Macro for User Exits

TLMXBGN is a supplied macro for use in generating user exits for CA TLMS. Macro TLMXBGN ensures the current environment and provides the following standard functions for the systems programmer responsible for coding CA TLMS user exits:

• Generates entry and exit logic
• Establishes addressability and base registers
• Performs save area logic
• Equates registers
• Names CSECTs and provides "eye-catchers"
• GETMAINs save area and work area for the exit

Parameters which are supplied to the TLMXBGN macro are:

name TLMXBGN BASE=,EXIT=,LIST,RETURN=,SA=,WS=,SP=

name

Begins in position 1 and is the exit name, such as TLMSXC.

TLMXBGN

Begins in position 10 and identifies this macro.

BASE

Identifies the program base registers (2-12). Up to four are supported.

EXIT

Is the label for the R15 return code exit (user loads R15).

LIST

If specified, macro options are listed inline.

LS.

RETURN

Is the label for the zero return code exit.

SA

Is the label for the save area and exit work area DSECT.

SP

Is the subpool number of GETMAIN for WS.

Default: zero

WS

Is the size of GETMAIN for working storage. The default is 72 bytes for save area, and is always first. Register 13 is the first base register for the work area.