Sun Java Communications Suite 5 Event Notification Service Guide

publisher_new_a

Purpose

Creates a new asynchronous publisher.

Syntax

void publisher_new_a (pas_dispatcher_t *disp,
                      void *worker,
                      const char *host,
                      unsigned short port,
                      publisher_cb_t cbdone,
                      void *cbarg);

Parameters

disp

P&S thread pool context returned by pas_dispatcher_new.

worker

Application worker. If not NULL, grouped with existing workers created by ENS to service this publisher session. Used to prevent multiple threads from accessing the publisher data at the same time.

host

Notification server host name. 

port

Notification server port. 

cbdone

The callback invoked when the publisher has been successfully created, or could not be created. 

There are three Parameters to cbdone:

  • cbarg

    The first argument.

  • A status code.

    If non-zero, the publisher could not be created; value specifies cause of the failure.

  • The new active publisher.

cbarg

First argument of cbdone.

Returns

Nothing. It passes the new active publisher as third argument of cbdone callback.