{jenkins-plugin-info:compuware-ispw-operations}

Overview

The Compuware ISPW Operations plugin allows Jenkins users to execute ISPW operations, such as Generate, Promote, Deploy or Regress on the mainframe. Users can seamlessly integrate ISPW build process with Jenkins. 

Prerequisites

The following are required to use this plugin:

Installing in a Jenkins Instance


Configuring Host Connections and CES Tokens


Executing ISPW Operations

Using Pipeline Syntax to Generate Pipeline Script

  1. Do one of the following:

  2. From the Sample Step list, select ispwOperation: Perform a Compuware ISPW Rest API request and return a JSON object.

  3. From the Host connection list, select the host connection that contains a valid CES URL.

  4. From the CES secret token, select the corresponding CES token for the CES server.

  5. From the Action, select the ISPW operation to be performed.
  6. From the Request body, enter the corresponding properties for the specific action, click question mark help for more detail for each action
  7. Click Generate Pipeline Script. The Groovy script to invoke the Compuware ISPW Operations plugin appears. The script can be added to the Pipeline section when configuring a Pipeline job. A sample script is shown below:


    ispwOperation connectionId: 'e0fbb6eb-b01d-4d55-b18b-2f321c174474', credentialsId: 'f1d2762b-9a40-46ad-a9df-b982147acc85', ispwAction: 'GenerateTasksInAssignment', ispwRequestBody: '''assignmentId=PLAY000313
    level=DEV2
    runtimeConfiguration=TPZP'''

    For web hook callback, a sample script is shown below

    hook = ispwRegisterWebhook()
    echo "...creating ISPW Jenkins web hook - ${hook.getURL()}"

    ispwOperation connectionId: 'e0fbb6eb-b01d-4d55-b18b-2f321c174474', credentialsId: 'f1d2762b-9a40-46ad-a9df-b982147acc85', ispwAction: 'GenerateTasksInAssignment', ispwRequestBody: '''assignmentId=PLAY000313
    level=DEV2
    runtimeConfiguration=TPZP
    events.name=Completed
    events.body=Generated
    events.httpHeaders=Jenkins-Crumb:no-crumb
    events.credentials=admin:library'''

    echo "...waiting ISPW Jenkins web hook callback - ${hook.getURL()}"

    data = ispwWaitForWebhook hook
    echo "...CES called back with message: ${data}"


    Note: If the Response body in console checked, debug message will be printed on Jenkins log. 

Pipeline Build Requirement

In order to use pipeline build, your ISPW, CMSC and CES have to be configured properly in order to receive web hook notification. See explanation in the following figure.


Product Assistance

Compuware provides assistance for customers with its documentation, the FrontLine support web site, and telephone customer support.

FrontLine Support Web Site

You can access online information for Compuware products via our FrontLine support site at https://go.compuware.com. FrontLine provides access to critical information about your Compuware products. You can review frequently asked questions, read or download documentation, access product fixes, or e-mail your questions or comments. The first time you access FrontLine, you must register and obtain a password. Registration is free.

Compuware also offers User Communities, online forums to collaborate, network, and exchange best practices with other Compuware solution users worldwide. Go to http://groups.compuware.com/ to join.

Contacting Customer Support

At Compuware, we strive to make our products and documentation the best in the industry. Feedback from our customers helps us maintain our quality standards. If you need support services, please obtain the following information before calling Compuware's 24-hour telephone support:

You can contact Compuware in one of the following ways:

Phone

Web

You can report issues via FrontLine.

Note: Please report all high-priority issues by phone.

Corporate Web Site

To access Compuware's site on the Web, go to https://www.compuware.com. The Compuware site provides a variety of product and support information.

Change Log

Version 1.0.3



Version 1.0.2