# tibemsMsg_Set Property

Function

## Purpose

Set the value of a message property.

## C Declaration

    tibems_status tibemsMsg_SetBooleanProperty(
        tibemsMsg message,
        const char* name,
        tibems_bool value );

    tibems_status tibemsMsg_SetByteProperty(
        tibemsMsg message,
        const char* name,
        tibems_byte value );

    tibems_status tibemsMsg_SetDoubleProperty(
        tibemsMsg message,
        const char* name,
        tibems_double value );

    tibems_status tibemsMsg_SetFloatProperty(
        tibemsMsg message,
        const char* name,
        tibems_float value );

    tibems_status tibemsMsg_SetIntProperty(
        tibemsMsg message,
        const char* name,
        tibems_int value );

    tibems_status tibemsMsg_SetLongProperty(
        tibemsMsg message,
        const char* name,
        tibems_long value );

    tibems_status tibemsMsg_SetShortProperty(
        tibemsMsg message,
        const char* name,
        tibems_short value );

    tibems_status tibemsMsg_SetStringProperty(
        tibemsMsg message,
        const char* name,
        const char* value );

## COBOL Call

    CALL "tibemsMsg_SetBooleanProperty"
         USING BY VALUE message,
               BY REFERENCE name,
               BY VALUE value,
               RETURNING tibems-status
    END-CALL.

    CALL "tibemsMsg_SetByteProperty"
         USING BY VALUE message,
               BY REFERENCE name,
               BY VALUE value,
               RETURNING tibems-status
    END-CALL.

    CALL "tibemsMsg_SetDoubleProperty"
         USING BY VALUE message,
               BY REFERENCE name,
               BY VALUE value,
               RETURNING tibems-status
    END-CALL.

    CALL "tibemsMsg_SetFloatProperty"
         USING BY VALUE message,
               BY REFERENCE name,
               BY VALUE value,
               RETURNING tibems-status
    END-CALL.

    CALL "tibemsMsg_SetIntProperty"
         USING BY VALUE message,
               BY REFERENCE name,
               BY VALUE value,
               RETURNING tibems-status
    END-CALL.

    CALL "tibemsMsg_SetLongProperty"
         USING BY VALUE message,
               BY REFERENCE name,
               BY VALUE value,
               RETURNING tibems-status
    END-CALL.

    CALL "tibemsMsg_SetShortProperty"
         USING BY VALUE message,
               BY REFERENCE name,
               BY VALUE value,
               RETURNING tibems-status
    END-CALL.

    CALL "tibemsMsg_SetStringProperty"
         USING BY VALUE message,
               BY REFERENCE name,
               BY REFERENCE value,
               RETURNING tibems-status
    END-CALL.

Note: `message` has usage pointer.

`value` has usage pointer only in `tibemsMsg_SetStringProperty` (but not in the other calls documented in this group).

## Parameters

Parameter | Description
--- | ---
`message` | Set a property on this message. Property names must obey the JMS rules for a message selector identifier (see Message Selectors). Property names must not be null, and must not be empty strings.
`name` | Set a property with this name. Property names must obey the JMS rules for a message selector identifier (see Message Selectors). Property names must not be null, and must not be empty strings.
`value` | Set the property to this value.

## Remarks

The JMS specification defines eight calls to set properties with different primitive value types.

Status Code | Description
--- | ---
`TIBEMS_MSG_NOT_WRITEABLE` | The message is read-only.

## See Also

`tibemsMsg_Get Property`

Copyright © Cloud Software Group, Inc. All rights reserved.