Skip to content

xebialabs-community/xlr-ispw-plugin

Repository files navigation

XL Release ISPW plugin

Codacy Badge Code Climate License: MIT Github All Releases

Preface

This document describes the functionality provided by the xlr-ispw-plugin.

See the XL Release Documentation for background information on XL Release and release concepts.

Overview

This is a plugin allowing to interact from XL Release with ISPW for deploying, promoting, ... applications on the mainframe.

Installation

  • Minimal version XLR: 9.7.0+
  • The deploy and promote tasks are asynch tasks. This means you'll need to provide a callback task id, that can be used to let the task fail or pass. In order to this you can make use of the xlr-xlrelease-plugin which provides a task Get Task Id

Tasks

Assignments

  • Create Assignment
  • Load Task
  • Get Assignment Information
  • Get Assignment Task List
  • Get Assignment Task Information
  • Generate Tasks in Assignment
  • Promote Assignment
  • Deploy Assignment
  • Regress Assignment

Releases

Some examples

  • CreateRelease

    XLR Create Release

  • GetReleaseInformation

    XLR Get Release Information

  • GetReleaseTaskList

    XLR Get Release Task List

  • Promote

    XLR Promote

  • Regress

    XLR Regress

  • Deploy

    XLR Deploy

Others

  • Get Release Task Information
  • Generate Tasks in Release
  • Get Release Task Generate Listing

Sets

Some examples

  • GetSetInformation

    XLR Get Set Information

  • GetSetTaskList

    XLR Get Set Task List

  • GetSetDeploymentInformation

    XLR Get Set Deployment Information

  • FallbackSet

    XLR Fallback Set

Example Template

XLR Example Template

Wrappers

Two wrappers have been added to augment the functionality of some of the tasks.

  1. 409 Retry - All tasks can now be configured to retry for a set number of times at a set interval in the case that a status code of 409 is returned. The task will complete when a status other than 409 is returned or the retry limit is reached.
  2. Two new polling tasks have been added - Poll Get Set Information and Poll Get Set Deployment information
    1. Set single or multiple 'expected' values to look for
    2. Set the response field to look for the value
    3. Set the number of times to poll
    4. Set the polling interval
    5. If any of the expected values are found, the found value can be saved to a release variable

409 Retry Example

409 Retry Example

Poll Get Set Information

Poll Get Set Information

ISPW Tasks Tile

You can add a tile to the Release Dashboard to display the status and other meta data associated with ISPW tasks.

Add the ISPW Tile

Add Tile

Default Display - all ISPW tasks on the ISPW Summary Page

Display All

Default Detail Display - all ISPW tasks on the ISPW Detail Page

Details All

Filter Task Display

There are two ways to filter the display of ISPW tasks.

  • Configure the tile to filter by ISPW Task Type: You can configure the tile to display only the tasks that meet the filter criteria, either by exact string match of the task type or a wild card match that may match multiple task types.
    1. In the default detail display, make note of the task type you want to display
    2. Place the Dashboard in Edit Mode
    3. Click the ISPW Tile to configure
    4. Enter the exact task type string or a partial string followed by an asterisk * to use a partial string match.
  • On the Detail page, enter search criteria column title search boxes to filter the display

Configure Filter1

Configure Filter2

Filter Columns