MQCFSL - String list parameter

The MQCFSL structure describes a string list parameter.

Type
Description: This indicates that the structure is an MQCFSL structure describing a string-list parameter.
Datatype: MQLONG.
Value:
MQCFT_STRING_LIST
Structure defining a string list.
StrucLength
Description: This is the length in bytes of the MQCFSL structure, including the array of strings at the end of the structure (the Strings field).
Datatype: MQLONG.
Parameter
Description: This identifies the parameter whose values are contained in the structure.
Datatype: MQLONG.
CodedCharSetId
Description: This specifies the coded character set identifier of the data in the Strings field.
Datatype: MQLONG.
Count
Description: This is the number of strings present in the Strings field; zero or greater.
Datatype: MQLONG.
StringLength
Description: This is the length in bytes of one parameter value, that is the length of one string in the Strings field; all of the strings are this length.
Datatype: MQLONG.
String
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).
Datatype: MQCHAR × StringLength×Count.