Serverless Cobol for AWS - Quickstart

Configure the Blu Age Cobol plugin

Undertake the following actions in order to configure the plugin:

1. Open the “Manage” menu;
2. Select the “Settings” option;
3. Click on the Blu Age COBOL entry;
4. Fill the “compiler connection” text box with the connection url provided by the Blu Age support services;

   

Compile your Cobol project

In order to launch the compilation of the source code:

1. Open the cobol file (.CBL);
2. Press [ Ctrl + Shift + p ] to open the command menu;
3. Start typing “Blu Age COBOL compilation”, select it in the menu and press Enter.

This compilation will generate a jar file. This later will appear in the configured target sub-folder (a bin directory by default).

Create a new lambda function

This step is fully made on your AWS account.

1. Connect to AWS;
2. Go to the AWS Lambda service;
3. Click on the “Create function” button;
4. Give a name to your function;
5. Select “Java 8” as the Runtime to be used;
6. Pick “Create a new role with basic Lambda permissions” for the Execution role;
7. Click on the “Create function” button.

Setup lambda function

1. Go to the function editing page;
2. Click on the Layer zone to make the Layer management zone visible;
3. Press the button “Add a layer”;

   

4. Select the option “Provide a layer version ARN”;
5. In the Layer version ARN textbox, paste the layer version ARN you have been granted use permission;
6. Click on the “Add” button;
7. Click on the function name, to make the standard Configuration visible again;
8. Browse to the function code section and upload the jar file generated previously;
9. In the Handler textbox, replace the existing default value by com.netfective.blu age.GWLambdaRequestHandler::handleRequest;
10. Set the environment variables as shown in the image below The BA_RUN_UNIT_ENTRYPOINT environment variable permits to specify the run unit program entry point;

    

11. Scroll down the page to reach the Basic settings zone;
12. Set the memory consumption to at least 1GB and the Timeout to 30 seconds.

    

Now that all settings have been done, Scroll up the page and save all pending changes with the “Save” button.

Configure test events

1. From the test event drop down;
2. Select the menu entry “Configure test events”;

   

3. Set the event name to “empty” for example;
4. Set the content of the event to an empty JSON array;
5. Click on the “Create” button.

Launch test

1. Click on “Test” button;

   

2. Inspect the execution result, to make sure the function executed successfully. The log should contain the following lines (of course timestamps will be different).