Description: |
This is a set of string values for the parameter identified
by the Parameter field. The number of strings is given
by the Count field, and the length of each string is given
by the StringLength field. The strings are concatenated
together, with no bytes skipped between adjacent strings. The total length
of the strings is the length of one string multiplied by the number of strings
present (that is, StringLength×Count).
In MQFMT_EVENT messages, trailing blanks can be omitted from string parameters
(that is, the string may be shorter than the defined length of the parameter). StringLength gives the length of the string actually present in
the message.
Note:
In the MQCFSL structure, a null character in a
string is treated as normal data, and does not act as a delimiter for the
string. This means that when a receiving application reads a MQFMT_EVENT message,
the receiving application receives all of the data specified by the sending
application. The data may, of course, have been converted between character
sets (for example, by the receiving application specifying the MQGMO_CONVERT
option on the MQGET call). |