Tutorial: Set up managed runtime for Micro Focus

Open the Amazon S3 console, and choose Create bucket.

In General configuration, choose the AWS Region where you want to build the AWS Mainframe Modernization Micro Focus Managed Runtime.

Enter a Bucket name, for example, yourname-aws-region-carddemo. Keep the default settings, and choose Create bucket. Alternatively, you can also copy settings from an existing Amazon S3 bucket and then choose Create bucket.

Choose the bucket that you just created, and then choose Upload.

In the Upload section, choose Add Folder, and then browse to the CardDemo directory from you local computer.

Choose Upload to start the upload process. Upload times vary based on your connection speeds.

When the upload completes, confirm that all files have been successfully uploaded, and then choose Close.

Open the Amazon RDS console.

Choose the AWS Region in which you want to create the database instance.

From the navigation pane, choose Databases.

Choose Create database, and then choose Standard create.

For Engine type, choose PostgreSQL.

Choose an Engine version of 15 or higher.

In Templates, choose Free tier.

Change the DB instance identifier to something meaningful, for example, MicroFocus-Tutorial.

Refrain from managing master credentials in AWS Secrets Manager. Instead, enter a master password and confirm it.

Under Connectivity, choose the VPC where you want to create the AWS Mainframe Modernization managed runtime environment.

Choose Create database.

In the Amazon RDS console navigation pane, choose Parameter groups, and then choose Create parameter group.

In the Create parameter group window, for Parameter group family, select the Postgres option that matches your database version.

Choose Create.

Choose the newly created parameter group.

Choose Actions, and then choose Edit.

Filter on max_prepared_transactions and change the parameter value to 100.

Choose Save Changes.

In the Amazon RDS console navigation pane, choose Databases, and then choose the database instance that you want to modify.

Choose Modify. The Modify DB instance page appears.

On the Modify DB instance page, navigate to Additional configuration, and change the DB parameter group to your parameter group. If your parameter group is not available in the list, check if it was created with the correct database version.

Choose Continue, and check the summary of modifications.

Choose Apply immediately to apply the changes instantly.

Choose Modify DB instance to save your changes.

Open the Key Management Service console.

Choose Create Key.

Leave the defaults of Symmetric for key type and Encrypt and decrypt for key usage.

Choose Next.

Give the key an Alias such as MicroFocus-Tutorial-RDS-Key and an optional description.

Choose Next.

Assign a key administrator by checking the box next to your user or role.

Choose Next .

Assign key usage permission by checking the box next to your user or role.

Choose Next.

On the review screen, edit the Key policy, then enter the following inside the existing "Statement" array:

{
     "Sid" : "Allow access for Mainframe Modernization Service",
     "Effect" : "Allow",
        "Principal" : {
           "Service" : "m2.amazonaws.com"
                 },
      "Action" : "kms:Decrypt",
      "Resource" : "*"
},

This policy grants AWS Mainframe Modernization decrypt permissions using this specific key policy.

Choose Finish to create the key.

Open the Secrets Manager console.

In the navigation pane, choose Secrets.

In Secrets, choose Store a new secret.

Set the Secret type to Credentials for Amazon RDS database.

Enter the Credentials that you specified when you created the database.

Under Encryption key, select the key that you created in step 3.

In the Database section, select the database that you created for this tutorial, and then choose Next.

Under Secret name, enter a name such as MicroFocus-Tutorial-RDS-Secret and an optional description.

In the Resource permissions section, choose Edit permissions, and replace the contents with the following policy:

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect" : "Allow",
            "Principal" : {
                "Service" : "m2.amazonaws.com"
            },
            "Action" : "secretsmanager:GetSecretValue",
            "Resource" : "*"
        }
    ]
}

Choose Save.

Choose Next for the subsequent screens, and then choose Store. Refresh the secrets list to see the new secret.

Choose the newly created secret and note the Secret ARN because you need it later in the tutorial.

In the Overview tab of the secret, choose Retrieve secret value.

Choose Edit, and then choose Add row.

Add a Key for sslMode with a Value of verify-full:

Choose Save.

Open the AWS Mainframe Modernization console.

In the navigation pane, choose Environments. Then choose Create environment.

Under Specify basic information,

1. Enter MicroFocus-Environment for the environment name.

2. Under engine options, make sure Micro Focus is selected.

3. Choose the latest Micro Focus Version.

4. Choose Next.

Configure the environment

1. Under Availability, choose High availability cluster.

2. Under Resources, choose either M2.c5.large or M2.m5.large for the instance type, and the number of instances that you want. Specify up to two instances.

3. Under Security and network, choose Allow applications deployed to this environment to be publicly accessible and choose at least two public subnets.

4. Choose Next.

On the Attach storage page, choose Next.

On the Schedule maintenance page, choose No preference and then choose Next.

On the Review and create page, review all the configurations that you provided for the runtime environment, and then choose Create environment.

In the navigation pane, choose Applications. Then choose Create application.

On the Create application page, under Specify basic information, enter MicroFocus-CardDemo for the application name and under Engine type make sure Micro Focus is selected. Then choose Next.

Under Specify resources and configurations, choose the option to specify the application definition with its resources and configurations using the inline editor.

Enter the following application definition in the editor:

{
  "template-version": "2.0",
  "source-locations": [
    {
      "source-id": "s3-source",
      "source-type": "s3",
      "properties": {
        "s3-bucket": "yourname-aws-region-carddemo",
        "s3-key-prefix": "CardDemo"
      }
    }
  ],
  "definition": {
    "listeners": [
      {
        "port": 6000,
        "type": "tn3270"
      }
    ],
    "dataset-location": {
      "db-locations": [
        {
          "name": "Database1",
          "secret-manager-arn": "arn:aws:secretsmanager:Region:123456789012:secret:MicroFocus-Tutorial-RDS-Secret-xxxxxx"
        }
      ]
    },
    "batch-settings": {
      "initiators": [
        {
          "classes": [
               "A",
               "B"
            ],
          "description": "initiator_AB...."
        },
        {
          "classes": [
                "C",
                "D"
             ],
          "description": "initiator_CD...."
        }
      ],
      "jcl-file-location": "${s3-source}/catalog/jcl"
    },
    "cics-settings": {
      "binary-file-location": "${s3-source}/loadlib",
      "csd-file-location": "${s3-source}/rdef",
      "system-initialization-table": "CARDSIT"
    },
    "xa-resources": [
      {
        "name": "XASQL",
        "secret-manager-arn": "arn:aws:secretsmanager:Region:123456789012:secret:MicroFocus-Tutorial-RDS-Secret-xxxxxx",
        "module": "${s3-source}/xa/ESPGSQLXA64.so"
      }
    ]
  }
} 

Edit the application JSON in the properties object of source-locations as follows:

1. Replace the value for s3_bucket with the name of the Amazon S3 bucket that you created in Step 1.

2. Replace the value for s3-key-prefix with the folder (key prefix) where you uploaded the CardDemo sample files. If you uploaded the CardDemo directory directly to an Amazon S3 bucket, then the s3-key-prefix doesn’t need to be changed.

3. Replace both secret-manager-arn values with the ARN for the database secret that you created in Step 4.

For more information on the application definition, see Micro Focus application definition.

Choose Next to continue.

On the Review and create page, review the information that you provided, and then choose Create application.

In the navigation pane, choose Applications, and then choose MicroFocus-CardDemo.

Under Deploy application, choose Deploy.

Choose the latest version of the application and the environment that you created previously, and then choose Deploy.

In the navigation pane, choose Applications, and then choose the application.

Choose the Data sets tab. Then choose Import.

Choose Import and Edit JSON configuration, and then choose the Copy and paste your own JSON option.

Copy and paste the following JSON but don't choose "Submit" yet. This JSON contains all the data sets required for the demo application but needs your Amazon S3 bucket details.

{
    "dataSets": [
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.ACCTDATA.VSAM.KSDS",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 11,
                            "offset": 0
                        }
                    }
                },
                "recordLength": {
                    "min": 300,
                    "max": 300
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo/catalog/data/AWS.M2.CARDDEMO.ACCTDATA.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.CARDDATA.VSAM.AIX.PATH",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 11,
                            "offset": 16
                        }
                    }
                },
                "recordLength": {
                    "min": 150,
                    "max": 150
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo/catalog/data/AWS.M2.CARDDEMO.CARDDATA.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.CARDDATA.VSAM.KSDS",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 16,
                            "offset": 0
                        }
                    }
                },
                "recordLength": {
                    "min": 150,
                    "max": 150
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo/catalog/data/AWS.M2.CARDDEMO.CARDDATA.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.CARDXREF.VSAM.KSDS",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 16,
                            "offset": 0
                        }
                    }
                },
                "recordLength": {
                    "min": 50,
                    "max": 50
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo/catalog/data/AWS.M2.CARDDEMO.CARDXREF.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.CUSTDATA.VSAM.KSDS",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 9,
                            "offset": 0
                        }
                    }
                },
                "recordLength": {
                    "min": 500,
                    "max": 500
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo/catalog/data/AWS.M2.CARDDEMO.CUSTDATA.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.CARDXREF.VSAM.AIX.PATH",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 11,
                            "offset": 25
                        }
                    }
                },
                "recordLength": {
                    "min": 50,
                    "max": 50
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo/catalog/data/AWS.M2.CARDDEMO.CARDXREF.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 16,
                            "offset": 0
                        }
                    }
                },
                "recordLength": {
                    "min": 350,
                    "max": 350
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo/catalog/data/AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT"
            }
        },
        {
            "dataSet": {
                "storageType": "Database",
                "datasetName": "AWS.M2.CARDDEMO.USRSEC.VSAM.KSDS",
                "relativePath": "DATA",
                "datasetOrg": {
                    "vsam": {
                        "format": "KS",
                        "encoding": "A",
                        "primaryKey": {
                            "length": 8,
                            "offset": 0
                        }
                    }
                },
                "recordLength": {
                    "min": 80,
                    "max": 80
                }
            },
            "externalLocation": {
                "s3Location": "s3://<s3-bucket-name>/CardDemo/catalog/data/AWS.M2.CARDDEMO.USRSEC.VSAM.KSDS.DAT"
            }
        }
    ]
}

Replace each occurrence of <s3-bucket-name> (there are eight) with the name of the Amazon S3 bucket that contains the CardDemo folder, for example, your-name-aws-region-carddemo.

Choose Submit.

When the import finishes, a banner appears with the following message: Import task with resource identifier name was completed successfully. A list of the imported datasets is shown.

In the navigation pane, choose Applications, and then choose the application.

Choose Start application.

Open the AWS Mainframe Modernization console and choose Applications, and then choose MicroFocus-CardDemo.

Choose the copy icon to copy the DNS Hostname. Also make sure to note the Ports number.

Start a terminal emulator. This tutorial uses Micro Focus Rumba+.

Choose Mainframe Display.

Choose Connection, and then choose Configure.

Under Installed Interfaces, choose TN3270, and then choose TN3270 again under the Connection menu.

Choose Insert, and paste the DNS Hostname for the Application. Specify 6000 for the Telnet Port.

Under Connection, choose Advanced, and then choose Send Keep Alive and Send NOP, and enter 180 for the Interval.

Choose Connect.

Enter USER0001 for the username and password for the password.

After you log in successfully, you can navigate through the CardDemo application.

Enter 01 for the Account View.

Enter 00000000010 for the Account Number and press Enter on your keyboard.

Press F3 to Exit to the menu, and F3 to exit the transaction.