Getting started

The steps for using ASMPUT are:
  1. Create an ADATA file

    You must create an ADATA file on the host before you use ASMPUT, by supplying the ADATA option at assembly time.

    Do not use the XOBJECT or GOFF options, as ASMPUT cannot analyze the resultant output file.

    For more information about these options, see Chapter 3 Controlling Your Assembly With Options, of the HLASM Programmer's Guide.

  2. Download the ADATA file to your PC

    Download the file to your PC as a binary file, and give it the extension “XAA”.

  3. Start ASMPUT

    Start ASMPUT by the appropriate means (such as by double-clicking the ASMPUT icon or (in Windows) by selecting from the Start menu). ASMPUT starts with the global values in force when it was last closed, so the position and size of the Main window are the same as when ASMPUT was last closed, as are the sizes of the areas within this window, and the showing or hiding of the information notebook, the zoom slider, and return arcs.

  4. Open the ADATA file in ASMPUT

    The Open option of the File menu opens a dialog box for you to enter file details. After you complete opening the ADATA file, ASMPUT analyzes it. For more information, see Opening an ADATA file.

  5. Open the Control Flow Graph window

    ASMPUT displays the control flow graph for all currently opened modules. When you open a new ADATA file, ASMPUT integrates the modules found in that source code into the control flow graph.

    The Show Graph option of the View menu opens the Control Flow Graph window. For more information, see Opening and closing the control flow graph window.

  6. Peruse the control flow graph

    ASMPUT offers many ways to change the appearance of the control flow graph. For example, you can expand the number of layers, or you can remove the context.

    If you click on a node in the graph, the lines of source code corresponding to the node are highlighted in the source code listing.

    For more information, see Working with the control flow graph.

The prime purpose of ASMPUT is to show you a program's control flow in a graphical representation. However, ASMPUT also lets you view source code, and view information created by HLASM when the program was assembled.

There are more resources to help you with ASMPUT. For information about these resources, see Other resources.

  See also Introducing ASMPUT