# web.xml Visual Editor: Message Destination References

Use the Message Destination References section to add, remove, and view the web application's message destination references.

The J2EE specification lets J2EE components refer to message destination objects by using logical names called message destination references. A message destination reference points to a message destination that can be defined in an EJB module, application client module, or web module.

To declare a message destination reference, you must register it in the `web.xml` file. When you do this, you provide information needed by the server to use the resource reference.

In the Visual Editor, click References at the top of the editor to open the References section, then click the Message Destination References header to open the Message Destination References section.

Click Add to define a message destination reference element with the following properties:

Element | Description
--- | ---
Reference Name | Specifies the reference's name, such as `myDataSource`. Note that the name of the message destination reference is relative to the `java:comp/env context`. For example, the name should be `jms/MyBidQueue` and not `java:comp/env/jms/MyBidQueue`.
Reference Type | Specifies the expected type of the referenced destination, either `java.jms.Queue` or `java.jms.Topic`.
Usage | Specifies what the message destination does to messages: consumes, produces, or both.
Link to Message Destination | Name of the message destination.
Description | Specifies a description for the reference.

Related Topics

Developing Applications with NetBeans IDE,

Developing Applications with NetBeans IDE,

Copyright © 2015, Oracle and/or its affiliates. All rights reserved.