...
Panel | |
---|---|
|
Disclaimer
Your use of this download is governed by Stonebranch’s Terms of Use, which are available at https://www.stonebranch.com/integration-hub/Terms-and-Privacy/Terms-of-Use/
Overview
AWS Mainframe Modernization allows migrating and modernizing on-premises mainframe workloads to a managed runtime environment on AWS. This Universal Extension provides customers that are migrating or modernizing their mainframe applications to AWS Cloud the ability to automate and schedule their tasks in Micro Focus and Blu Age environments.
Version Information
Template Name | Extension Name | Extension Version |
---|---|---|
AWS Mainframe Modernization | ue-aws-mainframe-modernization | 1.4.0 |
Refer to Changelog for version history information.
Software Requirements
This integration requires a Universal Agent and a Python runtime to execute the Universal Task.
Software Requirements for Universal Template and Universal Task
Requires Python 3.7.0 or higher. Tested with the Universal Agent bundled Python distribution.
Software Requirements for Universal Agent
Both Windows and Linux agents are supported:
- Universal Agent for Windows x64 Version 7.0.0 and later with python options installed.
- Universal Agent for Linux Version 7.0.0 and later with python options installed.
Software Requirements for Universal Controller
Universal Controller Version 7.0.0.0 and later.
Network and Connectivity Requirements
The extension's Universal Agent host should be able to establish a connection with:
- AWS Mainframe Modernization endpoints (The provided AWS Credentials should have sufficient permissions on AWS to execute required actions).
Key Features
This Universal Extension provides the following main features:
- The ability to schedule, automate and execute mainframe batch jobs running in AWS Mainframe Modernization Service via Stonebranch Universal Controller
- Support for Micro Focus and Blu Age Jobs
- Monitor Application’s batch processes from the Stonebranch Universal Controller
- Start/Restart/Rerun/Cancel batch processes automatically or manually from the Stonebranch Universal Controller
- Synchronous and asynchronous batch execution from Stonebranch Universal Controller
- Retrieve the results of the AWS Mainframe Modernization Batch processes
- Capture the AWS Cloudwatch logs of the executed jobs in Stonebranch Universal Controller.
Import Universal Template
To use the Universal Template, you first must perform the following steps.
This Universal Task requires the Resolvable Credentials feature. Check that the Resolvable Credentials Permitted system property has been set to true.
To import the Universal Template into your Controller, follow the instructions here.
When the files have been imported successfully, refresh the Universal Templates list; the Universal Template will appear on the list.
Modifications of this integration, applied by users or customers, before or after import, might affect the supportability of this integration. For more information refer to Integration Modifications.
Configure Universal Task
For a new Universal Task, create a new task, and enter the required input fields.
Input Fields
The input fields for this Universal Extension are described below.
Field | Input type | Default value | Type | Description |
---|---|---|---|---|
Action | Required | List Environments | Choice | Action performed upon the task execution. Available actions are as follows.
|
Region | Optional | - | Text | Region for the Amazon Web Service. |
AWS Credentials | Optional | - | Credentials | The Credentials definition should be as follows.
|
End Point | Optional | - | Text | Optional field. If not provided the endpoint will be generated using the Region filed value. |
Application | Optional | - | Dynamic Choice | The application name on which the action will be performed. The user can dynamically fetch the application name from AWS. Visible only when Action is:
Required when visible |
Force Stop | Optional | false | Boolean | Initiate a force-stop action toward an application. Visible only when Action is:
|
Execution Id | Optional | - | Text | Batch execution Id to be canceled. Visible only when Action is:
Required when visible |
Filter Pattern | Optional | - | Text | A pattern that will be used as a filter during logs fetching. Visible only when Action is:
|
Log Stream Name | Optional | "*" | Text | Log stream name to be fetched. Visible only when Action is:
|
Fetch Log Format | Optional | "Text" | Choice | Format of log to be fetched.
Visible only when Action is:
|
JCL File Name | Optional | - | Text | Name of the JCI File to be executed. Visible only when Action is:
and JCL File Variable is selected |
JCL File | Optional | - | Dynamic Choice | JCI File to be executed. Dynamic Choice field can only be used with Micro Focus applications. Will not work for Blu Age applications. Visible only when Action is:
and JCL File Variable is not selected |
JCL File Variable | Optional | false | Boolean | If selected, the JCL File Name field will be visible to enable entering the JCL file name in a text format. This allows using variables in the JCL File Name. |
JCL File Name (Temp) | Optional | - | Text | Name of the JCI File to be executed. This field value will overwrite the value of "JCL File Name" for the current execution (used in case of re-run). Visible only when Action is:
|
Wait for Success or Failure | Optional | true | Boolean | If selected, the task will continue running until Job reaches the "SUCCEDED" or "FAILED" state. Visible only when Action is:
|
Polling Interval | Optional | 10 | Integer | The polling interval in seconds between checking for the Job status. Visible only when "Wait for Success or Failure" is True |
Fetch Execution Logs | Optional | true | Boolean | Fetch logs from cloud-watch when the task is completed. Visible only when "Wait for Success or Failure" is True |
Log Format | Optional | "Text" | Choice | Format of fetched logs. Visible only when "Fetch Execution Logs" is True |
Task Examples
Start Batch Job
JCL File Variable
Task Instance with JCL File from the dropdown
Starting Blu Age Batch
Start Batch Job Result Example:
...
Start the Application and wait for the execution
Cancel Batch Execution
Fetch logs
Task Output
Output Only Fields
The output fields for this Universal Extension are described below.
Field | Type | Description |
---|---|---|
Application Id | Text | The application Id resulted after starting an application. |
Batch Execution Id | Text | The batch execution Id resulted after starting a batch job. |
Batch Job Id | Text | The batch job id resulted after starting a batch job. |
Exit Codes
The exit codes are described below.
Exit Code | Status Classification Code | Status Classification Description | Status Description |
---|---|---|---|
0 | SUCCESS | Successful Execution | <successful execution message> |
1 | FAILED | Failed Execution | FAILED: <Error Message> |
103 | FAILED | Task Cancelled or Stopped |
|
104 | FAILED | Task Failed | Task failed because of the status of the AWS Batch Job Status |
STDOUT and STDERR
STDERR provides the integration's execution log.
STDOUT provides the AWS API response, which might be changed in future versions of this API.
Integration Modifications
Modifications applied by users or customers, before or after import, might affect the supportability of this integration. The following modifications are discouraged to retain the support level as applied for this integration.
- Python code modifications should not be done.
- Template Modifications
- General Section
- "Name", "Extension", "Variable Prefix", "Icon" should not be changed.
- Universal Template Details Section
- "Template Type", "Agent Type", "Send Extension Variables", "Always Cancel on Force Finish" should not be changed.
- Result Processing Defaults Section
- Success and Failure Exit codes should not be changed.
- Success and Failure Output processing should not be changed.
- Fields Restriction Section
- Default configured values should not be changed.
- General Section
Users and customers are encouraged to report defects or feature requests at Stonebranch Support Desk.
Document References
This document references the following documents.
Document Link | Description |
---|---|
Universal Templates | User documentation for creating, working with and understanding Universal Templates and Integrations. |
Universal Tasks | User documentation for creating Universal Tasks in the Universal Controller user interface. |
AWS Mainframe Modernization | User guide for AWS Step Functions. |
...
ue-aws-mainframe-modernization-1.3.7 (2022-10-17)
This is the first official version approved by AWS.