Unlike standard events such as Click or Initialize, user-defined events can also receive values. To specify the value to be passed to the event, add a DEFINE_MAP statement after the DEFINE_EVT statement.

Let's use a form called Form B as an example. It has a user-defined event EMPLOYEE_CREATED which is signaled when the user has created a new employee record. The DEFINE_MAP statement defines that the event will also receive the employee number of the newly added employee.

This is the DEFINE_EVENT block in Form B:

define_evt name(employee_created)

define_map *input class(#empno) name(#this_emp)

FormB also has a SIGNAL command which signals that the event has been triggered and passes the employee number of the new employee to the event routine:

signal event(employee_created) this_emp(#empno)

The owner form of  Form B has an event routine for the employee_created event which receives the employee number and maps it to a variable #TheValue and then assigns this value to field #empno on the owner form.

EVTROUTINE HANDLING(#FormB.employee_created) this_emp(#TheValue)

   set com(#empno) value(#TheValue)