Starting the Assembler Debugger

Restriction: The MFASM debugger is unable to open a window for debugging on any enterprise server region started via ESCWA, as Microsoft has permanently disabled access to the user desktop from any application started in the background and owned by "SYSTEM".

The method required to start the Assembler Debugger varies depending on how the program or programs are invoked, and the components that make up your application.

Important: All methods require that you first compile your application for debugging. All methods except the Standalone Assembler Program method require that you configure an enterprise server to run the application before debugging the application.
Standalone Assembler Program
To debug a single Assembler program from the command line:
  1. From a 32-bit Enterprise Developer command prompt, change to the directory that contains your Assembler executable file.
  2. Enter the following:
    run filename.390
    where filename.390 is the name of your Assembler executable file.

The Assembler Debugger starts in a command window.

Assembler Program Started from JCL
To debug an assembler program that is invoked via JCL, do all of the following from the same 32-bit Enterprise Developer command prompt:
Alternatively, if you are using the command line, to debug an assembler program that is invoked via JCL, do all of the following from the same 32-bit Enterprise Developer command prompt:
  1. Set the following environment variable:
    es_server_console=y
    Note: Failure to set this environment variable before starting the enterprise server results in an RTS197 error when the Assembler application is executed.
  2. Start the enterprise server from within the IDE or from the same Enterprise Developer command prompt using the following command:
    casstart /rServerName
  3. In the IDE, submit the JCL that invokes the Assembler program.

The Assembler Debugger starts in a command window when the JCL executes the Assembler program.

CICS or IMS Assembler Application
To debug a CICS or IMS application comprising entirely assembler programs:
  1. From a 32-bit Enterprise Developer command prompt, set the following environment variable:
    es_server_console=y
    Note: Failure to set this environment variable before starting the enterprise server results in an RTS197 error when the Assembler application is executed.
  2. Start the server from within the IDE or from a 32-bit Enterprise Developer command prompt:
    casstart /rServerName
  3. From the same 32-bit Enterprise Developer command prompt, start a server execution process:
    start cassi /rServerName /a
  4. On the Visual Studio Just-In-Time Debugger prompt, select the current instance of Visual Studio; then click Yes.
  5. Run the application using a TN3270 terminal emulator.

    If you have installed Micro Focus Rumba+ Desktop as part of the Enterprise Developer installation, Micro Focus recommends that you use it to run the application.

    The Assembler Debugger starts in a command window.

COBOL and Assembler in a Non-CICS Application
To debug a non-CICS application comprising both COBOL and Assembler programs:
  1. In Enterprise Developer, associate your enterprise server with the project.
  2. From a 32-bit Enterprise Developer command prompt, set the following environment variable:
    es_server_console=y
    Note: Failure to set this environment variable before starting the enterprise server results in an RTS197 error when the Assembler application is executed.
  3. From the same 32-bit Enterprise Developer command prompt, start the server:
    casstart /rServerName
  4. From the IDE, start debugging the application.
  5. Run the application in a 3270 terminal emulator such as Rumba+ Desktop.

The COBOL programs are debugged in the IDE, and the Assembler programs are debugged in the Assembler Debugger, which appears in a separate window.

COBOL and Assembler in a CICS Application

When you have an application that consists of both COBOL and Assembler programs, the COBOL programs are debugged in Enterprise Developer, and the Assembler programs are debugged in the Assembler Debugger, which appears in a separate window.

To debug a CICS application comprised of both COBOL and Assembler programs:

  1. In the IDE, open the project that contains the application you want to debug.
  2. From a 32-bit Enterprise Developer command prompt, set the following environment variable:
    es_server_console=y
    Note: Failure to set this environment variable before starting the enterprise server results in an RTS197 error when the Assembler application is executed.
  3. From the same 32-bit Enterprise Developer command prompt, start the server:
    casstart /rServerName
  4. From the same 32-bit Enterprise Developer command prompt, start a server execution process:
    start cassi /rServerName /a
  5. On the Visual Studio Just-In-Time Debugger prompt, select the current instance of Visual Studio; then click Yes.
  6. Run the application in a 3270 terminal emulator such as Rumba+ Desktop.