2440 (0988) (RC2440): MQRC_SUB_NAME_ERROR
Explanation
On the MQSUB call in the Subscription Descriptor MQSD the SubName
field is not
valid or has been omitted. This is required if the MQSD option MQSO_DURABLE is specified, but may
also be used if MQSO_DURABLE is not specified.
SubName.VSLength
is greater than zero, butSubName.VSOffset
is zero andSubName.VSPtr
is the null pointer.SubName.VSOffset
is nonzero andSubName.VSPtr
is not the null pointer (that is, it appears both fields are being used where only one is allowed).SubName.VSPtr
is not a valid pointer.SubName.VSOffset
orSubName.VSPtr
points to storage that is not accessible.SubName.VSLength
is zero but this field is required.SubName.VSLength
exceeds the maximum length allowed for this field.
Completion code
MQCC_FAILED
Programmer response
Ensure that SubName
is specified and SubName.VSLength
is
nonzero. Ensure that one of SubName.VSOffset
or SubName.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.
This code can be returned if the sd.Options flags MQSO_CREATE and MQSO_RESUME are set together
and sd.SubName
is not initialized. You must also initialize the MQCHARV structure
for sd.SubName
, even if there is no subscription to resume; see Example 2: Managed MQ subscriber for
more details.