Sun Java Communications Suite 5 Event Notification Service Guide

publish_s

Purpose

Sends a synchronous notification to the notification service.

Syntax

int publish_s (publisher_t *publisher,
               const char *event_ref,
               const char *data,
               unsigned int datalen);

Parameters

publisher

The active publisher. 

event_ref

The event reference. This is a URI identifying the modified resource. 

data

The event data. The body of the notification message. It is opaque to the notification service, which relays it to the events’ subscriber. 

datalen

The length in bytes of the data. 

Returns

Zero if successful; a failure code if unsuccessful. If an RENL, the call does not return until the consumer has completely processed the notification and has successfully acknowledged it.