schedrule - Activate or deactivate user specified autosched records

SYNOPSIS

schedrule  [ parameter=value ]

Parameters are: operation, rule_names, clear_sched, force_sched.

DESCRIPTION

schedrule traverses the automatic scheduling rules file autosched, activating rules according to the operation and rule_names parameters. Records can be activated using operation=add. Records can be deactivated using operation=delete. If operation=replace, the autosched file will be changed so only those records specified by rule_names will be active.

If the parameter clear_sched is yes, all records in the list of scheduled passes, schedlist, are removed. Also, dates for all permanent autosched records (not one-time-only) are reset to the present.

If the parameter force_sched is yes, the list of scheduled passes is regenerated for the for each active autosched record. Note that force_sched does not apply when clear_sched=no.

In order for schedrule to work properly, each autosched record should have a non-blank name. If names are blank, the only way to select them using schedrule is by using the wildcard rule_names=*.

schedrule is useful in those cases where a geostationary satellite (e.g., gms-5) has a seasonal schedule. schedrule is also useful for temporary, but recurring autosched changes.

PARAMETERS

operation

Either replace all active rules, add new active rules, or delete (deactivate) selected rules. The default is replace.

rule_names

List of rule names, which may include wildcard characters * and ?. The default is blank, which in the case of operation=replace, will deactivate all records!

clear_sched

If yes, clears all records from the schedlist file, and resets the dates of permanent autosched records to the present. Otherwise, the schedlist file is not modified, and the dates of autosched records are not modified. The default is no.

force_sched

Only applies if clear_sched=yes. If yes, the list of scheduled passes (schedlist) is regenerated according to active permanent autosched records. If no, the schedlist file will remain empty. The default is no.

FILES

autosched, schedlist

SEE ALSO

resched

NOTES

schedrule operation=add rule_names= clear_sched=yes force_sched=yes is equivalent to resched.

Resetting the date for an autosched record to the present means that start_date is set to the current time falls into the interval

[start_date + start_time, start_date + start_time + sched_days)