Skip to end of metadata
Go to start of metadata

Introduction

  • Jobs in a workflow can be limited to start execution in specific periods only.
    • A job can be configured to start not earlier than e.g. 10pm. If an order arrives earlier then the order has to wait until 10pm.
    • In addition, a period can be specified to define a timeslot, e.g. from 10pm to 11pm, during which the job can be started. Note that the timeslot limits the start time of the job, a job that is started before end of the period can continue to run even if the period is exceeded. Users who want to limit the execution time of a job should use the Timeout attribute, see JS7 - Job Instruction.
  • Such limits are considered Admission Times ("opening hours") and can be adjusted per day of week. For example, a job can be configured for an earliest start time for Monday at 10pm and for Saturday at 2pm.
  • Multiple periods per weekday can be configured.
  • A period can exceed midnight of the current day, it can be configured to span a number of days. The maximum period is one week.

Orders meeting Admission Times

The following behavior applies when an order arrives with a job node in a workflow:

  • If an Admission Time has been configured for the date for which the order is scheduled and
    • the order arrives before begin of the Admission Time then the order will wait until the Admission Time is reached.
    • the order arrives during the Admission Time then the order will immediately start the respective job.
    • the order arrives after the end of the Admission Time then the order will wait for the next Admission Time, for example a later Admission Time on the same day or on a later day.
  • If an Admission Time has been configured but does not include the day of week for which the order has been scheduled then
    • the order will skip the job and will continue with the next instruction in the workflow.
  • If no Admission Time has been configured then
    • the job will be executed at any point in time depending on the arrival time of the order with the job node in the workflow.

Examples:

  • An order with ID #2021-09-08#P0000003730-forklist is scheduled for 8th of September 2021 - which is a Thursday.
    • If the job is configured to use an Admission Time on Thursday and Friday from 10pm to 11pm then 
      • if the order arrives before 10pm it will wait until 10pm to start job execution.
      • if the order arrives at 10.30pm it will immediately start job execution.
      • if the order arrives at 11.30pm it will wait until Friday 10pm to start job execution.
    • If no Admission Times are configured then the job will execute immediately on arrival of an order.
  • An order with ID #2021-09-07#P0000003730-forklist is scheduled for 7th of September 2021 - which is a Wednesday.
    • If the job is configured to use an Admission Time on Thursday and Friday but not on Wednesday then
      • the order will skip the current job and continue with the next workflow instruction.

Job Configuration

Configuring Admission Times

Admission Times can be configured from the Job Property Editor in a workflow. The tab Job Options displays a link Show Periods for Admission Times.



When clicking the Show Periods link from the above screen then the Job Property Editor displays Admission Times like this:



Explanation:

  • Users can select days of week for which the job should be executed.
    • For any weekdays not specified by an Admission Time the job will be skipped.
  • The start time and duration make up the period of the Admission Time
    • Users can select weekdays, add the start time and duration just once and hit the Add button to apply the same start time and duration to the selected weekdays.
    • Periods can be modified individually.
    • Per weekday multiple periods can be specified.

Configuring Admission Time Zone

Any date calculation for Admission Times is performed based on the Admission Time Zone specified with the workflow:



The Admission Time Zone default to the time zone specified with the user profile.

Behavior of Admission Times with Daylight Saving Change

During Daylight Saving Change to summer time, for example if the clock is moved forward from 2am to 3am, then the next available time is used, i.e. an order arriving at 2.30am will start job execution at 3am.

During Daylight Saving Change to winter time, for example if the clock is moved back from 3am to 2am, then the earlier time is used.





  • No labels
Write a comment…