Show TOC

Administrator Tasks for BlacklistingLocate this document in the navigation structure

Use

You can perform the following tasks:

  • Activate and deactivate blacklisting.

  • Manually restart blacklisted messages.

  • Configure a restart job.

You can control blacklisting using SAP NetWeaver Administrator as described in the following sections.

Note

You can also use Runtime Workbench to manually restart blacklisted messages and configure a restart job.

Procedure

Activating and Deactivating Blacklisting

Blacklisting is activated by default.

To activate or deactivate blacklisting, perform the following steps:

  1. Start SAP NetWeaver Administrator and choose Start of the navigation path Configuration Next navigation step Infrastructure End of the navigation path.

  2. Choose Java System Properties .

    An overview of properties is displayed.

  3. Go to the Services tab.

  4. Locate the service XPI Service Messaging System .

    The parameters for this service are displayed.

    A boolean service property messaging.blacklisting.enabled controls blacklisting.

    By default, messaging blacklisting is enabled. (The parameter value is true .)

    The parameter is modifiable online. This means that you can apply a new value without restarting the server.

  5. Choose Modify .

    A dialog box is displayed.

  6. To deactivate blacklisting, specify false .

    To restore to the default value ( true ), choose Restore to default .

  7. Save.

    A message confirms that changes were saved.

Manually Restarting Blacklisted Messages

If a message has not been processed, this may be because it has been blacklisted. A message that has been blacklisted and assigned state NDLV can still reenter processing if it is restarted. You can manually resend or redeliver a blacklisted message.

Note

Normally, only a small number of messages are blacklisted. However, over time, many messages could accumulate if administrators do not regularly clean up the messages in state NDLV.

To check whether messages were blacklisted, perform the following steps:

  1. Access the message monitor and switch to advanced search mode. For more information, see Monitoring Messages .

  2. Select the checkbox for the Technical Attributes section, and then select the Blacklisted checkbox. For more information, see Advanced Message Search .

  3. Enter other search parameters as necessary and start the search.

  4. If the search yields any results, select a message and do one or more of the following:

    • Choose the Message Log tab to see the events that happened during the processing of the selected message.

      For more information, see the example below.

    • Stop or restart the message using the corresponding buttons. For more information, see Reviewing Search Results .

      Note

      You can restart all the blacklisted messages at once. However, be aware that this may be dangerous because blacklisted messages could potentially cause a server crash.

Configuring the Restart Job

A restart job restarts messages that have not been delivered (state NDLV). To set a job to restart blacklisted messages, perform the following steps:

  1. Access the background processing monitor. For more information, see Performing Background Processing .

  2. Create a new restart job, or choose an existing restart job. For more information, see Scheduling Jobs .

  3. Select the job in the list, choose Edit , and then choose the Parameters tab.

  4. In the Parameters dropdown menu, select RESTART-BLACKLISTED and choose Add .

  5. When the system displays the selected parameter in the table, enter True in the Value column.

  6. Add other parameters or rules as necessary. For more information, see Defining Rules .

  7. Save the job.

    If the job is set to be active, the system runs it at the specified schedule and restarts the messages for which the job applies. You can also run it manually when necessary using the Execute Now button.

Example

The following situations related to blacklisting are recorded in the audit log:

  • Failover

    A blacklisted message in state DLNG was reassigned. The message is blacklisted and assigned state NDLV.

    The following messages are recorded:

    • Adding message to blacklist. Reason: message, which is in delivering state, is reassigned.

    • Moved message to the non-delivered state. Reason: blacklisted message, which is in delivering state, is reassigned.

  • Startup

    A message has state DLNG during startup. The message is blacklisted and assigned state NDLV.

    The following messages are recorded:

    • Adding message to blacklist. Reason: found message, which is in delivering state, during startup.

    • Moved message to the non-delivered state. Reason: found blacklisted message, which is in delivering state, during startup.

More Information