22.3. Paging Mode

As soon as messages delivered to an address exceed the configured size, that address alone goes into page mode.

Note

Paging is done individually per address. Configuring a max-size-bytes for an address means each matching address will have a maximum size specified. Please note it does not mean that the total overall size of all matching addresses is limited to max-size-bytes.

22.3.1. Configuration

Configuration is done in the address settings, in <JBOSS_HOME>/jboss-as/server/<PROFILE>/deploy/hornetq/hornetq-configuration.xml. 
<address-settings>
   <address-setting match="jms.someaddress">
      <max-size-bytes>104857600</max-size-bytes>
      <page-size-bytes>10485760</page-size-bytes>
      <address-full-policy>PAGE</address-full-policy>
   </address-setting>
</address-settings>
This is the list of available parameters on the address settings.

Table 22.1. Paging Address Settings

Property Name Description Default
max-size-bytes The max memory the address could have before entering on page mode. -1 (disabled)
page-size-bytes The size of each page file used on the paging system 10MiB (10 * 1024 * 1024 bytes)
address-full-policy This must be set to PAGE for paging to enable.
  • If the value is PAGE then further messages will be paged to disk.
  • If the value is DROP then further messages will be silently dropped.
  • If the value is BLOCK then client message producers will block when they try and send further messages.
PAGE
page-max-cache-size Specifies the number of page files kept in memory to optimize input/output cycles during paging navigation. 5