Managing message properties

The following QAMessage methods can be used to manage message properties.

Note

You can get and set custom properties, but should only get predefined properties.

.NET methods to manage message properties

Object GetProperty( String name )
void SetProperty( String name, Object value )
boolean GetBooleanProperty( String name )
void SetBooleanProperty( String name, boolean value )
byte GetByteProperty( String name )
void SetByteProperty( String name, byte value )
short GetShortProperty( String name )
void SetShortProperty( String name, short value )
int GetIntProperty( String name )
void SetIntProperty( String name, int value )
long GetLongProperty( String name )
void SetLongProperty( String name, long value )
float GetFloatProperty( String name )
void SetFloatProperty( String name, float value )
double GetDoubleProperty( String name )
void SetDoubleProperty( String name, double value )
String GetStringProperty( String name )
void SetStringProperty( String name, String value )
IEnumerator GetPropertyNames()
void ClearProperties()
PropertyType GetPropertyType( string propName )
bool PropertyExists( string propName )

See QAMessage interface.

C++ methods to manage message properties

qa_bool getBooleanProperty( qa_const_string name, qa_bool * value )
qa_bool setBooleanProperty( qa_const_string name, qa_bool value )
qa_bool getByteProperty( qa_const_string name, qa_byte * value )
qa_bool setByteProperty( qa_const_string name, qa_byte value )
qa_bool getShortProperty( qa_const_string name, qa_short * value )
qa_bool setShortProperty( qa_const_string name, qa_short value )
qa_bool getIntProperty( qa_const_string name, qa_int * value )
qa_bool setIntProperty( qa_const_string name, qa_int value )
qa_bool getLongProperty( qa_const_string name, qa_long * value )
qa_bool setLongProperty( qa_const_string name, qa_long value )
qa_bool getFloatProperty( qa_const_string name, qa_float * value )
qa_bool setFloatProperty( qa_const_string name, qa_float value )
qa_bool getDoubleProperty( qa_const_string name, qa_double * value )
qa_bool setDoubleProperty( qa_const_string name, qa_double value )
qa_int getStringProperty( qa_const_string name, qa_string value, qa_int len )
qa_bool setStringProperty( qa_const_string name, qa_const_string value )
void QAMessage::clearProperties()
qa_short QAMessage::getPropertyType( qa_const_string name )
qa_bool QAMessage::propertyExists( qa_const_string name)

See QAMessage class.

Java methods to manage message properties

void clearProperties()
boolean getBooleanProperty( String name )
void setBooleanProperty( String name, boolean value )
byte getByteProperty( String name )
void setByteProperty( String name, byte value )
double getDoubleProperty( String name )
void setDoubleProperty( String name, double value )
java.util.Date getExpiration() void setFloatProperty( String name, float value )
float getFloatProperty( String name )
int getIntProperty( String name )
void setIntProperty( String name, int value )
long getLongProperty( String name )
void setLongProperty( String name, long value )
Object getProperty( String name )
void setProperty( String name, Object value )
java.util.Enumeration getPropertyNames()
short getPropertyType( String name )
short getShortProperty( String name )
void setShortProperty( String name, short value )
String getStringProperty( String name )
void setStringProperty( String name, String value )
boolean propertyExists( String name )

See QAMessage interface.

SQL stored procedures to manage message properties

ml_qa_getbooleanproperty
ml_qa_getbyteproperty
ml_qa_getdoubleproperty
ml_qa_getfloatproperty
ml_qa_getintproperty
ml_qa_getlongproperty
ml_qa_getpropertynames
ml_qa_getshortproperty
ml_qa_getstringproperty
ml_qa_setbooleanproperty
ml_qa_setbyteproperty
ml_qa_setdoubleproperty
ml_qa_setfloatproperty
ml_qa_setfloatproperty
ml_qa_setintproperty
ml_qa_setlongproperty
ml_qa_setshortproperty
ml_qa_setstringproperty

See Message properties.

Example

// C++ example.
QAManagerFactory factory;
QAManager * mgr = factory->createQAManager( NULL );
mgr->open(AcknowledgementMode::EXPLICIT_ACKNOWLEDGEMENT);
QAMessage * msg = mgr->createTextMessage();
msg->setStringProperty( "tm_Subject", "Some message subject." );
mgr->putMessage( "myqueue", mgr );

// C# example.
QAManager mgr = QAManagerFactory.Instance.CreateQAManager(null);
mgr.Open(AcknowledgementMode.EXPLICIT_ACKNOWLEDGEMENT);
QAMessage msg = mgr.CreateTextMessage();
msg.SetStringProperty( "tm_Subject", "Some message subject." );
mgr.PutMessage( "myqueue", msg );

// Java example
QAManager mgr = QAManagerFactory.getInstance().createQAManager(null);
mgr.open(AcknowledgementMode.EXPLICIT_ACKNOWLEDGEMENT);
QAMessage msg = mgr.createTextMessage();
msg.setStringProperty("tm_Subject", "Some message subject.");
mgr.putMessage("myqueue", mgr);

-- SQL example
begin
    DECLARE @msgid VARCHAR(128);
    SET @msgid = ml_qa_createmessage();
    CALL ml_qa_setfloatproperty( @msgid, 'myfloatproperty1', -1.3e-5 );
    CALL ml_qa_setfloatproperty( @msgid, 'myfloatproperty2', 1.3e5 );
    CALL ml_qa_putmessage( @msgid, 'clientid\queuename' );
    COMMIT;
end

Discuss this page in DocCommentXchange.