Broker 10.5 | webMethods Broker Documentation | webMethods Broker Client C API Programmer's Guide | Creating and Initializing Events | Specifying Field Names
 
Specifying Field Names
Many of the functions offered by the BrokerEvent class require a field name parameter. How you specify a field name depends on the type of field being referenced and the function being used. The following example shows a hypothetical event type that contains several different types of data fields.
Note:
Event field names are case sensitive.
Sample::StructEvent {
string title;
float seqA[];
int seqB[][];
struct structA{
BrokerDate date;
int seqC[] [];
}
struct structB{
BrokerDate time;
struct emp {
string name;
string ssn;
}
}
struct structC[] {
BrokerDate date;
int seqD[] [];
}
}
The following table shows the field names you could specify to reference the various fields within the event type shown in this example.
Field Name
Description
Related BrokerEvent Functions
title
The BrokerString value.
seqA
The entire sequence of float values.
seqA[0]
First float value in seqA
seqA[]
Used to obtain the field's type when the number of elements in the sequence is not known.
seqB[0][0]
First int value in seqB.
seqB[][]
Used to obtain the field's type when the number of elements in the sequence is not known.
structA
The entire structA structure.
structA.date
BrokerDate value within structA.
structA.seqC[0][0]
First int value in seqC, within structA.
structA.seqC[][]
Used to obtain the field's type when the number of elements in the sequence is not known.
structB
The entire structB structure.
structB.time
BrokerDate within structB.
structB.emp
The structure within structB.
structB.emp.name
The BrokerString within the emp structure, within structB.
structC
The entire structure sequence structC.
structC[0].date
BrokerDate within the first structure in the structC sequence.
structC[].date
Used to obtain the field's type when the number of elements in the sequence structC is not known.
structC[0].seqD[0][0]
First int value in seqD, within the first structure in the structC sequence.
structC[].seqD[][]
Used to obtain the field's type when the number of elements in the sequences structC and seqD are not known.