Set Up the AACT Project

Walks you through the steps required to create the AACT project in Eclipse, import the AACT demonstration files, and install the resource definition file.
Restriction: This topic applies to Windows environments only.

Create the AACT project

  1. In Eclipse, expand the top-level Enterprise Developer entry in the Application Explorer view.
  2. Right-click Enterprise Development Projects in the Application Explorer view, and click New COBOL Project > Mainframe COBOL Project .

    This opens the New Mainframe COBOL Project dialog box.

  3. Specify the project name AACT and click Finish.

    Eclipse creates the project, and the Application Explorer view displays the AACT project.

  4. Right-click the AACT project in the Application Explorer view, and click New > Folder > Folder.

    This opens the New Folder dialog box.

  5. Specify loadlib as the folder name, and click Finish.

    This is the folder for the files generated by your project. You now need to configure the project to produce the generated files in the loadlib subfolder.

  6. Right-click the project in the Application Explorer view, and click Properties.
  7. Expand Micro Focus > Build Configurations and click Link.
  8. In the Output Path field, click Browse.

    This opens the Folder Selection dialog box.

  9. Select the loadlib folder; then click OK.
  10. Click Apply.
  11. Expand Micro Focus > Project Settings > Assembler Compile and click CICS Preprocessor.
  12. Enable Use CICS Preprocessor.
  13. Click Apply and Close.

Import the AACT demonstration files

In this step, you import the files from the AACT demonstration transaction into your project, and copy the resource definition file to the project.

  1. In Eclipse, select the AACT project in the Application Explorer view, and then select File > Import from the main menu.

    This opens the Import dialog box.

  2. Expand General, click File System, and click Next.
  3. Click the Browse button that corresponds to the From directory field.
  4. Navigate to %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\Mainframe\Assembler\Classic\AACT, and click Select Folder.

    This displays the list of the files available in the in the AACT directory.

  5. In the left pane, check AACT.
  6. In the right pane, scroll down and uncheck Readme.xml.
  7. Click Finish.

    This action adds the AACT application files to the project folder, creates the SYSTEM project subfolder (not visible from the Eclipse IDE), and adds the default dfhdrdat resource definition file to the SYSTEM subfolder. In addition, Eclipse automatically builds the project.

Install the dfhdrdat resource definition file

  1. Start an Enterprise Developer command prompt. If you need instructions, see To start an Enterprise Developer command prompt.
  2. Enter the following to upgrade the default dfhdrdat resource definition file to include CICS resources:
    caspcupg /dp=c:\users\username\eclipse-workspace\AACT\SYSTEM

    Where username is your Windows user ID.

Start the HACloud session

Ensure that the Micro Focus HACloud service property is set to start up automatically. For instructions on how to do this, see Starting the HACloud Session Server

To start the HACloud session server on Windows:
  1. Ensure that the installed Java is added to the PATH environment variable.
  2. Start the Enterprise Server region that runs the application you want to connect to.
  3. Start either the 32-bit or 64-bit Enterprise Developer command prompt or Enterprise Server command prompt - this must match the working mode, 32 or 64-bit, of the JRE you have installed.
  4. Type startsessionserver at the command prompt, and press Enter.

    Check the console for the messages that the Micro Focus HACloud Session Server has started.

To start the HACloud session server on UNIX:
  1. Ensure that the installed Java is added to the PATH environment variable.
  2. Start the Enterprise Server region that runs the application you want to connect to.
  3. Open a terminal and set up the COBOL environment in it.
  4. Run the following to start the session server:
    startsessionserver.sh

    Check the terminal for the messages that the Micro Focus HACloud Session Server has started.