Returns the specified message property as a SQL BIT data type.

Parameters

Return value

The property value as BIT.

Remarks

If the message property value is out of range, then a SQL error with SQLSTATE 22003 occurs.

You can read this property after a message is received and until a rollback or commit occurs; after that you cannot read it.

See also

• Setting up SQL applications
• ml_qa_setbooleanproperty
• ml_qa_createmessage
• ml_qa_getmessage
• Custom message properties

Example

In the following example, a message is received and the value of the boolean property mybooleanproperty is output to the database server messages window:

begin
    declare @msgid varchar(128);
    declare @prop bit;
    set @msgid = ml_qa_getmessage( 'myaddress' );
    set @prop = ml_qa_getbooleanproperty( @msgid, 'mybooleanproperty' );
    message 'message property mybooleanproperty is set to ' || @prop;
    commit;
end