8.5.7 Execute a Specified Function
The following details may be entered for the 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 .
- 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.