Name

adjust, scheduler.adjust, kPMRPCSchedulerAdjust — Adjust a pending trigger date.

Synopsis

void scheduler.adjust( trigger ID,
date);
trigger ID : string, length 1..255;
date : date;

Description

Adjust a pending trigger date.

adjust replaces a pending trigger's date and time.

adjust provides the ability to move a queued trigger's date and time forward or backward in time. Use adjust to offer flexible schedules.

The provided date must be in the future. If the provided trigger ID does not match an existing queued trigger ID, no change occurs.

Parameters

trigger ID. Trigger ID of a queued trigger. trigger ID is a string. trigger ID must be between 1 and 255 characters long, inclusive.

date. Date to set the queued trigger to fire. date is a date.

Security

adjust can be requested by any authenticated client.

Unauthenticated clients are authorized using the uk.co.dssw.powermanager.scheduler.adjust right. By default, only local processes belonging to administrator can send a adjust request.

Availablility

pmdctl

Examples

Example 125. C: Minimal scheduler.adjust

CFDateRef myDate = NULL;
CFStringRef myTriggerID = NULL;

...
CFMutableDictionaryRef myRequest = PMRequestCreateWithParameters(kCFAllocatorDefault, kPMRPCSchedulerAdjust, kPMRPCParameterDate, myDate, kPMRPCParameterTriggerID, myTriggerID, nil);