CQ
Use the CQ command to find an op to chase. The OTA bot answers
with the callsigns of hosts on the air right now, the ones closest
to going off the air first (so you can reach them before they finish).
CQ
Find an op to chase: list the hosts on the air.
Replies
cq_reply{spots}cq_replyCQ! {page}/{pages} {count} {records}cq_replyNo ops on the air. Send HOST to start one.cq_replymore at aprsota.org/now
No error hints; OTA does not reply to an invalid CQ.
Machine form
CQ!
Every message begins with CQ!, then this message's number and the count of messages, then the total number of ops on the air, then one record per op, soonest to expire first.
- the list, one message per page
CQ! {page}/{pages} {count} {station} {grid} {expires_at} ...
| Field | On the wire | Meaning |
|---|---|---|
station | string | The station running the op, SSID included. Every host command comes from it. |
grid | string, or _ | The six-character Maidenhead locator, or null when the position is not a place. |
expires_at | whole minutes left | When the op goes off the air unless extended. Null once ended. Derive minutes left from this. |
The grammar every machine form shares is in the handbook's API section.
When no op is on the air, the answer says so and suggests you start your own:
If more hosts are on the air than fit in one message, the bot sends two, each
tagged (1/2) and (2/2). If they still do not all fit, the second message
ends with more at aprsota.org/now, where the full list is available.