EVENTING
File |
40 |
Statement |
FIND or PROCESS , depending on
value in FUNCTION field.
|
Task |
Allows communication between Natural programs or Natural
applications. This DDM enables Natural programs to send data to and receive
data from other Natural programs.
|
Relevant Error Codes
Code |
Text |
600 |
Unknown function. |
745 |
Error occurred when executing Eventing |
809 |
Subsystem not active. |
886 |
Event is in use. |
887 |
Event is already defined. |
888 |
Event name must be specified. |
890 |
Event does not exist. |
891 |
Timeout waiting for event. |
894 |
Enable eventing failed. |
986 |
No or not enough space for EVENTING MEMORY
POOL
|
Field Descriptions
Dictionary Field Name |
Format/
Length/ Desc/
Mu
|
Description
|
EVENT-NAME |
(A8) |
Name of the event. |
|
D |
|
FUNCTION |
(A8) |
Required. Specifies the action to be performed. Possible
values:
|
|
D |
DEFINE Define an event |
|
|
DELETE Delete an event |
|
|
LIST List events |
|
|
POST Post event |
|
|
RECEIVE Receive messages from event |
|
|
SEND Send message to event |
|
|
SENDPOST Both SEND and POST |
|
|
WAIT Wait for post of event (or timeout) |
MAX-TIME |
(B4) |
Maximum time (in seconds) you want to wait for a message
to arrive. If no message arrives within this time you will get ERROR-CODE 891
(timeout).
|
|
D |
|
MESSAGE-ARRAY |
(A250) |
Array of maximum 7 messages for SEND/RECEIVE
functions.
|
|
D |
|
|
M/7 |
|
NUMBER-OF-MESSAGES |
(N5) |
Number of messages waiting to be received. |
NUMBER-OF-WAITERS |
(N5) |
Number of tasks waiting to be posted. |
Which fields are relevant with which statement depends on the
FUNCTION specified. Matrix of statements, fields and functions: Key:
R=Required, U=Unique, D=Descriptor
PROCESS Statement |
Functions |
Fields |
DEFINE |
DELETE |
SEND |
WAIT |
POST |
EVENT-NAME |
RUD |
RUD |
RUD |
RUD |
RUD |
MAX-TIME |
|
|
|
UD |
|
MESSAGE-ARRAY |
|
|
RUD |
|
|
FIND Statement |
Functions |
Fields |
RECEIVE |
LIST |
EVENT-NAME |
RUD |
D |
NUMBER-OF-WAITERS |
|
D |
MESSAGE-ARRAY |
D |
|
NUMBER-OF-MESSAGES |
|
D |