+

Search Tips | Advanced Search

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.

Parent topic: API reason codes

Last updated: 2020-10-04