Run scheduling - Schedule information
When a user runs a function that is defined in M3 BE Job Scheduler with scheduling allowed, two new panels are displayed for the user before the job is submitted. These are panels (SHS230/E) and (SHS231). Here, the user decides the times and frequency with which the function is run.
The function will be scheduled to run at the dates, times, and frequency that you specified. The information about when the function is run is stored in CSHHED and CSHDAT.
- Select a function that is defined in M3 BE Job Scheduler (with scheduling allowed). Panel E in 'Job Schedule Information. Open' (SHS230) is displayed.
-
Specify this information on the E panel:
- Schedule type
- Select which type of run to define. The selected value controls which fields should be open on (SHS230/E).
- Time zone
- Select the time zone to define the schedule. The default value of the
field is the user time zone, but the field is open for input. The date or date
limits that are specified in (SHS230) are entered in the defined time zone. If the
time zone field is left blank, the information is interpreted as if it is in system
time. This is the same behavior that the program had before the time zone field was
added.
Using the time zone field and the information specified on the panels, the information is translated to system time in order to schedule the job. The actual schedule times are always saved in system time.
If using a job calendar, it is assumed that the job calendar refers to the dates in the time zone entered. This means that using the same job calendar will result in different schedule times if different time zones are used in 'Job Schedule Information. Open' (SHS230) or 'Job Schedule Entry. Update' (SHS010). The date and time limits are also translated to correspond to the specified time zone.
For externally scheduled jobs, no time zone can be specified. You can instead send in a time zone when you trigger the external job from the SHS010MI transaction ExecuteJob. Sending in a time zone to this transaction means that you specify which time zone the schedule date fields are in.
- Now
- Select this check box for the job to run immediately. This is only possible if the Job Schedule allowed field was set to 1 for this function. The job would then run as normal.
- Today
- Select this check box for the job to run on the current date at a scheduled time.
- Every year
- Select this check box to repeat the job once every year.
- In month
- Specify the number for the month that the yearly scheduled job should run.
- Every month
- Select this check box to repeat the job every month.
- On day
- Specify one of these two-digit values for the job to run on a specific
day:
- 01-28: The job will run on the specified day each month.
- 29-31: The job will run if the day exists in the month.
- 98: The job will run on the last calendar day of the month.
- 99: The job will run on the day designated as the period end date according to the period type in the function header. If the job is scheduled yearly, 99 is not allowed.
- Next Monday - Next Sunday
- Select one of these check boxes for the job to run once on the next occurrence of the specified day and at a scheduled time.
- Every Monday - Every Sunday
- Select one of these check boxes for the job to run on a weekly basis on the specified day.
- Specific date
- Specify a specific date when the job is set to run.
- Rec action
- Recovery action indicates whether the job is started later if the system was down when it should be run, or whether it should wait until the next time to run (if it is scheduled to be run several times).
- Job schedule calendar
-
To schedule a run on irregular dates, set this up by using a job schedule calendar. In 'Job Schedule Calendar. Open' (SHS060) schedule dates are generated by using similar selections as in (SHS230). In addition, you can generate schedule dates considering 'Day type' when 'Every month' is set.
For example, a job schedule calendar for the last working day in every month can be achieved by setting 'Day type' to 2-'Working days' and 'On day' to 98.
In 'Job Schedule Calendar. Open Detailed' (SHS061), you can freely add or delete schedule dates from the job schedule calendar.
- Schedule interval
- Specify the interval for how
often the program should run within a day. Lowest possible value is 30 minutes, that
is, the job will run every 30 minute until the 'To-time' in 'Job Schedule
Category. Open' (SHS050) or, if no 'To-time' is specified, until
midnight. Highest possible value is the time remaining (in minutes) to the 'To-time'
or to midnight, that is, at least one additional occurrence of the program must run
within the day.
This alternative is only valid for a repetitive scheduling where 'Schedule type' is set to 2-'Repetitive'.
- Time
- Specify the time to release the job from the scheduler to the job queue.
Note: The job will not actually start at the specified time; this will depend on whether other jobs are ahead of it in the job queue. The time must be within the limits defined for the job category attached to this function.
- Description
- Specify a description of the job, for example 'Month end statement run' or 'Daily picking lists.'
- Press Next. (SHS231/B) panel is displayed.
-
Open the E panel for all fields and specify this information:
- Movement
Indicates the movement for the date.
- Add value and subtract value
Indicate a number to add or subtract to the date, based on days for normal dates and periods for period dates, in order to arrive at a new date or period. Does not apply to fixed dates.
- Movement