Setting up the dashboard application

The dashboard application is a dynamic scripting application that runs in a JVM server.

Before you begin

You must download and install the CICS® Dynamic Scripting Feature Pack V2.0. The feature pack is freely available to download from the IBM® website. To install the feature pack, see Installing and configuring CICS TS Feature Pack for Dynamic Scripting V2.0.

About this task

The CICS Dynamic Scripting Feature Pack provides an agile web application platform for developing and running modern web applications. The dashboard application uses a mixture of DOJO, Groovy, and HTML to present the information from the emitted events to the business analyst.

The dashboard application is available to download from the feature pack samples website.

Procedure

  1. Use telnet or OMVS to access the zFS directory where the dynamic scripting feature pack is installed.
  2. Customize the global configuration file to use the application-owning region.
  3. Add the URL for the feature pack samples website by entering this command:
    zero modulegroup addurl http://download.boulder.ibm.com/ibmdl/pub/software/htp/cics/updates/ds/1.1/repo/samples/
  4. To create the dashboard application, switch into the apps directory and enter this command:
    zero create cbtm from zero_cics_genapp_cbtm_demo
    When you enter this command, the feature pack downloads the sample using the specified URL and creates the application in the apps/cbtm directory.
  5. Optional: Switch to the cbtm directory and edit the zero.config file to set the port number to use in your web browser. The default value is 8080.
  6. Start the application from the cbtm directory by entering the command zero start. The feature pack dynamically creates a JVM server in the AOR and installs the Java™ application.
  7. Open a web browser and log on to the dashboard application. Use the format http://hostname:port, where hostname and port are the values that you set in the global and application configuration files.

Results

The dashboard application is installed and running in the JVM server. The dashboard has four sections:
  • The Control section defines how often the application refreshes the data from the shared temporary storage queues. It also shows when the data was last refreshed.
  • The Transaction Rates per second section shows how many business transactions have occurred for each type every second.
  • The Chart Div section shows the transaction rates data as a pie chart.
  • The Data Table section shows each request type, and how many have occurred since event processing was enabled.

What to do next

Verify the solution by running transactions in the general insurance application and checking the results in CICS Explorer® and the dashboard application.


configure_dashboard.html | Timestamp icon Last updated: Sunday, 4 June 2017