test

Monitoring Java CAPS Business Processes

Monitoring Java CAPS Business Processes

Thie topics listed here provide links to task, conceptual and reference information for monitoring a Java CAPS Business Process (BP). If you have any questions or problems, see the Java CAPS web site at http://goldstar.stc.com/support.

Enterprise Manager allows you to monitor BPs and identify problems with components or systems. From Enterprise Manager, you can double-click BP components to go directly to a problem.

Business Process Instance Monitor Overview

After you have configured BPM persistence, you can use Enterprise Manager to monitor your BP instances. The procedures in this section help ensure that BPs appear in Enterprise Manager as expected. From Enterprise Manager, you can:

Before you connect to Enterprise Manager, verify that the Adobe SVG Plug-in for Enterprise Manager is installed. Before you begin monitoring BPs, you must deploy and manage any necessary application servers in Enterprise Manager.

From the Enterprise Manager’s Business Process Instance Monitor tab, you can suspend, resume, and terminate BP instances. You can also refresh the BP instance lists, change monitoring options, filter BP instances, and view the BP instances and their associated BP instances in various ways.

The Business Process Instance Monitor page provides a set of toolbars for viewing and evaluating BP instances. Before you start monitoring BP instances, be sure to acquaint yourself with these tools.

Display Toolbar

The icons at the upper left of the Business Process Instance Monitor toolbar control the graphic display of BP instances as well as BP instance lists. describes each icon.

Table 1 Business Process Instance Monitor: Display Icons

Name 

Description 

Show Business Process Model

Displays the image of a BP instance in the Details window. 

Hide Business Process Model

Hides the image of a BP instance in the Details window. 

Show List of Business Process Instances

Displays the attributes of the current BP instance in list format, and adds the tools described in . You can only view information about a BP that has been configured for persistence. 

Hide List of Business Process Instances

Hides the attributes of the current BP instances and removes the instance tools from the interface. 

Business Process Model Toolbar

When Show Business Process Model is selected, a toolbar appears in the upper right of the Business Process Instance Monitor just beneath the main toolbar. This toolbar allows you to control the display of the graphic model of the BP instance. lists and describes the icons on the Business Process Model toolbar.

Table 2 Business Process Instance Monitor: Business Process Model Toolbar

Name 

Description 

Alert to Enable Monitoring

Alerts you to enable monitoring in the BPM Engine Configuration Properties in order to see BP activity status and details in the Business Process Instance Monitor. 

Enable Zoom and Pan

Enables zooming and panning of the BP instance view. 

Disable Zoom and Pan

Disables zooming and panning of the BP instance view. 

Zoom Out

Zooms out to a lower percentage view of the BP instance. 

Zoom In

Zooms in to a higher percentage view of the BP instance. 

100%

Changes the percentage of the view to 100%. 

Fit All

Changes the percentage of the view so the entire BP instance fits in the Show Business Process Model panel. 

Fit Width

Changes the percentage of the view so that the width of the BP instance fits in the Show Business Process Model panel. 

Fit Height

Changes the percentage of the view so that the height of the BP instance fits in the Show Business Process Model panel. 

Business Process Instance Toolbar

When Show list of Business Process Instances is selected, you can manipulate the view of BP instance data using the icons described in . These icons are located at the right of the Business Process Instance Monitor toolbar.

Table 3 Business Process Instance Monitor: Business Process Instance Toolbar

Name 

Description 

Refresh list of Business Process Instances

Refreshes the entire BP instance list. 

Refresh Filtered list of Business Process Instances

Refreshes a filtered list of BP instances. 

Choose Preferences

Allows you to add, move, and sort the columns in the BP instance. 

Change Attribute Display Names

Allows you to change the display name of BP instance attributes. 

Suspend

Suspends a BP instance. 

Resume

Resumes a suspended BP instance. 

Terminate

Terminates a BP instance. 

Filter Business Process Instances

Allows you to set criteria to display a specific instance or group of instances. 

Business Process Instance Attributes

Displays the XML content of each BP instance attribute. 

Activity Details

Displays a dialog box with the details of the activity that is selected in the BP model, including the following information: 

  • Start Time

  • End Time

  • Status

  • Message input/output (XML viewer)

  • Exception content

    Each activity represents a step within the BP.

Go To Caller

Takes you to the calling BP instance, such as a parent BP. 

Go To Callee

Takes you to a called BP instance, such as a child BP. 

Legend

Displays a window with a legend of the colors used to show the status of a BP instance, as shown below. 

Monitoring Business Processes

In order to monitor BPs, you must perform a series of steps to configure individual BPs for monitoring. If you do not perform these steps, you can still view the BP on the Business Process Instance Monitor, but you cannot perform all the functions of the monitor and cannot view detailed information about each BP instance. Information about the Project components is available whether you configure the BP for persistence or not.

Before you can monitor a BP, you need to configure the BPM Engine for monitoring, and you need to create the monitoring and recovery database.

Monitoring New Business Processes

The following procedure provides the steps for monitoring a new BP in Enterprise Manager.

ProcedureTo monitor a new BP

  1. In the Enterprise Designer Project Explorer, open the BP.

  2. In the BP properties, set the Persistence for Reporting property to Yes.

  3. Save the BP.

  4. In the Project Explorer, expand the BP and then expand Database Scripts.

  5. Define the database connection properties and run the scripts against the database.

  6. Open the Deployment Profile and build and deploy the Project.

  7. In a web browser, connect to Enterprise Manager and log in.

  8. In the Enterprise Manager Explorer, navigate to the correct Server, Project, Deployment Profile, and Connectivity Map containing the BP you want to monitor, and then click the BP name.

  9. In the Business Process Instance Monitor toolbar, click Show list of Business Process Instances.

Monitoring Modified Business Processes

The following procedure provides the steps for monitoring a modified BP in Enterprise Manager.

Note –

This process involves rerunning the database script for the BP, which creates a new database table for the BP. After you perform these steps, the BP instance list only displays information about events that occurred after you redeployed the application.

ProcedureTo monitor a modified BP

  1. In the Enterprise Designer Project Explorer, check out the BP.

  2. Modify the BP as necessary.

  3. Save all changes.

  4. Check in the BP.

  5. Check out the BP.

  6. Run the database script again for the BP.

  7. Open the Deployment Profile, and rebuild and redeploy the Project.

  8. In a web browser, connect to Enterprise Manager and log in.

  9. In the Enterprise Manager Explorer, navigate to the correct Server, Project, Deployment Profile, and Connectivity Map containing the BP you want to monitor, and then click the BP name.

  10. In the Business Process Instance Monitor toolbar, click Show List of Business Process Instances.

Monitoring Business Processes in an Imported Project

The following procedure provides the steps for monitoring BPs in an imported Project.

ProcedureTo monitor BPs in an imported Project

  1. Import the Project into Enterprise Designer.

  2. Check out any BPs.

  3. Open and save each BP.

    Note –

    If a BP has user activities or special OTDs, open and close each of them to ensure that they register with the monitor.

  4. Check in each BP.

  5. Check out each BP.

  6. Run the database script again for each BP.

  7. Open the Deployment Profile, and rebuild and redeploy the Project.

  8. In a web browser, connect to Enterprise Manager and log in.

  9. In the Enterprise Manager Explorer, navigate to the correct Server, Project, Deployment Profile, and Connectivity Map containing the BP you want to monitor, and then click the BP name.

  10. In the Business Process Instance Monitor toolbar, click Show List of Business Process Instances.

Changing the Status of a Business Process Instance

From the Business Process Instance Monitor, you can suspend, resume, and terminate current BP instances.

ProcedureTo change the status of a BP instance

  1. In the list of BP instances, select the instance you want to modify.

  2. To pause the BP instance, click Suspend.

  3. To restart the BP instance, click Resume.

  4. To terminate the BP instance, click Terminate.

    Terminated instances cannot be restarted.

Configuring the Business Process Instance Display

When BPs are configured for reporting persistence, you can configure the display of the BP information, and suspend, resume, and terminate a BP.

Choosing Business Process Attributes to Display

In the list of BP instances, you can change the following options:

The following procedure provides the steps for choosing Business Process attributes to display in the list of Business Process instances.

ProcedureTo choose BP attributes to display

  1. In the Business Process Instance Monitor toolbar, click Choose Preferences.

    The Choose Business Process Attributes to Display dialog box appears.

  2. To hide columns that are currently visible in the list of BP instances, do the following:

  3. In the Chosen Columns list, select the columns you want to hide.

  4. Click the double left arrow button to move the selected columns to the Available Columns list.

  5. To display columns that currently do no appear in the list of BP instances, do the following:

  6. In the Available Columns list, select the columns you want to show.

  7. Click the double right arrow button to move the selected columns to the Chosen Columns list.

  8. In the Maximum Rows Per Page field, enter the number of rows you want to display on each page of the list of BP instances.

  9. In the Instance List Refresh Rate field, enter the number of seconds you want to pass between refreshes of the list of BP instances.

  10. In the Number of BP Instances field, enter the maximum number of BP instances you want to monitor.

  11. Click Change Preferences.

Changing the Display Name of an Attribute

If you prefer to monitor BP instance attributes using shortened names, you can change the display names of the attributes you want to include in the list of BP instances. The following procedure provides the steps for changing the display names of BP instance attributes.

ProcedureTo change the display name of an attribute

  1. In the Business Process Instance Monitor toolbar, click Change Attribute Display Names.

    The Change Attribute Display Name dialog box appears.

  2. In an attribute display name field, edit the text of the attribute display name.

  3. Continue editing these text fields as necessary.

  4. Click Submit.

  5. To return the attribute display names to their default settings, click Change Attribute Display Names again, and then click Reset on the dialog box.

Filtering Business Process Instances

You can filter the list of BP instances in order to see only BP instances that meet a specific set of criteria. The Filter Business Process Instance dialog box provides the following filters.

ProcedureTo filter the list of BP instances

  1. In the Business Process Instance Monitor toolbar, click Filter Business Process Instances.

    The Filter Business Process Instances dialog box appears.

  2. In the Status field, select a BP status.

  3. In the Time Stamp field, select a time stamp type.

  4. In the From field, click Select Date and/or Time and select the date or time.

  5. In the To field, click Select Date and/or Time and select the date or time.

  6. In the Business Process Attribute field, select the attribute and filter criteria operator and text.

  7. Click Filter.

Viewing the Content of a Business Process Attribute

The Business Process Instance Attributes tool allows you to view the XML content of all the attributes in a BP.

ProcedureTo view the content of a BP attribute

  1. In the Business Process Instance Monitor toolbar, click Business Process Instance Attributes.

    The Business Process Instance Attributes dialog box appears with a list of each attribute and its XML content.

  2. To see the XML content in a structured XML viewer, click View XML.

Viewing Activity Details

The Activity Details tool allows you to view details of the selected activity, including the following information:

ProcedureTo view activity details

  1. In the BP, select the activity for which you want to view details.

  2. In the Business Process Instance Monitor toolbar, click Activity Details.

    The Activity Details dialog box appears.

    Figure 1 Activity Details Dialog Box

    Figure shows the Activity Details dialog box in the Enterprise Manager.

  3. To see the XML content of the input, output, or exception message in a structured XML viewer, click View XML.

Monitoring Load-Balanced Business Process Instances

When you are monitoring load-balanced BP instances in recovery mode, single BP instances appear to be multiple BP instances on multiple BPM Engines. This is a normal result of load balancing a BP across multiple BPM Engines.