Copyright © TIBCO Software Inc. All Rights Reserved


Appendix D Adapter Agent API References : TIBCO EMS Adapter Agent Methods

TIBCO EMS Adapter Agent Methods
The following adapter agent methods use TIBCO EMS. The header file relating to them is adapteragentJms.h and the link library relating to them is agentJMS.lib.lib for Microsoft Windows or libagentJMS.so/libagentJMS.sl for Unix.
The callPubJMS Method
int callPubJMS(char *serviceName, char *sendbuf, char *serverUrl, char *jmsType, char *destination, char *userName, char *password)
This method is for JMS Adapter Agent-based publication services. The user's Tuxedo service invokes the method to send the request which uses FML32/STRING buffers to TIBCO EMS.
char * serviceNameThe name of the adapter service to be used
char * sendbufThe request buffer of the type FML32/STRING
char * serverUrl The EMS server location with URL format, and the format is "<protocal>://<host-name>:<port-number>", for example:"tcp://myhost:7222". Please see EMS documents for further details.
char * jmsType— The JMS transport type. The value must be equal with "queue" or "topic".
char * destination— The JMS destination. the queue name or the topic name.
char * userName— The user name of the EMS server
char * password— The password of the EMS server
The method returns 1 on success, and 0 on failure. Error messages are written into the Tuxedo ULOG file.
The callCArrayPubJMS Method
int callCArrayPubJMS(char *serviceName, char *sendbuf, char *serverUrl, char *jmsType, char *destination, char *userName, char *password, unsigned int sendlen)
This method is for JMS Adapter Agent-based publication services. The user's Tuxedo service invokes the method to send the request which uses CArray buffers to TIBCO EMS.
char * serviceNameThe name of the adapter service to be used
char * sendbufThe request buffer of type CArray
char * serverUrl The EMS server location with URL format, and the format is "<protocal>://<host-name>:<port-number>", for example:"tcp://myhost:7222". Please see EMS documents for further details.
char * jmsType— The JMS transport type. The value must be equal with "queue" or "topic".
char * destination— The JMS destination. the queue name or the topic name.
char * userName— The user name of the EMS server
char * password— The password of the EMS server
unsigned int sendlen— The length of sendbuf
The method returns 1 on success, and 0 on failure. Error messages are written into the Tuxedo ULOG file.

Copyright © TIBCO Software Inc. All Rights Reserved