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 auto-
reaction 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.