Monitoring Background Jobs with CCMS

Prerequisites
Confirm that SAPConnect (transaction SCOT) is configured correctly for
both email and paging in client 000 of the monitoring system.
Background Job Failure Notification Configuration
To allow for the notification of an individual or group when a certain
job does not complete successfully, additional setup is required
before the job monitor can be configured.
First, make sure that a distribution list with the contact information
for the individuals or groups which will require notification has been
created in client 000 of the monitoring system (for information on
creating SAP distribution lists see section Creating a Shared
Distribution List).
Next, if an appropriate auto-response method has not yet been defined
in CCMS one will need to be created. To do so, log on to the
monitoring system and call transaction RZ21. In the Methods section,
select the Method definitions radio button and click Display overview.

In the resulting list, select a method which already performs the

desired function (ex. zBT_ar_email_dl_DL_EMAIL for emailing or
zBT_ar_page_dl_DL_PAGE for paging) and click the copy button.

In the resulting dialog, specify a name for the new method and confirm
the copy by clicking the green checkmark.
Recommended naming convention for auto-reaction methods:
zBT_<method type>_<notif type>_<contact type>_<contact>
Example: zBT_ar_email_dl_CCMS_AR_EM01
Method Type
ar
Auto-Reaction Method
Notif Type
email
Method sends an email
Contact Type dl
Notify a distribution list
Contact
CCMS_AR_EM01 Dist-List CCMS_AR_EM01

The newly created method is now displayed. Enter change mode and
change the description for the method to an appropriate value.
On the Parameters tab and set the SENDER to a SAP user in client 000
which has an email address maintained in its user master record. For
RECIPIENT enter the name of the appropriate distribution list and for
RECIPIENT-TYPE enter C.

On the Release tab, check the Auto-Reaction Method checkbox to

classify the new method.

Save the new auto-reaction method by clicking the save button. The
new auto-reaction method has been created and is ready for use.

Add the job to be monitored to CCMS

Before a background job can be monitored by CCMS, the job name needs
to be entered in table ALBTCMON. To do this, log on to the system on
which the background job which needs to be monitored is scheduled and
call transaction SE16. Enter table ALBTCMON and press <Enter>

On the selection screen, just click Execute to display all of the

entries in the table. To add a new row, select a row which already
exists and choose the menu option Table entry -> Create with Template.

For the new entry confirm that the correct system ID is displayed and
enter the name of the background job which is to be monitored. To
save the new entry, click the save button.

The background job will now show up in CCMS as available for

monitoring after the next system restart. To make the job available
for monitoring without a system restart, follow the instructions
contained in the section Restarting the Local System Monitoring
Segment.

Configuring the New Monitor

Once the above steps have been completed, you are ready to configure
monitoring for the job in CCMS. To start, call transaction RZ20 in
the monitoring system. Activate the CCMS maintenance functions by
selecting the menu option Extras -> Activate maintenance function.

Expand the CCMS monitor sets tree until the appropriate monitor set is
displayed.

Select the monitor set to which the new job should be added by single
clicking on it and press the change button.

The Edit monitor definition screen is displayed. Expand the structure

to locate the new job which is to be added. The job should be in the
structure under Selectable MTE -> <SID> -> Background -> Background
Job Monitoring

To add the job to the monitor set, expand the node with the name of
the background job and select the checkbox next to the line Status.
Save the changed monitor set by clicking the save button.

After saving, you will be returned to the main screen of RZ20.

Now that the job has been added to the correct monitor set the
appropriate auto-reaction method needs to be associated with it. To
do this, from the main screen in RZ20, double-click on the monitor set
to which the job was added. A list of all jobs which are included in
that monitor set will be displayed. Select the checkbox next to the
newly added job and click the Properties button.

The properties screen of the background job monitor are displayed.

Select the Methods tab and click the Method assignment button in the
Methods effective for MTE nodes section.

The resulting screen displays the methods which are currently assigned
to the job monitor. Enter change mode and select the Auto-reaction
tab. In the Method allocation section, select the Method name radio
button and enter the name of the method which was created earlier.

Save the method assignment and the monitor setup is now complete.
Note: when backing out of the method assignment screen immediately after adding the
auto-reaction method the method association will not be displayed even though it
exists. Back all the way out of the transaction and when you go back in, the autoreaction method will be visible.

Confirming Open CCMS Alerts

After a background job has been set up for monitoring in CCMS,
whenever the job fails a CCMS alert will be opened and the appropriate
individuals will be notified via the auto-reaction method.
When a notification of job failure is received, the recipient should
then confirm the open alert in CCMS to acknowledge awareness of the
job failure.
To confirm an open alert in CCMS, log on to the system/client in which
the job failed and call transaction RZ20. Drill down to the
appropriate monitor set and select it by double-clicking.

A list of all jobs which belong to that monitor set are displayed.
Select the checkbox next to the job for which the alert was received
and click the Open alerts button.

The display now shows all jobs and whether they have open
(unconfirmed) alerts. To display or complete the alerts for a
particular job, select the checkbox next to the job name and click the
Display alerts button.

To complete the alert, select box to the left of the alert line and
click the Complete alerts button.

Upon completion, the alert should be removed from the screen and the
open alerts branch for the job in the monitor set will now be green,
indicating that there are no open alerts.

Restarting the Local System Monitoring Segment

Whenever a new job is added to table ALBTCMON for monitoring it will
not immediately available for monitoring in CCMS. To make the job
available for immediate monitoring, without a system restart, you can
manually restart the Monitoring Segment (WARNING: Manually restarting
the segment will also restart all CCMS data collection methods for the
selected segment). To restart the local system monitoring segment,
call transaction RZ21 and select the menu option Technical
infrastructure -> Display Topology

In the Display Technical Topology screen, enter into change mode and
select the Local Segments tab. Select the line for the Appl. Server
segment which should be restarted and click the Reset Segment in
"WARMUP" Status. Confirm any informational messages which are
displayed and the monitoring segment will be restarted.

Upon successful restart of the monitoring segment, all background jobs

in table ALBTCMON will be immediately available for monitoring.

Creating a Shared Distribution List

In order to send an auto-reaction email to a group of users or send an
auto-reaction page to anybody a SAP Business Workplace distribution
list is required.
To create a distribution list, log on to client 000 in the monitoring
system and call transaction SBWP. From the main screen, click the
Distribution lists button.

In the resulting screen, to create a new distribution list, click the

Create button.
Give the new distribution list a name and enter an appropriate title.
In the Features section, select the drop-down help for the Folder
field.

In the resulting pop-up box, enter the same name that was entered for
the distribution list in the Folder name field and the title of the
distribution list in the Folder title field. Make sure that the
Shared radio button is selected and click the Create folder button.

Confirm that the values are correct for the folder to be created and
click the green checkmark.

Confirm the folder selection dialog by clicking the green checkmark.

Select the Distr. list content tab for the new distribution list and
list enter all recipients which should receive the auto-reaction
notification as well as the recipient type and click the save button
to create the list.