Usage notes

The format of the strings in the PCF message determines the settings of the character set fields in the message descriptor to enable conversion of strings within the message.

If all of the strings in a PCF message have the same coded character-set identifier, the CodedCharSetId field in the message descriptor MQMD should be set to that identifier when the message is put, and the CodedCharSetId fields in the MQCFST, MQCFSL, and MQCFSF structures within the message should be set to MQCCSI_DEFAULT.

If the format of the PCF message is MQFMT_ADMIN, MQFMT_EVENT, or MQFMT_PCF and some of the strings in the message have different character-set identifiers, the CodedCharSetId field in MQMD should be set to MQCCSI_EMBEDDED when the message is put, and the CodedCharSetId fields in the MQCFST, MQCFSL, and MQCFSF structures within the message should all be set to the identifiers that apply.

This enables conversions of the strings within the message, to the CodedCharSetId value in the MQMD specified on the MQGET call, if the MQGMO_CONVERT option is also specified.

For more information about the MQEPH structure, see MQEPH - Embedded PCF header.

Note: If you request conversion of the internal strings in the message, the conversion will occur only if the value of the CodedCharSetId field in the MQMD of the message is different from the CodedCharSetId field of the MQMD specified on the MQGET call.

Do not specify MQCCSI_EMBEDDED in MQMD when the message is put, with MQCCSI_DEFAULT in the MQCFST, MQCFSL, or MQCFSF structures within the message, as this will prevent conversion of the message.

Parent topic: Structures for commands and responses