Jobs for Event-Driven Message Processing

This function enables you to define jobs for scheduling the processing of messages or message packages that have been sorted by a filter and not processed immediately.

Together with the functions for defining the required senders and receivers and the corresponding message filters , this function gives you the option of event-controlled message processing . You can stop specific messages and postpone processing until a later event occurs.

If the event-driven message processing functions of PI are not sufficient, you can use the more extensive job scheduling options provided by usage type AS-ABAP.

In this case you have to use the ABAP Editor (transaction SE38) and program SXMS_START_JOBS to schedule a job whose name corresponds to the job ID.

Before scheduling, the status of the job is To Be Scheduled; after scheduling, the status is Scheduled Externally.

You have chosen Configuration → Configure Event-Driven MessageProcessing from the Integration Engine menu and then Jobs. You are on the Schedule Message Processing screen.

A job starts as soon as

• the specified criteria are met
• the job is active or scheduled externally
• the scheduler job, which schedules the jobs for message processing is running

A traffic light above the job list shows the status of the scheduler job:

If necessary, you can reschedule the scheduler. Choose Scheduler Overview.

The Number column in the job list shows how many messages have been stopped by message filters and assigned to the job. You can display these messages individually.

You can add, change, delete, update, and reset jobs. You can also (de)activate jobs and execute them immediately. You can display details for a job.

Adding a Job

When adding a new job, specify the following criteria:

• Job ID (must not begin with the letter

  S

  )
• Start date and start time (time stamp) of the job
• Latest possible start date (end date) and latest possible start time (end time) of the job
• Job repetition period

  The specified start time and date are recalculated after each period.

• Time unit of the repetition period
• Brief description of the job

All entries are optional except for the job ID.

Changing a Job

You can change all the criteria except for the job ID by using change mode.

If a job ID was created when the message filter was defined, you can add further specifications for the job in change mode.

(De)activating a Job

There are two ways to (de)activate a job:

• Use the Activate and Deactivate functions. The job is then controlled by the scheduler job.
• Control the (de)activation of a job by using an RFC-enabled function module (SXMS_JOB_ACTIVATE or SXMS_JOB_DEACTIVATE).

  In this case we recommend that you do not make any time specifications during job definition, so that the chronological sequence can be driven by an external event.

Scheduling a Scheduler Job

To start the periodic scheduler job that performs a client-specific check of the criteria that are used to start a job for event-driven message processing, choose Schedule Scheduler.

When you schedule the scheduler job (for example, if the traffic light for the scheduler status is red) you can enter the corresponding data in the dialog box.

If the scheduler job is already scheduled (the traffic light for the scheduler status is green), a corresponding message appears.

Displaying the Scheduler Log

To display the entire scheduler log, choose Display Scheduler Logs. This takes you to a standard application log, where you can search in the message texts for errors or for IDs of processed messages, for example.

Displaying Messages

If the number of messages stopped by a message filter and assigned to the job is greater than 0, you can list the messages individually by double-clicking the number displayed under Messages per Job. This displays the message ID and the quality of service (QoS). You can display each message in detail.

You can also navigate to message monitoring and Display All Messages () or display individual messages in detail (by selecting the message ID).