Tutorial: Assembler Support

Provides step-by-step instructions that walk you through the process of building a sample Assembler application in Enterprise Developer, configuring an enterprise server region on which to run the application, and testing the application in TN3270 mode.

Assumptions

This tutorial is written from the perspective that all of the following is true. Specific instructions for setting your environment to adhere to these assumptions is found in the Before you begin this tutorial section that follows:

  • Windows File Explorer is set to show file names and extensions.
  • You are running the latest version of Micro Focus Enterprise Developer, which has been installed on your local machine using default installation settings, including the Rumba+ Desktop option.
  • Enterprise Developer is started on your local machine.
  • Your parent project directory is c:\tutorials\ASM. If you choose to use an alternative parent project directory, adjust the instructions accordingly.
  • You are using the Rumba+ Desktop TN3270 emulator when instructed to run the AACT transaction in TN3270 mode. If you choose to use an alternative emulator, adjust the instructions to accommodate your software.
  • You have addressed all of the items in the Before you begin this tutorial section below.

Before you begin this tutorial

Before beginning this tutorial, be sure you have addressed each of the following items:

Set Windows File Explorer options
These tutorials assume that your Windows File Explorer options are set to use the Details layout, and to show file name extensions. See your Windows documentation for more information.
Create a parent project directory
Create a directory in which to store the project files imported or created while completing this tutorial, which cites a parent project directory of c:\tutorials\ASM.
Start Visual Studio
If you need instructions to get Visual Studio started on your local machine, see To start Visual Studio.
Note: If Visual Studio prompts you on startup to select an initial action, click Continue without code.
Set Rumba+ TN3270 options
  1. In Visual Studio, click Tools > Options; then expand Micro Focus Tools and click TN3270 Display.
  2. In the right frame, ensure that Rumba (Embedded) is selected, and that Connect automatically is checked.
  3. Close the Options page.

Demonstration Application - AACT

The AACT demonstration application is the Assembler version of the standard example application that IBM supplies with CICS systems. Enterprise Developer provides the following Assembler executables, BMS, and copybook files:

asmacct0.mlc
The program associated with the ACCT transaction. It displays a menu screen for the on-line account file application, which prompts the user for input. Transaction AC01 is invoked when that input is received.
asmacct1.mlc
The program associated with the AC01 transaction. Analyzes all requests, and completes those for name inquiries and record displays. For update transactions, it sends the appropriate data entry screen and sets the next transaction identifier to AC02, which completes the update operation. For print requests, it starts transaction AC03 to do the actual printing.
asmacct2.mlc
The program associated with the AC02 transaction. It completes requests for account file updates (adds, modifies, and deletes), after the user entered the update information.
asmacct3.mlc
The program associated with the AC03 transaction. It completes a request for printing of a customer record, which was processed initially by transaction AC01.
asmacct4.mlc
The program associated with the AC04 transaction. It is a general purpose error routine that is invoked by other programs in the online account file application when an unrecoverable error has occurred. It sends a message to the input terminal describing the type of error and prompts the operator to report it. It then exits, backing out any updates made in the uncompleted transaction.
AACTSET.bms
The BMS mapset used by the AACT application.
ACCTREC.cpy
The record definition for the AACTFIL VSAM file used by the application.
AACTSET.cpy
Contains the record definitions for the BMS mapsets.

Sequence

To complete this tutorial, progress through these topics in the order presented here. The bottom of each topic provides Next topic and Previous topic navigational links to help you proceed in the proper sequence:

  1. Set Up the AACT Project
    Walks you through the steps required to create the AACT project in Visual Studio,, import the AACT demonstration files, install the resource definition file, and build the project.
  2. Set Up the ESAACT Enterprise Server Region
    Provides step-by-step instructions that guide you through the creation and configuration of the ESAACT enterprise server region on which to run the AACT application.
  3. Run the AACT Transaction
    Takes you through the steps necessary to start the ESAACT enterprise server region, access the AACT application running on the region using the Rumba+ Desktop emulator, initialize a VSAM file, and interact with the AACT application.
Parent topic: Mainframe Tutorials
Related concepts
Assembler Support
Related tasks
To start Visual Studio