BettikDocsSign in

Reference · the tools · gateway

list_topics

Read-only

Topics on this box's gateway

What it does

The topics on this box's messaging gateway: how many messages each keeps and when the last came, and who gets them -- the sessions subscribed to each, and how many messages each has not had yet. With a topic, also its last few messages, and what the gateway last did with each subscribed session (delivered, woke it, why it is stuck). Messages are kept 7 days (at most 1,000 a topic), delivered or not.

What it needs to know

topic · optional
One topic, with its latest messages.
box · optional
Which box: its name and account, "home.frank" or "jordan.northwind", or just "home" when only one of your boxes is called that. Omit it for your current box (switch_box changes it; list_boxes says which it is).
session_box · optional
The box this session runs on, if it runs on one of yours: its name, as the on-box instructions give it ("frankh90.hemlane"). With it, a call that names no box is checked against your current box.

Where it lands

On one of your boxes: the one named in box, or your default box when none is named. It changes nothing.