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.