Skip to content

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.

  • 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.

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.

  1. Drag a queue by its handle to its new position. Two queues never share a position.
  2. 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.

  1. 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.
  2. Click Edit queue.
  3. 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.
  1. Click Save changes.

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.

In a queue that uses Default prioritization, the order of its access grants decides which grantee goes first.

  1. Open the queue from the Queues tab.
  2. 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.

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.