Overview

Since FIXEdge 6.0 and FIXICC 2.10.1 new functionality of session schedule management has become available. This instruction provides the answers on how to upgrade your current sessions schedule in order to support new functionalitythe cron-like format of the schedule.

Please note, that new Scheduler functionality uses the same notion of schedule properties as old one:

• StartTime
• ConnectTime
• DisconnectTime
• TerminateTime

1.How to use

...

cron-like session's schedule functionality with CRON expressions

In order to use new schedule the cron-like schedule management functionality , then follow the steps below:

1. If you are going to use FIXICC as a tool for new cron-like schedule management, you need to specify the following setting in FIXEdge.properties:

   Code Block
   language bash linenumbers true
   FIXICC.Schedules = true

   Please use this FIXICC manual for details regarding new schedule the schedule management functionality available in FIXICC.

2. If you are not going to use FIXICC in terms of new cron-like schedule management functionality or/and you would like to configure sessions schedule via a configuration file, you may ignore "FIXICC.Schedules" property. Here are the steps which should be performed to configure the schedule via FIXEdge.properties:

1. 1. First of all, you need to define the Schedule entity in FIXEdge.properties. The common Schedule structure is defined in the following way:

      Schedules.<name of schedule>.<section of schedule> = <cron expression>[;<cron expression>....]

      Below is the example of how to setup some "default" session's schedule:

      Code Block
      language bash linenumbers true
      Schedules.Schedule1.StartTime = 0 0 8 * * 2-6 Schedules.Schedule1.ConnectTime = 0 0 9 * * 2-6 Schedules.Schedule1.DisconnectTime = 0 0 21 * * 2-6 Schedules.Schedule1.TerminateTime = 0 0 21 * * 6

   2. Then you need to assign the defined schedule to the specific session which should use it:

      Code Block
      language bash linenumbers true
      FixLayer.FixEngine.Session.TestFIXAcceptor.Schedule = Schedule1

Refer to NewCron-Style Like Session Schedule Properties article for details.

1.1. How to assign one schedule to several sessions

In case you have several sessions which that use the same schedule, you may assign one schedule to several sessions.

...

FixLayer.FixEngine.Session.TestFIXAcceptor1.Schedule = Schedule1
FixLayer.FixEngine.Session.TestFIXAcceptor2.Schedule = Schedule1

1.2. How to specify days off and time zone for my schedule

New session Cron-Like session schedule management functionality provides a possibility to specify Time Zone and Days Off to have a more flexible schedule.

Using these parameters you can get something like the following:

# catholic Christmas:
Schedules.Schedule1.DaysOff = * * * 25 12 *
# TimeZone:
Schedules.Schedule1.TimeZone = EST
# Schedule itself:
Schedules.Schedule1.StartTime = 0 0 8 * * 2-6
Schedules.Schedule1.ConnectTime =  0 0 9 * * 2-6
Schedules.Schedule1.DisconnectTime = 0 0 21 * * 2-6
Schedules.Schedule1.TerminateTime = 0 0 21 * * 6

2. How to use assign CRON expression to my current session's schedule

CRON expressions can be also assigned to your current sessions schedules defined in Old-Style Session Schedule Properties:

# weekly from Monday to Friday from 08:00 to 18:00
FixLayer.FixEngine.Session.TestFIXAcceptor1.ConnectTime = 0 0 08 * * 2-6
FixLayer.FixEngine.Session.TestFIXAcceptor1.DisconnectTime = 0 0 18 * * 2-6
FixLayer.FixEngine.Session.TestFIXAcceptor1.TerminateTime = 0 0 18 * * 6
 
# weekly from Monday to Friday from 08:00 to 21:00
FixLayer.FixEngine.Session.TestFIXAcceptor2.ConnectTime = 0 0 8 * * 2-6
FixLayer.FixEngine.Session.TestFIXAcceptor2.DisconnectTime = 0 0 21 * * 2-6
FixLayer.FixEngine.Session.TestFIXAcceptor2.TerminateTime = 0 0 21 * * 6

The same logic is applicable forto DefaultStartTime and DefaultTerminateTime properties.

FIXICC.Schedules = true

┌──────────── second (0 - 59)

│ ┌───────────── minute (0 - 59)

| │ ┌───────────── hour (0 - 23)
| │ │ ┌───────────── day of month (1 - 31)
| │ │ │ ┌───────────── month (1 - 12)
| │ │ │ │ ┌───────────── day of week (1 - 7: Sunday to Saturday)
| │ │ │ │ │

│ │ │ │ │ │

│ │ │ │ │ │

* * * * * *

# day session is from 8am to 2pm, evening session is from 4pm to 4am next day
FixLayer.FixEngine.Session.TestFIXAcceptor.ConnectTime = 0 0 8 * * *; 0 0 16 * * *
FixLayer.FixEngine.Session.TestFIXAcceptor.DisconnectTime = 0 0 14 * * *; 0 0 4 * * *
FixLayer.FixEngine.Session.TestFIXAcceptor.TerminateTime = 0 0 14 * * *; 0 0 4 * * *

FixLayer.FixEngine.Session.TestFIXAcceptor.StartTime = 0 0 8 * * *
FixLayer.FixEngine.Session.TestFIXAcceptor.ConnectTime = 09:00
FixLayer.FixEngine.Session.TestFIXAcceptor.DisconnectTime = 0 58 23 * * *
FixLayer.FixEngine.Session.TestFIXAcceptor.TerminateTime = 23:59

3. How to keep using my current session's schedule

In order to keep using your current session's schedule, no additional actions are required.

...

FixLayer.FixEngine.Session.TestFIXAcceptor.StartTime = 08:00
FixLayer.FixEngine.Session.TestFIXAcceptor.ConnectTime = 09:00
FixLayer.FixEngine.Session.TestFIXAcceptor.DisconnectTime = 23:58
FixLayer.FixEngine.Session.TestFIXAcceptor.TerminateTime = 23:59

Please see Old-Style Session Schedule Properties for reference.

Also, you may continue using properties DefaultStartTime and DefaultTerminateTime.