| Description:
| The value of the parameter identified by the Parameter field.
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.
|
Language
considerations:
| The way that this field is declared depends on the programming
language:
- For the C programming language, the field is declared as an array with
one element. Storage for the structure should be allocated dynamically, and
pointers used to address the fields within it.
- For the COBOL, PL/I, System/390 assembler, and Visual Basic programming
languages, the field is omitted from the structure declaration. When an instance
of the structure is declared, the user should include MQCFST in a larger structure,
and declare additional fields following MQCFST, to represent the String field as required.
A null character in the string is treated as normal data, and does not
act as a delimiter for the string. This means that when a receiving application
reads an 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).
|