Queue Access Callback Functions

Modules
	Accessing Queue Object Data

Typedefs
typedef void	SOMQueueCallback(struct SOMSession *session, void *ophandle, void *clientdata, int status)
	Prototype for callback for queue operation completion.
typedef void	SOMQchannelCallback(struct SOMSession *session, void *ophandle, void *clientdata, struct SOMQchannel *channel)
	Prototype for callback for reporting channel object.
typedef void	SOMQmtaCallback(struct SOMSession *session, void *ophandle, void *clientdata, struct SOMQmta *mta)
	Prototype for callback for reporting mta object.
typedef void	SOMQmessageCallback(struct SOMSession *session, void *ophandle, void *clientdata, struct SOMQmessage *message)
	Prototype for callback for reporting message object.

Functions
int	SOMQueueSetCallback (struct SOMSession *session, SOMQueueCallback *callback, SOMQueueCallback **oldvalue)
	Set the Queue callback function for this session.
int	SOMQueueSetChannelCallback (struct SOMSession *session, SOMQchannelCallback *callback, SOMQchannelCallback **oldvalue)
	Set the callback function for channel objects for this session.
int	SOMQueueSetMtaCallback (struct SOMSession *session, SOMQmtaCallback *callback, SOMQmtaCallback **oldvalue)
	Set the callback function for Mtas for this session.
int	SOMQueueSetMessageCallback (struct SOMSession *session, SOMQmessageCallback *callback, SOMQmessageCallback **oldvalue)
	Set the callback function for messages for this session.

Detailed Description

Description of the function calls for viewing and monitoring log files.

Typedef Documentation

SOMQueueCallback

typedef void SOMQueueCallback(struct SOMSession *session, void *ophandle, void *clientdata, int status)

Prototype for callback for queue operation completion.

Parameters

session	[in] Pointer to address of session object
ophandle	[in] Data associated with operation
clientdata	[in] Data associated with session
status	[in] Status for the operation

Returns

no return value

Definition at line 58 of file queue.h.

SOMQchannelCallback

typedef void SOMQchannelCallback(struct SOMSession *session, void *ophandle, void *clientdata, struct SOMQchannel *channel)

Prototype for callback for reporting channel object.

Parameters

session	[in] Pointer to address of session object
ophandle	[in] Data associated with operation
clientdata	[in] Data associated with session
status	[in] Status for the operation
channel	[in] Pointer to opaque channel object

Returns

no return value

The channel object only exists for the duration of this callback.

Definition at line 75 of file queue.h.

SOMQmtaCallback

typedef void SOMQmtaCallback(struct SOMSession *session, void *ophandle, void *clientdata, struct SOMQmta *mta)

Prototype for callback for reporting mta object.

Parameters

session	[in] Pointer to address of session object
ophandle	[in] Data associated with operation
clientdata	[in] Data associated with session
status	[in] Status for the operation
mta	[in] Pointer to opaque mta object

Returns

no return value

The mta object only exists for the duration of this callback.

Definition at line 93 of file queue.h.

SOMQmessageCallback

typedef void SOMQmessageCallback(struct SOMSession *session, void *ophandle, void *clientdata, struct SOMQmessage *message)

Prototype for callback for reporting message object.

Parameters

session	[in] Pointer to address of session object
ophandle	[in] Data associated with operation
clientdata	[in] Data associated with session
status	[in] Status for the operation
message	[in] Pointer to opaque message object

Returns

no return value

The message object only exists for the duration of this callback.

Recipients are accessed through this object.

Definition at line 113 of file queue.h.

Function Documentation

SOMQueueSetCallback()

int SOMQueueSetCallback	(	struct SOMSession *	session,
		SOMQueueCallback *	callback,
		SOMQueueCallback **	oldvalue
	)

Set the Queue callback function for this session.

Parameters

session	[in] Pointer to address of session object
callback	[in] Address of callback function
oldvalue	[out] Pointer to location for previous value of callback function

Returns

zero on success; non-zero on error

callback may be NULL to clear the callback function oldvalue may be NULL, in which case the previous value is not returned

SOMQueueSetChannelCallback()

int SOMQueueSetChannelCallback	(	struct SOMSession *	session,
		SOMQchannelCallback *	callback,
		SOMQchannelCallback **	oldvalue
	)

Set the callback function for channel objects for this session.

Parameters

session	[in] Pointer to address of session object
callback	[in] Address of callback function
oldvalue	[out] Pointer to location for previous value of callback function

Returns

zero on success; non-zero on error

callback may be NULL to clear the callback function oldvalue may be NULL, in which case the previous value is not returned

SOMQueueSetMtaCallback()

int SOMQueueSetMtaCallback	(	struct SOMSession *	session,
		SOMQmtaCallback *	callback,
		SOMQmtaCallback **	oldvalue
	)

Set the callback function for Mtas for this session.

Parameters

session	[in] Pointer to address of session object
callback	[in] Address of callback function
oldvalue	[out] Pointer to location for previous value of callback function

Returns

zero on success; non-zero on error

callback may be NULL to clear the callback function oldvalue may be NULL, in which case the previous value is not returned

SOMQueueSetMessageCallback()

int SOMQueueSetMessageCallback	(	struct SOMSession *	session,
		SOMQmessageCallback *	callback,
		SOMQmessageCallback **	oldvalue
	)

Set the callback function for messages for this session.

Parameters

session	[in] Pointer to address of session object
callback	[in] Address of callback function
oldvalue	[out] Pointer to location for previous value of callback function

Returns

zero on success; non-zero on error

callback may be NULL to clear the callback function oldvalue may be NULL, in which case the previous value is not returned