README.md

XL Release ISPW plugin

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

  

• GetReleaseInformation

  

• GetReleaseTaskList

  

• Promote

  

• Regress

  

• Deploy

  

Others

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

Sets

Some examples

• GetSetInformation

  

• GetSetTaskList

  

• GetSetDeploymentInformation

  

• FallbackSet

  

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

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

Default Display - all ISPW tasks on the ISPW Summary Page

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

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