Recurring Task Management
Use this function to define recurring tasks that are launched regularly by the batch server. These recurring tasks are run based on a defined schedule. This includes batch tasks or linked batch tasks. You can define all or part of the settings linked to the task execution rules such the current period and frequency.
For Accounting batch tasks
If the MULBATCH – Multi-instance batch task parameter (CPT chapter, ACC group) is set to Yes, you can create one accounting task per line in the Accounting task function (GESBTC). Each task is linked to a unique recurring task linked to the correct folder. For each task, you can define the Periodicity and Time range.
If the MULBATCH – Multi-instance batch task parameter (CPT chapter, ACC group) is set to No, there is only one accounting task. You cannot modify the Periodicity and Time range. Your only option is to enter the No. of records.
You cannot change the Active status of an accounting recurring task in this function. This can only be done in the Journal status monitor function (VALPCE).
Prerequisites
Refer to documentation Implementation
Screen management
Entry screen
Here are entered both the launch conditions (identification of the folder and the user under whose identification the recurring task is launched) and the concerned times.
Block number 1
Recurring task code (field CODABT) |
It identifies the recurring task code. |
Description (field NOMABT) |
Title associated with the previous code. |
Characteristics
Folder (field DOSSIER) |
It defines the name of the folder in which the request will be launched (the current folder code is proposed by default). |
User code (field USER) |
It defines the code of the user under whose identity the task will be launched (the code of the current user is proposed by default). |
Password (field PASSE) |
When the folder or task to be executed is not the current one, or if the user does not correspond to the current user code, it is necessary to enter the corresponding password in order to identify oneself. |
Group (field GRP) |
It defines a group of tasks to be launched. |
Task code (field TACHE) |
It defines the code of the task that will be launched automatically by the batch server. |
Language (field LAN) |
Block number 3
Active (field ENAFLG) |
Select this check box to activate the current record. Disabled records keep their content and setup but cannot be used by recalling their code:
The authorizations for a given function can prohibit the creation of an active record. In this case, the check box is disabled by default. It can only be modified by an authorized user or through a signature workflow. |
Last execution (field DJOUR) |
When the recurring task has already generated task executions, this field makes it possible to know the last execution date. |
Periodicity
Periodicity (field PERIO) |
This field defines the task execution frequency. If the period is monthly, it is possible to indicate one day of the month (date in the month ranging between 1 and 31) and/or check the end of month box. If the period is weekly, it is necessary to check one or more days of the week. |
Excluded days (field CAL) |
Enter a calendar code to exclude specific days from the execution of recurring tasks. |
Weekly
field JOUR |
Select the day or days of the week to run a task the same day or days each week. For accounting tasks: If the MULBATCH – Multi-instance batch task parameter (CPT chapter, ACC group) is set to , you can enter a unique value for each recurring task. |
Monthly
Days of the month (field QUANT) |
If you selected Monthly, you can indicate one day of the month, ranging between 1 and 31, and/or select the Month end check box. For accounting tasks: If the MULBATCH – Multi-instance batch task parameter (CPT chapter, ACC group) is set to , you can enter a unique value for each recurring task. |
Month end (field FDM) |
If you selected Monthly, select this check box to run the task on the last day of each month unless the date is excluded by the calendar code. For accounting tasks: If the MULBATCH – Multi-instance batch task parameter (CPT chapter, ACC group) is set to , you can enter a unique value for each recurring task. |
Time range
Start time (field HDEB) |
Enter start and end times to limit running the task to between that time range. For accounting tasks: If the MULBATCH – Multi-instance batch task parameter (CPT chapter, ACC group) is set to , you can enter a unique value for each recurring task. |
End time (field HFIN) |
Frequency (min) (field FRQ) |
Enter the number of minutes between multiple iterations of a task. For example, if the first run does not process all the No. of records set, the task runs again after the number of minutes entered here. For accounting tasks: If the MULBATCH – Multi-instance batch task parameter (CPT chapter, ACC group) is set to , you can enter a unique value for each recurring task. |
One single query (field ONE) |
This box can be checked if the recurring task is frequency defined. If it is checked, a single request is launched every day in order to execute the requested process, and as soon as the process is completed, the task is put on hold for the number of minutes defined by the frequency, then the execution is resumed until the end time is exceeded. The request is then displayed in the In process report for the whole execution interval. This ensures that the request is always stored in the memory once it will have been launched, which can be detrimental to other tasks if the maximum number of tasks launched simultaneously has been reached. |
Purge (field EPUR) |
This check box can only be selected for a recurring task with a defined frequency. In this case, no record of the successive executions of the task is kept in the request management function. Only the request in progress and the previous one are kept in the corresponding table. |
Proceed if error (field CNTERR) |
If this check box is selected, a recurring task is launched again even if there is an error. |
Fixed hours
Time (field HEURE) |
In case of a not frequency defined task, it is possible to launch this task at three different times in one day, as mentioned here. |
Forced execution (field FORCE) |
This check box can only be selected if fixed execution times are indicated for a recurring task. It ensures that the execution request is created, even if if the time is exceeded at the moment when the batch server processes the recurring tasks for the day. For instance, if a task is planned for 07:00, 10:00 and 15:00, but the batch server starts in the morning at 08:00:
|
Grid Relative date
Date field (field DATZON) |
Used to enter the screen zone name to initialize. |
Base date (field DATDEP) |
Used to enter the reference date for the calculation. |
Increment (field DATNBR) |
Number to add to (or withdraw from) the reference date. |
Time unit (field DATJRS) |
Time unit |
Formula (field DATFRM) |
Used to enter a formula that will be applied in the parameter entry environment of the batch task reccuring journal entry: open tables, global variables, user variables, etc... |
Specific Buttons
Parameters |
This action opens the parameters for the task. When a group of tasks is launched, an intermediate window opens where you can choose the task and its settings.
|
Menu Bar
Select this option to restart the recurring task if the times defined include the current time, and if the task is not already running.
|
Technical operation of the recurring tasks
When starting the batch server (or after midnight, when the batch server operates continuously), all the recurring tasks in a day are created in the form of task execution requests that can be seen in batch task management.
For recurring tasks with a defined frequency, a single execution request is created; when the task is executed, a new execution request is created.
This means once the first execution for a recurring task with a defined frequency is launched:
- In the request management, any interruption (if it is in progress), or deletion (if it is pending) of the next execution stops the process, which will be launched again the following day.
- By default, any modification to the frequency will not be taken into account until the following day.