Options (MQLONG)

This field is always an input field. Its initial value is MQCMHO_DEFAULT_VALIDATION.

One of the following options can be specified:

    MQCMHO_VALIDATE
    When MQSETMP is called to set a property in this message handle, the property name is validated to ensure that it:

    • contains no invalid characters.
    • does not begin JMS or usr.JMS except for the following:

      • JMSCorrelationID
      • JMSReplyTo
      • JMSType
      • JMSXGroupID
      • JMSXGroupSeq

      These names are reserved for JMS properties.

    • is not one of the following keywords, in any mixture of uppercase or lowercase:

      • AND
      • BETWEEN
      • ESCAPE
      • FALSE
      • IN
      • IS
      • LIKE
      • NOT
      • NULL
      • OR
      • TRUE

    • does not begin Body. or Root. (except for Root.MQMD.).

    If the property is MQ-defined (mq.*) and the name is recognized, the property descriptor fields are set to the correct values for the property. If the property is not recognized, the Support field of the property descriptor is set to MQPD_OPTIONAL.

    MQCMHO_DEFAULT_VALIDATION

    This value specifies that the default level of validation of property names occur.

    The default level of validation is equivalent to the level specified by MQCMHO_VALIDATE.

    This value is the default value.

    MQCMHO_NO_VALIDATION

    No validation on the property name occurs. See the description of MQCMHO_VALIDATE.

Default option: If none of the preceding options described is required, the following option can be used:

    MQCMHO_NONE

    All options assume their default values. Use this value to indicate that no other options have been specified. MQCMHO_NONE aids program documentation; it is not intended that this option is used with any other, but as its value is zero, such use cannot be detected.

Parent topic: Fields for MQCMHO