UDP group

UDP is short for User Defined Property. An UDP group is a group of stations in a exchange, which can be used with the Event Handler to construct rules that applies to many stations. There are 8 UDP groups available.

An EventHandler rule can refer to an UDP group in the condition part. Both the "owner" and the "related-to" condition of a rule can refer to a UDP group.

By default all stations are included into UDP group 8. UDP groups 1 - 7 are empty. UDP groups are edited in AlphaPro by entering the Station page, select "UDP" tab.

With UDP based rules, you will usually need to use the "context parameters" %1 and %2 to refer to the stations which triggered the particular instance of the event.

Example of usage

Control room: One UDP group for the Control Room master stations. Second UDP group lists all the sub stations which Control Room is supervising. Applications will typically use EventHandler rules to make things happen for Events, where the the Owner is in the Control Room, and the Related-To is in the Sub-station group.

Limitations

• UDP groups can only be used with the EventHandler.
• UDP groups can not have a directory number.
• UDP groups can not be used with Audio_(Event_Type)

History

UDP groups was made a separate concept from the groupcall station groups due to performance reasons. Performance was a major design constraint on the original MC68000 based AMC board. UDP membership is stored as a single byte per station. One bit for each UDP membership. So in order to test if a incoming station event matches a UDP rule, the EventHandler just needs to do a bitwise AND of the UDPs of the Event and the Rule. This also makes it easy to work across exchanges in AlphaNet. The UDP bitmap for the calling station is just copied to the payload of AUDIO_PATH_SETUP (param#13).

Groupcall groups are on the other hand stored as bitmaps the other way, an array of groups, each element is a bitmap of the member stations. And there is a large number of groups (currenly 100). This would complicate both Eventhandler matching, and handling in AlphaNet, if EventHandler was to use groupcall groups.