docs: private boolean prepareAddActiveMessage()
      {
          if (TraceComponent.isAnyTracingEnabled() && tc.isEntryEnabled())
              SibTr.entry(this, tc, "prepareAddActiveMessage");
  
          boolean messageAccepted = true;
  
          // We can't even accept the next message if the consumer is already
          // suspended
          if (_consumerSuspended)
              messageAccepted = false;
          else
          {
              // If we're a member of a ConsumerSet then add this message to the
              // set's quota - if there's space (returning 'false' indicates that
              // the set is already full without this message)
              if (!_consumerKey.prepareAddActiveMessage())
              {
                  messageAccepted = false;
                  suspendConsumer(DispatchableConsumerPoint.SUSPEND_FLAG_SET_ACTIVE_MSGS);
              }
          }
  
          // We can defer any local maxActiveMessage changes until the commit as there's
          // no chance of another thread getting for this consumer getting in before then
  
          if (TraceComponent.isAnyTracingEnabled() && tc.isEntryEnabled())
              SibTr.exit(this, tc,
                         "prepareAddActiveMessage",
                         new Object[] { Boolean.valueOf(messageAccepted) });
  
          return messageAccepted;
      }