Show TOC

Change Number of EOIO QueuesLocate this document in the navigation structure

Use

Limit the number of EOIO queues specified by the sender to increase, for example, the efficacy of Message Packaging . In doing however, you must preserve the specified order of messages.

This cannot be guaranteed if you simply restrict the possible number of queues. Therefore the Switch Procedure is provided, this creates a new set of queues with a new prefix (XB2*) into which the new inbound messages are redirected.

Note

The error handling is of course also changed as a result of this overserialization. For messages with errors, the EOIO queue is not only kept, but also the message with the error is put into an error queue (with prefix XBQE, XBQF or XBQG) that is specified by the sender.

Prerequisites
  • The current queues must not contain any messages with errors.
  • Any availbale EOIO filters from event-driven message processing must be deactivated.
    Note

    After reactivation of an EOIO filter, it can happen that, due to overserialization, more message queues are stopped than set in the filter.

Procedure

You change the number of your EOIO queues in the Filter Configuration for Queue Prioritization . Initially the number of queues is set to 0 which means that the number is specified by the sender and is not manually restricted.

  1. In the Integration Engine menu chose Configuration → Configure Filter for Queue Prioritization and then choose Number of EOIO Queues:
  2. If you want to restrict the number of queues manually, choose Change Current Set, enter the required maximum number of queues and select Continue.

    The new queues will be created with the suffix QUEUE_ID_xx in the required number. New inbound messages will be redirected to the new queues.

    Note

    You should only use this procedure if your active queue set does not contain any EOIO queues or if it not necessary to maintain the exact order of the messages. This is the case, for example, in development or test systems, or when initially setting up a productive system.

  3. If you want to preserve the message order exactly, choose the Switch Procedure and enter the required number of queues with the new prefix.
    Note

    The Switch Procedure is time-consuming and performance-intensive and is therefore only to be used in a running productive system.

  4. Select Continue and schedule the SXMS_EOIO_REORG report to reorganize the queue by entering the required values.

    The Switch Procedure status changes from inactive () to started (). The reorganization job analyzes the old queues according to messages available and creates corresponding stop entries in the new queues. The status also changes from started () to active ().

    If the Switch Procedure is active, all new inbound messages are redirected to the new queue set. The reorganization job periodically checks the old queues for messages and deletes the corresponding stop entries in the new queues, as long as no more messages are found in the old queue set all stop entries are deleted from the new queue set.

    Caution

    If you manually delete the stop entries, the queues involved will be stopped with an error message.