Metadata access

Use xpmmetaget and xpmmetaset to query and modify the XPM output message prototype's metadata. Their operation is identical to msgmetaget and msgmetaset, with the exception that they use an XPM handle instead of a message handle.

When XPM metadata is modified, the metadata that is inherited by all messages then produced by the XPM is modified.

For example, the DESTCONN metadata field is initialized to the route detail's destination list. By default, all of the messages that are produced by that detail are routed to the threads in that list.

Re-route that route detail's messages by modifying the DESTCONN metadata value.

For example:

Input: xpmmetaget $xlateId
Output: <metadata key list, similar to msgmetaget>
Input: xpmmetaset $xlateId DESTCONN newthread
Note: Metadata changes only effect messages that are produced after the change is made. Messages already in XPM's output list are not affected.