BMC AMI DevX Workbench Utilities
Overview
BMC AMI DevX Workbench Utilities provides for submitting JCL datasets or members jobs on the mainframe from the CI/CD pipeline.
Prerequisites
The following are required to use this extension:
- Azure Pipelines - in Azure DevOps Services or Azure DevOps Server
- BMC AMI Common Configuration Extension
- BMC AMI DevX Workbench for Eclipse (Workbench for Eclipse) CLI version 19.02.01 or later. Refer to the BMC AMI DevX Workbench for Eclipse Installation Guide for instructions.
- A valid BMC AMI DevX Code Analysis, BMC AMI DevX Data Studio, or BMC AMI DevX Total Test license
- Host Communications Interface
Installing in Azure Pipelines - in Azure DevOps Services or Azure DevOps Server
- Install the BMC AMI DevX Workbench Utilities extension according to the Azure DevOps Server instructions for installing extensions. Dependent extensions will automatically be installed.
- Install the Workbench for Eclipse CLI on the Azure DevOps Pipeline Agent that will execute the extension. The Workbench CLI is available in the Workbench for Eclipse installation package. If you do not have the installation package, please visit support.bmc.com. For Workbench for Eclipse CLI installation instructions, please refer to the BMC AMI DevX Workbench for Eclipse Installation Guide.
Configuring the Workbench for Eclipse CLI and Host Connections
To use Workbench utilities, you will need to point to an installed Workbench for Eclipse Command Line Interface (CLI) that has host connections configured. For more information, see Configuring for Workbench for Eclipse CLI and Host Connections
Submitting JCL datasets or members on the mainframe
This integration allows submitting JCL datasets or members on the mainframe. Perform the following steps:
When creating the new Azure pipeline, add a new task BMC AMI DevX Workbench Utilities by clicking the + icon on the Agent Job.
This task has following parameters:
Host connection : Select the host connection to be used to connect to the z/OS host. Alternatively, to add a connection,click on the BMC AMI Common Configuration extension in the application hub.
User Id : Enter the user ID to use for logging onto the z/OS host.
Password : Pass pipeline variable name, which stores the Password as a secret in the Azure pipeline. For example: $(variablename). The password is stored against the UserID provided in UserId field.
Maximum condition code : Enter the maximum condition code or you can choose to the keep the default value. Submitting of JCL jobs will terminate if any job's return code is greater than the maximum condition code.
Windows Workbench for Eclipse CLI Home : Select an option from the pre-populated list, which is configured in the BMC AMI Common Configuration extension.
Select JCL Format : Select any option from 'Free form JCL' or 'JCL Members' according to the requirement. Based on this selection, inputs will be presented to enter JCL or Dataset members. Based on the inputs provided, jobs will be submitted.
JCL(Enter free-form JCL): Enter the JCL statements.
Dataset(member): List the JCL dataset or dataset members, each on a separate line.
Click Save.
Run the pipeline, which submits each specified JCL dataset or member on the mainframe.
Product Assistance
BMC provides assistance to customers with its documentation, the BMC Support website, and via telephone call with the Customer Support team.
BMC Support Central
You can access online information about BMC products via our Support site,https://support.bmc.com. Support Central provides access to critical information about your BMC 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 Support Central, you must register and obtain a password. The registration is free.
At BMC, 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 BMC's 24-hour telephone support:
The Azure pipeline job output that contains any error messages or pertinent information.
The name, release number, and build number of your product. This information is displayed in the installed extensions page. Apply the filter, BMC, to display all the installed BMC extensions.
Environment information, such as the operating system and release on which the Workbench for Eclipse CLI is installed.
Web
You can report issues via BMC Support website: https://support.bmc.com.
Note: Please report all high-priority issues by phone.
Corporate Website
To access the BMC website, go to https://www.bmc.com/. The BMC site provides a variety of product and support information.