---
title: "Using IceStorm"
url: https://docs.zeroc.com/ice/3.8/services/icestorm/using-icestorm
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# Using IceStorm

Now we'll expand on the earlier [weather monitoring example](https://docs.zeroc.com/ice/3.8/services/icestorm.md), and discuss how to create a publisher and a subscriber.

## IceStorm API

Publishers, subscribers and administrative tools use the following operations of the [TopicManager](https://code.zeroc.com/ice/3.8/api/slice/interfaceIceStorm_1_1TopicManager.html) and [Topic](https://code.zeroc.com/ice/3.8/api/slice/interfaceIceStorm_1_1Topic.html) interfaces:

| Operation | Description |
| --- | --- |
| `TopicManager::createOrRetrieve` | Returns a proxy to the topic with the given name, creating this topic first if it does not exist. |
| `TopicManager::create` | Creates a topic, and throws `TopicExists` if a topic with this name exists. |
| `TopicManager::retrieve` | Returns a proxy to an existing topic, and throws `NoSuchTopic` if no topic has this name. |
| `TopicManager::retrieveAll` | Returns proxies to all the topics of the topic manager, keyed by name. |
| `Topic::getPublisher`, `Topic::getNonReplicatedPublisher` | Return a proxy to the topic's [publisher object](https://docs.zeroc.com/ice/3.8/services/icestorm/using-icestorm/using-an-icestorm-publisher-object.md). |
| `Topic::subscribeAndGetPublisher` | Subscribes a subscriber object, and returns a proxy to its [per-subscriber publisher](https://docs.zeroc.com/ice/3.8/services/icestorm/using-icestorm/publishing-to-a-specific-subscriber.md). |
| `Topic::unsubscribe` | Removes the subscription of a subscriber object. |
| `Topic::getName`, `Topic::getSubscribers` | Return the name of the topic, and the identities of its subscribers. |
| `Topic::link`, `Topic::unlink`, `Topic::getLinkInfoSeq` | Create, destroy and list the links of a [federated](https://docs.zeroc.com/ice/3.8/services/icestorm/topic-federation.md) topic. |
| `Topic::destroy` | Destroys the topic. |

## See Also

- [IceStorm](https://docs.zeroc.com/ice/3.8/services/icestorm.md)
