# tibemsMapMsg

Type

## Purpose

A message containing a set of name-value pairs.

## Related Types

`tibemsMsg`

## Remarks

Messages with this body type contain several values, indexed by name.

Function | Description
--- | ---
`tibemsMapMsg_Create` | Create a map message.
`tibemsMapMsg_Get` | Get data values from a map message.
`tibemsMapMsg_GetMapNames` | Get an enumeration of the field names in a map message.
`tibemsMapMsg_ItemExists` | Test if a named pair exists.
`tibemsMapMsg_Set` | Set a name-value pair in a map message.
`tibemsMapMsg_SetBytes` | Set a byte array as a named value in a map message.

## Extensions

TIBCO Enterprise Message Service extends the JMS `MapMessage` and `StreamMessage` body types in two ways. These extensions allow TIBCO Enterprise Message Service to exchange messages with TIBCO Rendezvous and TIBCO SmartSockets programs, which have certain features not available within the JMS specification.

- You can insert another `MapMessage` or `StreamMessage` instance as a `submessage` into a `MapMessage` or `StreamMessage`, generating a series of nested messages, instead of a flat message.
- You can use arrays as well as primitive types for the values.

These extensions add considerable flexibility to the two body types. However, they are extensions and therefore not compliant with JMS specifications. Extended messages are tagged as extensions with the vendor property tag `JMS_TIBCO_MSG_EXT`.

For more information on message compatibility with Rendezvous messages, see "Message Body" in TIBCO Enterprise Message Service Release Notes.

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