Broker 10.15 | webMethods Broker Documentation | webMethods Broker Client Java API Programmer's Guide | Creating and Initializing Events | Envelope Fields | Read-only Envelope Fields | The pubNetAddr Envelope Field
 
The pubNetAddr Envelope Field
This read-only envelope field is set by Broker and contains the IP address and port number of the event's publisher. This field supports IPv6 addresses in the string format.
The example below shows how to retrieve IP address in string format.
event.getByteSeqField("_env.pubNetAddr", 0, BrokerEvent.ENTIRE_SEQUENCE).toString()
Prior to the string format, the pubNetAddr Envelope field was six-byte long, where the first four bytes represented IPv4 address in the network byte-order, and the last two bytes represented the port in the network byte-order.
To retrieve the IP address in the old six-byte format, set the pub-net-address-in-deprecated-format configuration parameter to 1 in the Broker configuration file (awbroker.cfg). By default, pub-net-address-in-deprecated-format = 0, where the IP address is retrieved in the string format.
The presence of the pubNetAddr Envelope field is controlled by the Broker configuration file. This envelope field is disabled by default, by you can enable it using the following steps:
1. Edit the Broker configuration file and add the following line:
pub-net-address-in-envelope=1
2. Save the file.
3. Restart the Broker Server.
Note:
This will enable the pubNetAddr envelope field for all Brokers within the Broker Server.
4. For complete information on the Broker configuration file, see Administering webMethods Broker document.