EVENT action

Function

Synchronous/asynchronous starting of a subevent.

Declaration

EVENT eventIdent [(pubLoc1=param1, pubLoc2=param2, ... , pubLoc10=param10)] [ASYNC]

Parameters

eventIdent	in	Identifier of a Event type object.
pubLoc1, pubLoc2, ..., pubLoc10	in	Local variables of PUBLIC type in the called event, the specified parameters will be assigned to.
param1, param2, ..., param10	in	Local variables - their values will be assigned to the local variables of PUBLIC type.

Description

Before the subevent starts there are automatically filled:

values of PUBLIC local variables.
the predefined variables _FROM_HIP, _HIP_PAR_STR, _HIP_USER_DESC according to the script called.

Without the key word ASYNC, the subscript is to be started synchronously. The action EVENT is terminated after the subevent termination. Values of PUBLIC local variables are to be assigned to the called event (IN OUT parameters in principle). If the called event is terminated by an error, the calling event is not terminated and continues in the execution of next action.

For asynchronous calling an event (the key word ASYNC), the calling event doesn't wait for the termination of the running event.

When you using local variables of RECORD type, it is necessary that the types of the variables must be the same in the called and calling events, in regard to the NOALIAS attribute.

Examples

Asynchronous calling of script (no parameters)

 ;script that calls
 BEGIN
 MESSAGE "script began" ON srvskol1v.HIP
  EVENT E.podevent ASYNC
 MESSAGE "script ended" ON srvskol1v.HIP
 END

 ;called script "E.podskript"
 BEGIN
 MESSAGE "subscript began" ON srvskol1v.HIP
 DELAY 200[ms]
 MESSAGE "subscript ended" ON srvskol1v.HIP
 END

Synchronous calling of subscript (no parameters)

 ;script that calls
 BEGIN
  MESSAGE "script began" ON srvskol1v.HIP
  EVENT E.podevent
 MESSAGE "script ended" ON srvskol1v.HIP
 END

 ;called script "E.podskript"
 BEGIN
  MESSAGE "subscript began" ON srvskol1v.HIP
 DELAY 100[ms]
 MESSAGE "subscript ended" ON srvskol1v.HIP
 END

Related pages:

Public local variables
Script actions