Namespace: Consultingwerk.SmartFramework.Scheduler
Interface 
ISchedulerService Copy to Clipboard
Parent classes:
Inherits: Progress.Lang.Object
Implemented by: Consultingwerk.SmartFramework.Scheduler.SchedulerService

File:ISchedulerService
Purpose:Interface for der Scheduler Service
Description:This Interfaces exposes the scheduler control to an
application developer
Author(s):Mike Fechner / Consultingwerk Ltd.
Created:Tue Jul 12 15:21:03 CEST 2016
Purpose: Determines the next planned execution time for the
given job plan
Notes: Only supported for recurring job plans

Navigate to: Methods | Constructors | Events | Properties | ProDatasets | Temp-Tables



Top Method Summary
Options Name Purpose
+ DATETIME-TZ GetNextExecutionTime (character, datetime-tz) Determines the next planned execution time for the given job plan
+ DATETIME-TZ GetNextExecutionTime (datetime-tz, SchedulerJobPlanningTypeEnum, integer, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, character, character, datetime-tz, datetime-tz) Determines the next planned execution time for the given job plan
+ LOGICAL HasJobStatusWithId (character) Returns whether a SmartSchedulerJobStatus with the given SchedulerJobStatusId exists
+ RescheduleFailedJob (character) Reschedules a failed job by copying it
+ Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, character, character, datetime-tz, ISerializable) Schedules a Job for scheduled one time execution
+ Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, character, character, datetime-tz, ISerializable, character) Schedules a Job for scheduled one time execution
+ Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, character, datetime-tz, ISerializable) Schedules a Job for scheduled one time execution
+ Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, character, datetime-tz, ISerializable, character) Schedules a Job for scheduled one time execution
+ Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, character, ISerializable) Schedules a Job for direct one time execution
+ Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, character, ISerializable, character) Schedules a Job for direct one time execution
+ Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, datetime-tz, ISerializable) Schedules a Job for scheduled one time execution
+ Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, datetime-tz, ISerializable, character) Schedules a Job for scheduled one time execution
+ Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, ISerializable) Schedules a Job for direct one time execution
+ Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, ISerializable, character) Schedules a Job for direct one time execution
+ SetJobStatusCancelSignal (character) Sets the signal to cancel a JobStatus
+ SetJobStatusOnHold (character) Sets a JobStatus OnHold. A job on hold can be later restarted
+ SetJobStatusResumed (character) Resumes a JobStatus that is on hold or to be cancelled


Method Detail
Top

PUBLIC DATETIME-TZ GetNextExecutionTime (character, datetime-tz)
Purpose: Determines the next planned execution time for the
given job plan
Notes: Only supported for recurring job plans

Parameters:
pcSchedulerJobPlanGuid CHARACTER
The job plan to return the next execution time for
pdtPreviousExecution DATETIME-TZ
The date-time-tz value identifying when the job was previously executed - or ? when the Job has never been executed so far
Returns DATETIME-TZ
The date and time when the job plan is due for the next execution
Top

PUBLIC DATETIME-TZ GetNextExecutionTime (datetime-tz, SchedulerJobPlanningTypeEnum, integer, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, logical, character, character, datetime-tz, datetime-tz)
Purpose: Determines the next planned execution time for the
given job plan
Notes: Only supported for recurring job plans. This method performs
the actual work. It is not accessing the Business Entity to
retrieve the Job Plan parameters. This allows to call into this
method from within the Job Plan Business Entity

Parameters:
pdtPreviousExecution DATETIME-TZ
The date-time-tz value identifying when the job was previously executed - or ? when the Job has never been executed so far
poPlanningType Consultingwerk.SmartFramework.Scheduler.SchedulerJobPlanningTypeEnum
The SchedulerJobPlanningTypeEnum value
piWeekInterval INTEGER
The week interval
plRecurringMonday LOGICAL
Plan includes Monday
plRecurringTuesday LOGICAL
Plan includes Tuesday
plRecurringWednesday LOGICAL
Plan includes Wednesday
plRecurringThursday LOGICAL
Plan includes Thursday
plRecurringFriday LOGICAL
Plan includes Friday
plRecurringSaturday LOGICAL
Plan includes Saturday
plRecurringSunday LOGICAL
Plan includes Sunday
plRecurringJanuary LOGICAL
The plan includes January
plRecurringFebruary LOGICAL
The plan includes February
plRecurringMarch LOGICAL
The plan includes March
plRecurringApril LOGICAL
The plan includes April
plRecurringMay LOGICAL
The plan includes May
plRecurringJune LOGICAL
The plan includes June
plRecurringJuly LOGICAL
The plan includes July
plRecurringAugust LOGICAL
The plan includes August
plRecurringSeptember LOGICAL
The plan includes September
plRecurringOctober LOGICAL
The plan includes October
plRecurringNovember LOGICAL
The plan includes November
plRecurringDecember LOGICAL
The plan includes December
pcRecurringDaylist CHARACTER
The list of days of month (relative to 1st or last day)
pcRecurringExecutionTimes CHARACTER
The list of planning times
pdtValidFrom DATETIME-TZ
The valid from date of the job plan
pdtValidTo DATETIME-TZ
The valid to date of the job plan
Returns DATETIME-TZ
The date and time when the job plan is due for the next execution
Top

PUBLIC LOGICAL HasJobStatusWithId (character)
Purpose: Returns whether a SmartSchedulerJobStatus with the given SchedulerJobStatusId exists
Notes:

Parameters:
pcJobStatusId CHARACTER
The SchedulerJobStatusId with which to check
Returns LOGICAL
Whether the SmartSchedulerJobStatus with the given ID exists
Top

PUBLIC RescheduleFailedJob (character)
Purpose: Reschedules a failed job by copying it
Notes:

Parameters:
pcSchedulerJobStatusGuid CHARACTER
The GUID of the SchedulerJobStatus to reschedule
Top

PUBLIC Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, character, character, datetime-tz, ISerializable)
Purpose: Schedules a Job for scheduled one time execution
Notes: Only creates an entry in the SmartSchedulerJobStatus table. An entry
in the SmartSchedulerJobPlan DB table is not required for one time
execution jobs

Parameters:
pcSchedulerJobName CHARACTER
The name of the scheduler job to execute
pcQueueCode CHARACTER
The name of the scheduler queue. May be empty
pcJobName CHARACTER
The name for the SchedulerJobStatus entry
pdtScheduleDateTime DATETIME-TZ
The date/time when the job should be executed
poJobParameter Consultingwerk.ISerializable
The serializable Job Parameter instance
Returns Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse
The IScheduleJobResponse describing the identifiers of the planned job
Top

PUBLIC Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, character, character, datetime-tz, ISerializable, character)
Purpose: Schedules a Job for scheduled one time execution
Notes: Only creates an entry in the SmartSchedulerJobStatus table. An entry
in the SmartSchedulerJobPlan DB table is not required for one time
execution jobs

Parameters:
pcSchedulerJobName CHARACTER
The name of the scheduler job to execute
pcQueueCode CHARACTER
The name of the scheduler queue. May be empty
pcJobName CHARACTER
The name for the SchedulerJobStatus entry
pdtScheduleDateTime DATETIME-TZ
The date/time when the job should be executed
poJobParameter Consultingwerk.ISerializable
The serializable Job Parameter instance
pcJobStatusId CHARACTER
The ID for the SchedulerJobStatus entry
Returns Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse
The IScheduleJobResponse describing the identifiers of the planned job
Top

PUBLIC Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, character, datetime-tz, ISerializable)
Purpose: Schedules a Job for scheduled one time execution
Notes: Only creates an entry in the SmartSchedulerJobStatus table. An entry
in the SmartSchedulerJobPlan DB table is not required for one time
execution jobs
Uses the default (blank) queue

Parameters:
pcSchedulerJobName CHARACTER
The name of the scheduler job to execute
pcJobName CHARACTER
The name for the SchedulerJobStatus entry
pdtScheduleDateTime DATETIME-TZ
The date/time when the job should be executed
poJobParameter Consultingwerk.ISerializable
The serializable Job Parameter instance
Returns Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse
The IScheduleJobResponse describing the identifiers of the planned job
Top

PUBLIC Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, character, datetime-tz, ISerializable, character)
Purpose: Schedules a Job for scheduled one time execution
Notes: Only creates an entry in the SmartSchedulerJobStatus table. An entry
in the SmartSchedulerJobPlan DB table is not required for one time
execution jobs
Uses the default (blank) queue

Parameters:
pcSchedulerJobName CHARACTER
The name of the scheduler job to execute
pcJobName CHARACTER
The name for the SchedulerJobStatus entry
pdtScheduleDateTime DATETIME-TZ
The date/time when the job should be executed
poJobParameter Consultingwerk.ISerializable
The serializable Job Parameter instance
pcJobStatusId CHARACTER
The ID for the SchedulerJobStatus entry
Returns Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse
The IScheduleJobResponse describing the identifiers of the planned job
Top

PUBLIC Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, character, ISerializable)
Purpose: Schedules a Job for direct one time execution
Notes: Only creates an entry in the SmartSchedulerJobStatus table. An entry
in the SmartSchedulerJobPlan DB table is not required for one time
execution jobs
Uses the default (blank) queue

Parameters:
pcSchedulerJobName CHARACTER
The name of the scheduler job to execute
pcJobName CHARACTER
The name for the SchedulerJobStatus entry
poJobParameter Consultingwerk.ISerializable
The serializable Job Parameter instance
Returns Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse
The IScheduleJobResponse describing the identifiers of the planned job
Top

PUBLIC Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, character, ISerializable, character)
Purpose: Schedules a Job for direct one time execution
Notes: Only creates an entry in the SmartSchedulerJobStatus table. An entry
in the SmartSchedulerJobPlan DB table is not required for one time
execution jobs
Uses the default (blank) queue

Parameters:
pcSchedulerJobName CHARACTER
The name of the scheduler job to execute
pcJobName CHARACTER
The name for the SchedulerJobStatus entry
poJobParameter Consultingwerk.ISerializable
The serializable Job Parameter instance
pcJobStatusId CHARACTER
The ID for the SchedulerJobStatus entry
Returns Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse
The IScheduleJobResponse describing the identifiers of the planned job
Top

PUBLIC Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, datetime-tz, ISerializable)
Purpose: Schedules a Job for scheduled one time execution
Notes: Only creates an entry in the SmartSchedulerJobStatus table. An entry
in the SmartSchedulerJobPlan DB table is not required for one time
execution jobs
Uses the default (blank) queue

Parameters:
pcSchedulerJobName CHARACTER
The name of the scheduler job to execute
pdtScheduleDateTime DATETIME-TZ
The date/time when the job should be executed
poJobParameter Consultingwerk.ISerializable
The serializable Job Parameter instance
Returns Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse
The IScheduleJobResponse describing the identifiers of the planned job
Top

PUBLIC Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, datetime-tz, ISerializable, character)
Purpose: Schedules a Job for scheduled one time execution
Notes: Only creates an entry in the SmartSchedulerJobStatus table. An entry
in the SmartSchedulerJobPlan DB table is not required for one time
execution jobs
Uses the default (blank) queue

Parameters:
pcSchedulerJobName CHARACTER
The name of the scheduler job to execute
pdtScheduleDateTime DATETIME-TZ
The date/time when the job should be executed
poJobParameter Consultingwerk.ISerializable
The serializable Job Parameter instance
pcJobStatusId CHARACTER
The ID for the SchedulerJobStatus entry
Returns Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse
The IScheduleJobResponse describing the identifiers of the planned job
Top

PUBLIC Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, ISerializable)
Purpose: Schedules a Job for direct one time execution
Notes: Only creates an entry in the SmartSchedulerJobStatus table. An entry
in the SmartSchedulerJobPlan DB table is not required for one time
execution jobs
Uses the default (blank) queue

Parameters:
pcSchedulerJobName CHARACTER
The name of the scheduler job to execute
poJobParameter Consultingwerk.ISerializable
The serializable Job Parameter instance
Returns Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse
The IScheduleJobResponse describing the identifiers of the planned job
Top

PUBLIC Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse ScheduleJob (character, ISerializable, character)
Purpose: Schedules a Job for direct one time execution
Notes: Only creates an entry in the SmartSchedulerJobStatus table. An entry
in the SmartSchedulerJobPlan DB table is not required for one time
execution jobs
Uses the default (blank) queue

Parameters:
pcSchedulerJobName CHARACTER
The name of the scheduler job to execute
poJobParameter Consultingwerk.ISerializable
The serializable Job Parameter instance
pcJobStatusId CHARACTER
The ID for the SchedulerJobStatus entry
Returns Consultingwerk.SmartFramework.Scheduler.IScheduleJobResponse
The IScheduleJobResponse describing the identifiers of the planned job
Top

PUBLIC SetJobStatusCancelSignal (character)
Purpose: Sets the signal to cancel a JobStatus
Notes: Requires the JobStatus of Running

Parameters:
pcSchedulerJobStatusGuid CHARACTER
The GUID of the SchedulerJobStatus to put on hold
Top

PUBLIC SetJobStatusOnHold (character)
Purpose: Sets a JobStatus OnHold. A job on hold can be later restarted
Notes: Requires the JobStatus of Scheduled

Parameters:
pcSchedulerJobStatusGuid CHARACTER
The GUID of the SchedulerJobStatus to put on hold
Top

PUBLIC SetJobStatusResumed (character)
Purpose: Resumes a JobStatus that is on hold or to be cancelled
Notes: Requires the JobStatus of OnHold or to be cancelled (Running and Cancel = TRUE)

Parameters:
pcSchedulerJobStatusGuid CHARACTER
The GUID of the SchedulerJobStatus to put on hold


©2006-2025 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       24.10.2025 08:46:59