Configure queues
Each telescope has an ordered list of observing queues, and each queue orders its access grants. This page shows how to change both in the website. What queues are and how the scheduler uses them is explained in Observing queues and Queue prioritization.
Before you start
Section titled “Before you start”- You need the owner or device manager role in the organization that owns the telescope. Members with the telescope viewer role see the same pages read-only. See Roles and permissions.
- Queue settings live on the telescope’s Queues tab: in your organization, open Telescopes, pick the telescope, and choose Queues in the telescope’s side menu.
- Who may use a queue is not set here. You add and remove grantees on the telescope’s Access Grants tab; see Grant access.
A newly set-up telescope has four queues, from highest to lowest priority: Maintenance, TOO, Calibration, and General.
Reorder queues
Section titled “Reorder queues”The Queues tab lists the telescope’s queues in priority order, top first, with each queue’s prioritization, its interrupt flag (Interruptible), and whether it is Enabled.
- Drag a queue by its handle to its new position. Two queues never share a position.
- The new order saves as soon as you drop it. If it cannot be saved, the tab shows Couldn’t save the new order with the reason.
The scheduler uses the new order from its next run. Moving a queue up does not pre-empt a task that is already running.
Edit a queue
Section titled “Edit a queue”- On the Queues tab, click the queue’s name to open its page. The page shows the queue’s overview, its prioritization, its access grants, and the credits used through it.
- Click Edit queue.
- Change any of these fields:
| Field | What it does |
|---|---|
| Name | Required. Shown wherever the queue is listed. |
| Description | Optional notes. |
| Order | The queue’s position on the telescope (lower runs first). A position another queue already holds is rejected; to swap two queues, drag them on the Queues tab instead. |
| Access prioritization | How the queue orders its access grants. See Choose a prioritization. |
| Can interrupt lower-priority queues | Recorded and shown on the queue page, but not acted on: the scheduler never pre-empts a running task because of it. |
| Enabled | Untick to switch the queue off. The scheduler skips a disabled queue, and an observation that can reach the telescope only through it reports that the queue is disabled. The queue keeps its access grants, so ticking it again restores it as it was. |
- Click Save changes.
Choose a prioritization
Section titled “Choose a prioritization”Pick the mode in Access prioritization in the Edit queue dialog. Only Default changes the schedule today.
| In the website | Model | Status today |
|---|---|---|
| Default | Fixed: grants go in the order you set, one grantee per position | Live |
| Total usage | Fair-share, measured across the whole telescope | Every grant in the queue is an equal peer; usage-based ranking is not live |
| Queue usage | Fair-share, measured within this queue | Every grant in the queue is an equal peer; usage-based ranking is not live |
| Schedule-driven | Calendar: priorities follow periods you define | Periods cannot be defined yet; every grant is an equal peer |
Use Default when you want a strict order, for example a rapid-response program that must always go first. Choose one of the other modes when you want the queue’s grantees treated as equals. A new telescope’s General queue starts on Total usage, so its grantees are equal peers until you switch it to Default.
Reorder a queue’s access grants
Section titled “Reorder a queue’s access grants”In a queue that uses Default prioritization, the order of its access grants decides which grantee goes first.
- Open the queue from the Queues tab.
- In the Access grants card, drag a grant by its handle to its new position. The order saves when you drop it.
The card lists each grantee with their Shares, Time used, and Time waiting, ranked by Effective priority. Dragging is turned off in the other prioritization modes, where the order has no effect on the schedule today. A grant you add later joins the bottom of the list.
This order only ranks grantees against each other. How each grantee divides its own slice (its accounts, members and delegations) is set by the grantee; see Queue prioritization → Prioritization within a grantee’s slice.
What you can’t change
Section titled “What you can’t change”You cannot create or delete a queue, or change a queue’s type (maintenance, ToO, calibration, general), from the website or the API. A telescope gets its queues when Skynet staff set it up. The type stays fixed because Skynet uses it to find a telescope’s calibration and target-of-opportunity lanes. To take a queue out of use, untick Enabled.