Constructor.

Destructor.

Gets System Agent conditions that must be satisfied before a sending attempt.

Verifies that the schedule information stored in specified messages is the same as that on the task scheduler.

Connects to and registers with the task scheduler.

Second phase constructor.

This constructor creates instances of the following classes: CMsvScheduleSettings, CMsvOffPeakTimes, CMsvSendErrorActions, CMsvSysAgentActions and CMsvScheduledEntries.

Creates a new schedule on the task scheduler with which each message can be associated.

The schedule is triggered by a start time being reached.

RScheduler::CreatePersistentSchedule

Creates a new schedule on the task scheduler with which each message can be associated.

The schedule is triggered by either a set of conditions being met or a timeout being reached.

RScheduler::CreatePersistentSchedule TSysAgentCondition

Delete the schedules for the specified messages from the task scheduler.

The messages themselves are not deleted.

Does the actual scheduling of the supplied messages.

This function is called by ScheduleL() and DoReScheduleL(). The supplied messages are assumed to have the values for the following data - MTM UID, off-peak flag, schedule date and pending conditions flag. In debug mode, if these info is matching in all the messages then a panic will occur.

Searches the scheduler for an existing schedule item with a schedule time that matches with time supplied.

Searches the scheduler for an existing conditions schedule item with a set of pending conditions and timeout value that matches with those supplied.

Gets the schedule data and recipients of a message.

Recipient information is MTM-specific, so the server MTM must provide a derived class that implements CMsvScheduledEntry, and return objects of that type from this function.

Determines whether the message should be sent and if so the time interval (in seconds) that must elapse before aMessage should be sent.

The time interval is determined by the error action supplied. In the case of an error action of ESendActionRetryConditionMet, the time interval indicates how long the message can be pending conditions to be met before the message is failed.

The actual time period is defined in the iSettings object. This will be either iPendingConditionsTimeout, iShortInterval, iLongInterval or an element of iVariableIntervals.

If the message should be sent then a value of ETrue is returned. A value of EFalse is returned if the message should not be sent. In this case the output argument aInterval is not valid.

Loads schedule settings from CenRep

Gets off-peak times settings.

Determines when the messages should be re-scheduled on the task scheduler, then schedules the messages at the new time(s).

Messages that are successfully re-scheduled are updated. The pending conditions flag indicates whether the message has been schedule for a set of conditions being met (or a timeout occuring) or scheduled for a specified time/date.

NOTE - conditions scheduling is only supoprted from 8.1 onwards.

In the case of time-scheduling, the date field is the scheduled time/date. In the case of conditions-scheduling, the date field reflects the timeout value.

There are several cases when messages are not re-scheduled. If all recipients have been sent to - in this case the message's sending state set to KMsvSendStateSent. If, more commonly, the message's maximum number of re-tries has been exceeded or the error action was ESendActionFail then the message is not changed.

Utility function that rounds a specified time up to the nearest minute.

Adds an entry to an existing schedule.

Schedules aMessage on the schedule referred to by aRef.

Updates the message entry and the schedule data using the utility function UpdateEntryAfterSchedule().

CMsvScheduleSend::UpdateEntryAfterSchedule

Schedules messages on the task scheduler.

Messages that are successfully scheduled have their sending state set to KMsvSendStateScheduled.

Gets scheduler settings.

Gets action-on-sending-error settings.

Tells the scheduler that sending is complete.

This function must be called when a message that had previously been scheduled is either sent or has failed. This function:

1. Deletes the TMsvEntryScheduleData associated with the message

2. Sets the Scheduled flag to EFalse

3. If required, calls ChangeEntry() on the message server entry

Note: SendingCompleteL() does not change the sending state of each message, nor delete each message from the task scheduler.

Tells the scheduler that sending is complete.

This method sets the messages's scheduled flag to false, resets the schedule data associated with each message and the number of retries for each recipient and stores the data and recipients in a stream associated with the TMsvEntry.

Determines the schedule time for a message.

The schedule time is determined by the error action. If no error action is supplied, then the error action is obtained from the iErrorActions. This is a list of error codes associated with an error action. The error code with which the message failed to be sent is used to determine the error action from this list.

This function also increments the number of re-tries that the message has undergone.

A value of ETrue is returned if the message can be sent or a value of EFalse if the message cannot be sent.

If the message can be sent, then its schedule date and pending conditions flag are updated.

CMsvScheduleSend::ReScheduleL().

Sorts the supplied array of messages.

The messages are sorted by their schedule date (held in the iEntry.iDate member of CMsvScheduledEntry). Messages with the same schedule time are then further sorted by if they to be scheduled for pending conditions.

Utility function that updates message index entry fields to reflect the message's scheduling.

The System Agent conditions that must be satisfied before a sending attempt.

The Server MTM specific actions to take when particular errors occur during message sending.

The Server MTM specific off peak time periods.

Scheduling options.

Indicates if this has been registered with the Task Scheduler.

Initially set to EFalse.

Array of message schedule data.

Array of schedule entry data.

Array of schedule task data.

Provides an interface to the Task Scheduler.

The CMsvServerEntry of the server MTM.

The Server MTM specific scheduled message sending settings.