next up previous contents index
Next: Functions on Binding Up: PEN Functions Previous: POLL_oob(void *extra)

PEN_RETRIEVE_MESSAGE(mapfn,extra)

    

Retrieves PEN (Parallel Editing Notification) messages from DBS and passes them to the mapfn together with the extra argument. We ends the traversal (but we retrieve all messages from the dbs) when the function, mapfn returns a non zero value or we get to the end of the list.

The call format is:

(*mapfn)(extra,index,type,msg,count,len);

where the arguments have the following declarations and contents:

The map function is first called with a NULL msg, and a zero count, index, and type. This call is intended for initialisation. The mapping continues until the map function returns non zero, or there are no more messages.

See section 10 for an example of using a mapfn.

Function returns:



next up previous contents index
Next: Functions on Binding Up: PEN Functions Previous: POLL_oob(void *extra)



Martin Sjolin
Thu Jun 15 20:41:59 MET DST 1995