Managing Subscribers

About Subscribers

A subscriber is a person who has a need for information that is published by the Publishing Framework. Before a user can receive information from a channel, you must define that user as a subscriber.

The Publishing Framework plug-in to SAS Management Console provides wizards that enable you to create subscribers. When you create a subscriber with a wizard, the subscriber object with the specified attributes is stored on the SAS Metadata Server.

You can create two different kinds of subscribers using the Publishing Framework: package subscribers and event subscribers.

• A package subscriber is a subscriber who is configured to receive packages. A package is a bundle of one or more information entities such as SAS data sets, SAS catalogs, or almost any other type of digital content.
• An event subscriber is a subscriber who is configured to receive events. An event is a well-formed XML document that can be published to an HTTP server, a message queue, or a channel that has event subscribers defined for it.

For each kind of subscriber, you can create individual subscribers and group subscribers. A group subscriber can contain individual subscribers or other group subscribers.

Creating a New Subscriber

To create a new subscriber:

1. In the SAS Management Console navigation tree, expand the Publishing Framework node.
2. Select the desired metadata repository node.
3. Select the Subscribers node.
4. For new package subscribers, select Package Subscribers and then select Actions New Package Subscriber or New Subscriber Group from the menu bar. For new event subscribers, select Event Subscribers, then select Actions New Event Subscriber or New Subscriber Group from the menu bar.

The appropriate wizard opens and guides you through the subscriber creation process. Click Help in the wizards at any time for detailed information. For examples, see Example: Creating a Subscriber. The examples cover creating individual and group package subscribers; creating event subscribers is similar.

Duplicating an Existing Subscriber

To create a new subscriber with substantially the same properties as an existing subscriber:

1. In the SAS Management Console navigation tree, expand the Publishing Framework node.
2. Select the desired metadata repository node.
3. Select the Subscribers node.
4. Select either the Package Subscribers or Event Subscribers folder.
5. Select the existing subscriber and select Actions Duplicate Package Subscriber or Duplicate Event Subscriber from the menu bar to open the appropriate New Subscriber wizard. All of the wizard's fields are filled in with values from the existing subscriber.
6. Because subscriber names must be unique, you must change the Name attribute. Click Next to change other attributes.
7. Click Finish to create the new subscriber.

Modifying an Existing Subscriber

To modify the properties of an existing subscriber:

1. In the SAS Management Console navigation tree, expand the Publishing Framework node.
2. Select the desired metadata repository node.
3. Select the Subscribers node.
4. Select either the Package Subscribers or Event Subscribers folder.
5. Select the subscriber whose properties you want to modify and select File Properties from the menu bar. The Properties window for that subscriber displays.
6. Use the tabs in the Properties window to modify the various properties of the subscriber. Some properties, such as the User, cannot be modified.
7. When you are finished modifying properties, click OK.

Deleting a Subscriber

To delete a subscriber:

1. In the SAS Management Console navigation tree, expand the Publishing Framework node.
2. Select the desired metadata repository node.
3. Select the Subscribers node.
4. Select either the Package Subscribers or Event Subscribers folder.
5. Select the subscriber that you want to delete and select Edit Delete from the menu bar.

To delete all package subscribers, select the Package Subscribers folder and select Edit Delete from the menu bar. To delete all event subscribers, select the Event Subscribers folder and select Edit Delete from the menu bar.