ResObjectString (MQCHARV)

The ResObjectString field is the long object name after the queue manager resolves the name provided in the ObjectName field.

This field is returned only for topics and queue aliases that reference a topic object.

If the long object name is provided in ObjectString and nothing is provided in ObjectName, then the value returned in this field is the same as provided in ObjectString.

If this field is omitted (that is ResObjectString.VSBufSize is zero) then the ResObjectString will not be returned, but the length will be returned in ResObjectString.VSLength.

If the buffer length (provided in ResObjectStrng.VSBufSize) is shorter than the full ResObjectString, the string will be truncated and will return as many of the rightmost characters as can fit in the provided buffer.

If ResObjectString is specified incorrectly, according to the description of how to use the MQCHARV structure, or if it exceeds the maximum length, the call fails with reason code MQRC_RES_OBJECT_STRING_ERROR.