Tutorial: Setting up a CI/CD pipeline for use with Rocket Enterprise Developer (formerly Micro Focus Enterprise Developer)

1. Sign in to the AWS Management Console and open the AWS CloudFormation console at https://console.aws.amazon.com/cloudformation.

2. Create a new stack by using one of the following options:

   • Choose Create Stack. This is the only option if you have a currently running stack.

   • On the Stacks page, choose Create Stack. This option is visible only if you have no running stacks.

3. On the Specify template page:

   • In Prepare template, choose Template is ready.

   • In Specify template, choose Amazon S3 URL as the template source and enter one of the following URLs depending on your AWS Region.

     • https://m2-us-east-1.s3.us-east-1.amazonaws.com/cicd/mf/basic-infra.yaml

     • https://m2-eu-central-1.s3.eu-central-1.amazonaws.com/cicd/mf/basic-infra.yaml

   • To accept your settings, choose Next.

   The Create stack page opens.

   

   Make the following changes:

   • Provide appropriate values for Stack name and parameters for Networking Configuration.

   • Most parameters in Deployment Configurations are pre-populated appropriately so you don’t need to modify them. Depending on your AWS Region, change the pipeline AWS CloudFormation template to one of the following Amazon S3 URLs.

     • https://m2-us-east-1.s3.amazonaws.com/cicd/mf/pipeline.yaml

     • https://m2-eu-central-1.s3.eu-central-1.amazonaws.com/cicd/mf/pipeline.yaml

   • Choose Next.

   Note

   Don’t change the default parameter values unless you have modified the AWS CloudFormation template yourself.

4. In Configure stack options, choose Next.

5. In Capabilities, choose I acknowledge that AWS CloudFormation might create IAM resources to allow permission for AWS CloudFormation to create IAM Role on your behalf. Choose Create stack.

   Note

   It can take 3 to 5 minutes for this stack to be provisioned.

6. After the stack has been created successfully, navigate to the Outputs section of the newly provisioned stack. There you'll find the Amazon S3 bucket where you need to upload your mainframe code and dependent files.

   

1. Download the BankDemo sample application to your local machine.

2. Upload bankdemo.zip from your local machine to the Amazon S3 bucket created in Create CI/CD pipeline basic infrastructure.

3. Download config_git.yml.

4. Modify the config_git.yml if needed, as follows:

   • Add your own target repository name, target branch and commit message.

     repository-config:
       target-repository: bankdemo-repo
       target-branch: main
       commit-message: Initial commit for bankdemo-repo main branch

   • Add the email address you want to receive notifications.

     pipeline-config:
       # Send pipeline failure notifications to these email addresses
       alert-notifications:
         - myname@mycompany.com
       # Send notifications for manual approval before production deployment to these email addresses
       approval-notifications:
         - myname@mycompany.com 

5. Upload the config_git.yml file containing the definition of the CodeCommit repository folder structure to the Amazon S3 bucket created in Create CI/CD pipeline basic infrastructure. This will invoke the Lambda function that will automatically provision the repository and pipeline.

   This will create a CodeCommit repository with the name provided in the target-repository defined in the config_git.yml file; for example, bankdemo-repo.

   The Lambda function will also create the CI/CD pipeline stack through AWS CloudFormation. The AWS CloudFormation stack will have the same prefix as the target-repository name provided followed by a random string (for example bankdemo-repo-01234567. You can find the CodeCommit repository URL and the URL to access the created pipeline in the AWS Management Console.

   

6. If the CodeCommit repository creation is complete, the CI/CD pipeline will be triggered immediately to perform a full CI/CD.

7. Once the file has been pushed it will automatically trigger the pipeline which will build, deploy in staging, run some tests and wait for manual approval before getting it deployed in the production environment.

1. Start Enterprise Developer from Windows Start. Choose Micro Focus Enterprise Developer, then choose Enterprise Developer for Eclipse. If you are starting for the first time, it might take some time.

2. In the Eclipse Launcher, in Workspace: enter C:\Users\<username>\workspace then choose Launch.

   Note

   Make sure you choose the same location after reconnecting to the AppStream 2.0 instance. Workspace selection is not persistent.

3. In Welcome, choose Open COBOL Perspective. This will only be shown the first time for a new workspace.

1. Choose Window / Perspective / Open Perspective / Other ... / Git.

2. Choose Clone a Git repository.

3. In Clone Git Repository, enter the following information:

   • In Location URI, enter the HTTPS URL of the CodeCommit repository.

     Note

     Copy the Clone URL HTTPS for the CodeCommit repository in the AWS Management Console and paste it here. The URI will be split into the Host and Repository paths..

   • The user CodeCommit repository credentials in Authentication User and Password and choose Store in Secure Store.

4. In Branch Selection, choose Main branch, then choose Next.

5. In Local Destination, in Directory, enter C:\Users\<username>\workspace and choose Finish.

   The clone process is completed when BANKDEMO [main] is shown in the Git Repositories view.

1. Change to COBOL Perspective.

2. In Project, disable Build Automatically.

3. In File, choose New, then Mainframe COBOL Project.

4. In New Mainframe COBOL Project, enter the following information:

   • In Project name, enter BankDemo.

   • Choose Micro Focus template [64 bit].

   • Choose Finish.

5. In COBOL Explorer, expand the new BankDemo project.

   Note

   [BANKDEMO main] in square brackets indicates that the project is connected with the local BankDemo CodeCommit repository.

6. If the tree view does not show entries for COBOL Programs, Copybooks, BMS Source, and JCL Files, choose Refresh from the BankDemo project context menu.

7. From the BankDemo context menu, choose Properties / Micro Focus / Project Settings / COBOL:

   • Choose Character Set - ASCII.

   • Choose Apply, then Close.

8. If the build of the BMS and COBOL source does not immediately start, check in the Project menu, that the option Build Automatically is enabled.

   The Build output will be displayed in the Console view and should complete after a few minutes with messages BUILD SUCCESSFUL and Build finished with no errors.

   The BankDemo application should now be compiled and ready for local execution.

1. In COBOL Explorer, expand BANKDEMO / config.

2. In the editor, open BANKDEMO_ED.json.

3. Find string ED_Home= and change path to point to the Enterprise Developer project, as follows: D:\\<username>\\workspace\\BANKDEMO. Note the use of double slashes (\\)in the path definition.

4. Save and close the file.

5. Choose Server Explorer.

6. From the Default context menu, choose Open Administration Page. The Micro Focus Enterprise Server Administration page is opened in the default browser.

7. For AppStream 2.0 sessions only, make the following changes so you can preserve your local Enterprise Server region for local testing:

   • In Directory Server / Default, choose PROPERTIES / Configuration.

   • Replace Repository Location with D:\<username>\My Files\Home Folder\MFDS.

   Note

   You must complete steps 5 - 8 after every new connection to an AppStream 2.0 instance.

8. In Directory Server / Default, choose Import, then complete the following steps:

   • In Step 1: Import Type, choose JSON and choose Next.

   • In Step 2: Upload, click to upload file in blue square.

   • In Choose File to Upload, enter:

     • File name: D:\<username>\workspace\BANKDEMO\config\BANKDEMO_ED.json.

     • Choose Open.

   • Choose Next.

   • In Step 3: Regions clear Clear Ports from Endpoints.

   • Choose Next.

   • In Step 4: Import, choose Import.

   • Choose Finish.

   The list will now show a new server name BANKDEMO.

1. Choose Enterprise Developer.

2. In Server Explorer, choose Default, then choose Refresh from the context menu.

   The server list should now also show BANKDEMO.

3. Choose BANKDEMO.

4. From the context menu, choose Associate with project, then choose BANKDEMO.

5. From the context menu, choose Start.

   The Console view should display the log for the server startup.

   If the message BANKDEMO CASSI5030I PLTPI Phase 2 List(PI) Processing Completed is displayed, the Server is ready for testing the CICS BANKDEMO application.

1. From Windows Start, launch Micro Focus Rumba+ Desktop / Rumba+ Desktop.

2. In Welcome, choose CREATE NEW SESSION / Mainframe Display.

3. In Mainframe Display, choose Connection / Configure.

4. In Session Configuration, choose Connection / TN3270.

5. In Host Name / Address, choose Insert and enter IP address 127.0.0.1.

6. In Telnet Port, enter port 6000.

7. Choose Apply.

8. Choose Connect.

   The CICS welcome screen displays screen with row 1 message: This is the Micro Focus MFE CICS region BANKDEMO.

9. Press CTRL+Shift+Z to clear screen.

1. In an empty screen, enter BANK.

2. In screen BANK10, in the input field for User id.....:, enter guest and press Enter.

3. In screen BANK20, in the input field before Calculate the cost of a loan, enter / (forward slash) and press Enter.

4. In screen BANK70:

   • In The amount you would like to borrow...:, enter 10000.

   • In At an interest rate of................:, enter 5.0.

   • In For how many months...................:, enter 10.

   • Press Enter.

   The following result should be displayed:

   Resulting monthly payment.............:   $1023.06

   This completes the BANKDEMO application setup in Enterprise Developer.

1. In Server Explorer, choose Default, then choose Refresh from the context menu.

2. Choose BANKDEMO.

3. From the context menu, choose Stop.

   The Console view should display the log for the server stopping.

   If the message Server: BANKDEMO stopped successfully is displayed, the server has successfully shut down.

Analysis rules defined in Rocket Enterprise Analyzer can be exported from Enterprise Analyzer and imported into Enterprise Developer to run same analysis rules across the sources in the Enterprise Developer project.

1. Open Window/Preferences/Micro Focus/COBOL/Code Analysis/Rules.

2. Choose Edit... and enter the folder name D:\PhotonUser\My Files\Home Folder\AnalysisRules containing the rules file Loan+Calculation+Update.General-1.xml.

3. Choose Finish.

4. Choose Apply, then choose Close.

5. From the BANKDEMO project context menu, choose Code Analysis.

   You should see an entry for Loan Calculation Update.

With the new analysis rule we want to identify the COBOL programs and lines of code in there that are matching the search patterns *PAYMENT*, *LOAN* and *RATE* in expressions, statements and variables. This will help to navigate through the code and identify required code changes.

1. From the BANKDEMO project context menu, choose Code Analysis/Loan Calculation Update.

   This will run the search rule and list the results in a new tab called Code Analysis. The analysis run is completed when the green progress bar at the bottom right disappears.

   The Code Analysis tab should display an expanded list of BBANK20P.CBL, BBANK70P.CBL and SBANK70P.CBL, each listing the statements, expressions and variables matching the search patterns.

   Looking at the result for BBANK20P.CBL there are only literals moved that have a match with search pattern. So this program can be ignored.

2. In the tab menu bar choose - Icon to collapse all.

3. Expand SBANK70P.CBL and select any lines in any order with a double-click to see how this will open the source and highlight the line selected in source code. You will also recognize that all identified source lines are marked.

First we will change the BMS map MBANK70.BMS and the screen handling program SBANK70P.CBL and copybook CBANKDAT.CPY to display the new field. To avoid unnecessary coding in this exercise, modified source modules are available in the D:\PhotonUser\My Files\Home Folder\BANKDEMO-exercise\Exercise01 folder. Normally a developer would use the Code Analysis results to navigate and modify the sources. If you have the time and and want to do the manual changes do so with the information provided in *Manual change in MBANK70.BMS and SBANK70P.CBL (Optional)*.

For quick changes, copy the following files:

1. ..\BANKDEMO-exercise\Exercis01\screens\MBANK70.BMS to D:\PhotonUser\workspace\bankdemo\source\screens.

2. .\BANKDEMO-exercise\Exercis01\cobol\SBANK70P.CBL to D:\PhotonUser\workspace\bankdemo\source\cobol.

3. ..\BANKDEMO-exercise\Exercis01\copybook\CBANKDAT.CPY to D:\PhotonUser\workspace\bankdemo\source\copybook.

4. To ensure that all programs impacted by the changes are compiled, choose Project/Clean.../Clean all project.

For manual changes to MBANK70.BMS and SBANK70P.CBL, complete the following steps:

• For manual change in BMS MBANK70.BMS source add after the PAYMENT field:

  • TXT09 with same attributes as TXT08 and INITIAL value “Total Loan Amount”

  • TOTAL with same attributes as PAYMENT

Test changes

To test the changes, repeat the steps in the following sections:

1. Start the BANKDEMO server from Enterprise Developer

2. Start the Rumba 3270 terminal

3. Run a BankDemo transaction

   In addition you should now also see the text Total Loan Amount.....................:.

4. Stop the BANKDEMO server from Enterprise Developer

In the second step we will change BBANK70P.CBL and add the calculation for the total loan amount. The prepared source with required changes is available in D:\PhotonUser\My Files\Home Folder\BANKDEMO-exercise\Exercise01 folder. If you have the time and want to do the manual changes do so with the information provided in *Manual change in BBANK70P.CBL (Optional)*.

For quick change, copy the following file:

• ..\BANKDEMO-exercise\Exercis01\source\cobol\BBANK70P.CBL to D:\PhotonUser\workspace\bankdemo\source\cobol.

To make a manual change to BBANK70P.CBL, complete the following steps:

• Use the Code Analysis result to identify the required changes.

Test changes

To test the changes, repeat the steps in the following sections:

1. Start the BANKDEMO server from Enterprise Developer

2. Start the Rumba 3270 terminal

3. Run a BankDemo transaction

   In addition you should now also see the text Total Loan Amount.....................: $10230.60.

4. Stop the BANKDEMO server from Enterprise Developer

Commit the changes to the central CodeCommit repository and trigger the CI/CD pipeline to build, test, and deploy the changes.

1. From BANKDEMO project, in the context menu, choose Team/Commit.

2. In the Git Staging tab, enter the following commit message: Added Total Amount Calculation.

3. Choose Commit and Push....

4. Open the CodePipeline console and check status of the pipeline execution.

   Note

   In case you face any problem with the Enterprise Developer or Teams function Commit or Push, use the Git Bash command line interface.

In the first step we extract the loan calculation routine into a COBOL Section. This step is required to extract the code into a stand-alone COBOL program in the next step.

1. Open BBANK70P.CBL in the COBOL Editor.

2. In the editor, choose from the context menu Code Analysis/Loan Calculation Update. This will only scan the current source for patterns defined in the analysis rule.

3. In the result in the Code Analysis tab, find the first arithmetic statement DIVIDE WS-LOAN-INTEREST BY 12.

4. Double click on the statement to navigate to source line in Editor. This is the first statement of the loan calculation routine.

5. Mark the following code block for loan calculation routine to be extracted to a section.

   DIVIDE WS-LOAN-INTEREST BY 12
                GIVING WS-LOAN-INTEREST ROUNDED.
              COMPUTE WS-LOAN-MONTHLY-PAYMENT ROUNDED =
                ((WS-LOAN-INTEREST * ((1 + WS-LOAN-INTEREST)
                    ** WS-LOAN-TERM)) /
                (((1 + WS-LOAN-INTEREST) * WS-LOAN-TERM) - 1 ))
                    * WS-LOAN-PRINCIPAL.
   EXER01     COMPUTE WS-LOAN-TOTAL-PAYMENT =
   EXER01             (WS-LOAN-MONTHLY-PAYMENT * WS-LOAN-TERM). 

6. From the context menu in the editor, choose Refactor/Extract to Section....

7. Enter New section name: LOAN-CALCULATION.

8. Choose OK.

   The marked code block has now been extracted to the new LOAN-CALCULATION section and the code block has been replaced with the PERFROM LOAN-CALCULATION statement.

Test changes

To test the changes repeat the steps described in the following sections.

1. Start the BANKDEMO server from Enterprise Developer

2. Start the Rumba 3270 terminal

3. Run a BankDemo transaction

   In addition you should now also see the text Total Loan Amount.....................: $10230.60.

4. Stop the BANKDEMO server from Enterprise Developer

   Note

   If you want to avoid the above steps to extract the code block to a section you can copy the modified source for Step 1 from ..\BANKDEMO-exercise\Exercis02\Step1\cobol\BBANK70P.CBL to D:\PhotonUser\workspace\bankdemo\source\cobol.

In Step 2 the code block in the LOAN-CALCULATION section will be extracted to a standalone program and the original code will be replaced with code to call the new subprogram.

1. Open BBANK70P.CBL in editor and find the new PERFORM LOAN-CALCULATION statement created in Step 1.

2. Place the cursor within the section name. It will be marked grey.

3. From the context menu, select Refactor->Extract Section/Paragraph to Program....

4. In Extract Section/Paragraph to Program, enter New file name: LOANCALC.CBL.

5. Choose OK.

   The new LOANCALC.CBL program will open in the editor.

6. Scroll down and review the code being extracted and generated for the call interface.

7. Select editor with BBANK70P.CBL and go to LOAN-CALCULATION SECTION. Review the code being generated to call the new sub-program LOANCALC.CBL.

   Note

   The CALL statement is using DFHEIBLK and DFHCOMMAREA to call LOANCALC with CICS control blocks. Because we want to call the new LOANCALC.CBL sub-program as non-CICS program, we have to remove DFHEIBLK and DFHCOMMAREA from the call either by commenting out or deleting.

Test changes

To test the changes repeat the steps described in the following sections.

1. Start the BANKDEMO server from Enterprise Developer

2. Start the Rumba 3270 terminal

3. Run a BankDemo transaction

   In addition you should now also see the text Total Loan Amount.....................: $10230.60.

4. Stop the BANKDEMO server from Enterprise Developer

   Note

   If you want to avoid the above steps to extract the code block to a section you can copy the modified source for Step 1 from ..\BANKDEMO-exercise\Exercis02\Step2\cobol\BBANK70P.CBL and LOANCALC.CBL to D:\PhotonUser\workspace\bankdemo\source\cobol.

Commit the changes to the central CodeCommit repository and trigger the CI/CD pipeline to build, test and deploy the changes.

1. From BANKDEMO project, in the context menu, choose Team/Commit.

2. In the Git Staging tab

   • Add in Unstaged Stages LOANCALC.CBL and LOANCALC.CBL.mfdirset.

   • Enter a commit message: Added Total Amount Calculation.

3. Choose Commit and Push....

4. Open the CodePipeline console and check status of the pipeline execution.

   Note

   In case you face any problem with the Enterprise Developer or Teams function Commit or Push, use the Git Bash command line interface.