<EvntGrp> Component Block

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.

Used in :

Tag Field Name FIXML Req'd Comments
864 NoEvents Evnt N

Number of repeating EventType entries.

=> 865 EventType @EventTyp C

Required if NoEvents(864) > 0.

=> 866 EventDate @Dt N

Conditionally required when EventTime(1145) is specified.

=> 1145 EventTime @Tm N

Specific time of event. To be used in combination with EventDate [866]

=> 1827 EventTimeUnit @TmUnit N

Conditionally required when EventTimePeriod(1826) is specified.

=> 1826 EventTimePeriod @TmPeriod N

Conditionally required when EventTimeUnit(1827) is specified.

=> 2340 EventMonthYear @MoYr N

Used with derivatives when an event is express as a month-year with optional day or month or week of month.

Format:

YYYYMM (e.g. 199903)

YYYYMMDD (e.g. 20030323)

YYYYMMwN (e.g. 200303w2) for week

A specific date can be appended to the month-year. For instance, if multiple event types exist in the same Year and Month, but actually at a different time, a value can be appended, such as "w" or "w2" to indicate week. Likewise, the day of monty (0-31) can be appended to indicate a specific event date.

=> 867 EventPx @Px N

Predetermined price of issue at event, if applicable

=> 868 EventText @Txt N

Comments related to the event.

=> 1578 EncodedEventTextLen @EncTxtLen N

Must be set if EncodedEventText(1579) field is specified and must immediately precede it.

=> 1579 EncodedEventText @EncTxt N

Encoded (non-ASCII characters) representation of the EventText(868) field in the encoded format specified via the MessageEncoding(347) field.