code: @Override
      public void setForwardRoutingPath(String[] forwardPath) throws JMSException {
          if (TraceComponent.isAnyTracingEnabled() && tc.isEntryEnabled())
              SibTr.entry(this, tc, "setForwardRoutingPath", (forwardPath == null ? null : Arrays.asList(forwardPath)));
  
          // If it is an empty array then we consider it to be the same as null.
          if ((forwardPath != null) && (forwardPath.length == 0)) {
              forwardPath = null;
          }
  
          // Now check that none of the elements is null.
          if (forwardPath != null) {
              // Note that at this point we know that it has at least one element.
              for (int i = 0; i < forwardPath.length; i++) {
                  if (forwardPath[i] == null) {
                      if (TraceComponent.isAnyTracingEnabled() && tc.isDebugEnabled())
                          SibTr.debug(this, tc, "Element " + i + " of the array is null.");
                      throw (JMSException) JmsErrorUtils.newThrowable(JMSException.class
                                                                      , "INVALID_VALUE_CWSIA0281"
                                                                      , new Object[] { "forwardPath[" + i + "]", "null" }
                                                                      , tc
                                      );
                  }
              }
          }
  
          // Clear the cache of the encoding string since we are changing properties.
          clearCachedEncodings();
  
          // Clear the cached producerDestinationAddress, as it may now be incorrect
          clearCachedProducerDestinationAddress();
  
          // Now store or remove the property
          if (forwardPath != null) {
              properties.put(FORWARD_ROUTING_PATH, StringArrayWrapper.create(forwardPath, getDestName()));
          }
          else {
              properties.remove(FORWARD_ROUTING_PATH);
          }
  
          if (TraceComponent.isAnyTracingEnabled() && tc.isEntryEnabled())
              SibTr.exit(this, tc, "setForwardRoutingPath");
      }
docs: /*
  @see com.ibm.websphere.sib.api.jms._FRPHelper#setForwardRoutingPath(java.lang.String[])
  NB: This should be package access, but is public because it implements a method
  of _FRPHelper which is used by tests.