2431 (097F) (RC2431): MQRC_SUB_USER_DATA_ERROR

Explanation

On the MQSUB call in the Subscription Descriptor MQSD the SubUserData field is not valid. One of the following applies:
  • SubUserData.VSLength is greater than zero, but SubUserData.VSOffset is zero and SubUserData.VSPtr is the null pointer.
  • SubUserData.VSOffset is nonzero and SubUserData.VSPtr is not the null pointer (that is, it appears both fields are being used where only one is allowed).
  • SubUserData.VSPtr is not a valid pointer.
  • SubUserData.VSOffset or SubUserData.VSPtr points to storage that is not accessible.
  • SubUserData.VSLength exceeds the maximum length allowed for this field.

Completion code

MQCC_FAILED

Programmer response

Ensure that one of SubUserData.VSOffset or SubUserData.VSPtr is zero and the other nonzero. Ensure that the field used points to accessible storage. Specify a length that does not exceed the maximum length allowed for this field.