Description
The EvntGrp is a repeating subcomponent of the Instrument component used to specify straightforward events associated with the instrument. Examples include put and call dates for bonds and options; first exercise date for options; inventory and delivery dates for commodities; start, end and roll dates for swaps. Use ComplexEvents for more advanced dates such as option, futures, commodities and equity swap observation and pricing events.
The EvntGrp contains three different methods to express a "time" associated with the event using the EventDate <866> and EventTime <1145> pair of fields or the EventTimeUnit <1827> and EventTimePeriod <1826> pair of fields or EventMonthYear <2340>.
The EventDate <866>, and optional EventTime <1145>, may be used to specify an exact date and optional time for the event. The EventTimeUnit <1827> and EventTimePeriod <1826> may be used to express a time period associated with the event, e.g. 3-month, 4-years, 2-weeks. The EventMonthYear <2340>, and optional EventTime <1145>, may be used to express the event as a month of year, with optional day of month or week of month.
Either EventDate <866> or EventMonthYear <2340>, and the optional EventTime <1145>, must be specified or EventTimeUnit <1827> and EventTimePeriod <1826> must be specified.
The EventMonthYear <2340> may be used instead of EventDate <866> when month-year, with optional day of month or week of month, is required instead of a date.
Structure
| Tag | Field Name | Req'd | Comments | |
|---|---|---|---|---|
| 864 | NoEvents | N | ||
| → | 865 | EventType | N |
Required if NoEvents <864> > 0. |
| → | 866 | EventDate | N |
Conditionally required when EventTime <1145> is specified. |
| → | 1145 | EventTime | N | Specific time of event. To be used in combination with EventDate <866> |
| → | 1827 | EventTimeUnit | N |
Conditionally required when EventTimePeriod <1826> is specified. |
| → | 1826 | EventTimePeriod | N |
Conditionally required when EventTimeUnit <1827> is specified. |
| → | 2340 | EventMonthYear | N | |
| → | 867 | EventPx | N | |
| → | 868 | EventText | N | |
| → | 1578 | EncodedEventTextLen | N |
Must be set if EncodedEventText <1579> field is specified and must immediately precede it. |
| → | 1579 | EncodedEventText | N |
Encoded (non-ASCII characters) representation of the EventText <868> field in the encoded format specified via the MessageEncoding <347> field. |