Queue management

While you are running AS4 Microservice, you need to monitor the message queues with the administrative console of WebSphere MQ.

Creating queues before AS4 Microservice installation

Before you install AS4 Microservice, create queues for AS4 Microservice:
  1. Create a queue manager.
  2. Run the MEG_QUEUES.mqsc file against the queue manager that you created.

AS4 Microservice expects the queues to be there when AS4 Microservice starts.

MEG_QUEUES.mqsc file

The MEG_QUEUES.mqsc file is a script for WebSphere MQ. You run this script on WebSphere MQ like you would run any other WebSphere MQ command or script. This script is in the <install_dir>\resources\wmq folder.

The MEG_QUEUES.mqsc file lists all of the queues that AS4 Microservice uses internally and their attributes.

Queue manager name and installation

During installation, you enter the name of the queue manager that you created for the AS4 Microservice queues. When AS4 Microservice creates new queues, it creates them under this queue manager.

There can be only one queue manager for all of the AS4 Microservice queues.

Queues used internally by components

The queues that you create with the MEG_QUEUES.mqsc file are used by AS4 Microservice for communication among AS4 Microservice components. These queues are used to support highly scalable, highly available configuration. Do not modify these queues.

Queues used for document exchanges

When you use the user interface to create messages, AS4 Microservice creates the queues in WebSphere MQ. These queues are created under the queue manager that you created and entered during the AS4 Microservice installation.

The queues are created with the same set of attributes as the internal AS4 Microservice queues. You might need to modify these queues for performance tuning.

Queue default attributes

All of the queues for AS4 Microservice are created with these attributes:
  • DEFPRTY(4)
  • DEFSOPT(SHARED)
  • GET(ENABLED)
  • MAXDEPTH(5000)
  • MAXMSGL(4194304)
  • MSGDLVSQ(PRIORITY)
  • PUT(ENABLED)
  • RETINTVL(999999999)
  • SHARE
  • NOTRIGGER
  • USAGE(NORMAL)
  • DEFPSIST(YES)

For more information, see the parameter documentation in WebSphere MQ queue properties

Queues and monitoring

When you create message queue definitions with the AS4 Microservice user interface, enter specific and detailed names and descriptions to make them easy find under the WebSphere MQ queue manager.