setevparam
Purpose:
-
Set an event with additional structure message data based on a specification file and provided index-value pairs.
Enter:
-
setevparam <eventname> <specfile> <index1> <val1> [index2] [val2] …
Where:
-
eventname
Specify the event name to set.
specfile
Specify the file that defines the structure of the event data.
index[x]
Optional. Specify the index indicating the structure element.
val[x]
Optional. Specify the value to store at the index.
Example:
-
setevparam reply_event /specs/event.spec 010424
The above command sets the event ‘reply_event’ and puts into the first index, index[0], a value of ’10’ and the element at 4 in the struct, index[4], a value of ’24’.
Sample spec file: short short long char short int short float
Details: With the above example and sample spec file, we would send that whole structure with the first short at the top being a 10 and the fifth element being a 24.
A sample of how the data would look being sent:
short = 10 short = 0 long = 0 char = 0 short = 24 int = 0 short = 0 float = 0
Notes:
-
You do not need to fill out the entire structure, just the elements you need. Also, if you specify an index, you must provide a value. Command line indexing starts at 0.