Execute a Specified Function

The following details may be entered for the Execute a specified function event notification method:

Function name

Specifies the name of a user-defined function that is to be executed.

 

Note:  To make use of this notification method, you will need access to LANSA development tools and skills in order to code, compile and install the necessary user-defined function.

Note the following about the function to be called:

• The function must be installed in the LANSA Composer server system in the partition containing LANSA Composer (normally LIC).

• The function must be coded using RDMLX.

• The function must have been compiled in a LANSA development environment that is at a level that is compatible with the LANSA Composer system.

• The function must be defined with options(*DIRECT).

• The function must not directly invoke any LANSA Composer entry point.  For example, it must not attempt to (directly) execute another Processing Sequence.

Before the function executes, LANSA Composer will populate the exchange list with the following fields that the function may reference, if desired:

DXEVID	A(10)	Event name
DXEVII	A(32)	Event internal identifier
DXP1ID	A(10)	Processing sequence name
DXP1II	A(32)	Processing sequence internal identifier
DXPVRN	A(15)	Run number as a character string
DXL1NO	P(15, 0)	Run number
DXL3MN	A(7)	Last error number, if any
DXL3SD	A(80)	Last error short text description, if any
DXL3TX	S(512)	Last error long text description, if any

An example of a user-defined event handler function is supplied in the LANSA Composer development package in process DXSXTC, function DXEVEN1.  Refer to Before you begin your custom activity .for information on how to locate and import this package into your LANSA development environment.