Set Up the IMSSupport Project

Guides you through the steps required to create an Enterprise Developer project, import the MFDEMO IMS application files into the project, set the project properties, build the application, and perform additional required steps to enable the application to run in Enterprise Server.

Create the IMSSupport project

  1. In Visual Studio, click File > New > Project.
  2. In the New Project dialog box, expand Installed > COBOL.
  3. Click Enterprise Server, and then click Native.
  4. In the center pane, select Mainframe Subsystem Application.
  5. In the name field, type the name of the project: IMSSupport.
  6. Specify your working directory, c:\tutorials\IMS, in the Location field.
  7. Uncheck Create directory for solution.
  8. Click OK.

    In Enterprise Developer, this creates a solution named IMSSupport that contains one project, also named IMSSupport.

Add demonstration application files

  1. In the Solution Explorer, right-click the project and then use Add > New Folder to add each of these subfolders to the project:
    • cbl
    • dbd
    • mfs
    • psb
    • loadlib

    This adds the project subfolders to the Solution Explorer, and creates project subdirectories on disk.

    Use the following table to help you determine which demonstration files to add to which subfolder.

    Subfolder name Files to add Comments
    cbl DEMO001T.CBL

    RGHTJUST.CBL

     
    dbd DEMO03DD.DBD  
    loadlib TRANCODE.TXT

    DEMO03DD.DBU

    Contains data files and eventually the executables required at run time.
    mfs DEMO90.MFS

    DEMO91.MFS

    DEMO92.MFS

     
    psb DEMO001T.PSB  
    system None Eventually contains system files such as the resource definitions file, dfhdrdat
  2. In the Solution Explorer, right-click a subfolder of your project and select Add > Existing Item.
  3. Browse to the %PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\Mainframe\IMS\Classic\IVP directory.
  4. Optionally set the Objects of type filter to show only the type of files you want to add.
  5. Select the appropriate files; then click Add.
  6. Repeat steps 2 through 5 to add all appropriate demo files.

    This adds the files to the project and creates copies of the files in the respective subdirectories of your project.

Set project properties

  1. In the Solution Explorer, double-click your project's Properties folder.

    The Properties page lists a series of tabs on the left side.

  2. On the COBOL tab, set Configuration to Active (Debug).
  3. Set Platform target to Active (x86).
  4. Set COBOL dialect to Enterprise COBOL for z/OS.
  5. Set the Character set to ASCII.
  6. Set Source Format to Fixed.
  7. Check Compile for debugging.
  8. In the Output path field, type the path to the loadlib subfolder of your project. Because the current directory is the project directory, this can be expressed as .\loadlib.
  9. On the IMS tab, type .\loadlib into the Generated file path, MFS output path, and Database path fields.

    This directs the output for all generated IMS files into the loadlib project directory.

  10. In the DBD Build Settings section, check Generate Map for DBD.
  11. On the Debug tab, select IMS from the Launch drop-down list.
  12. Click File > Save All to save the changes in the project properties.

Build the project

  1. In the Solution Explorer, right-click the project; then select Build from the context menu.
  2. Check your project directory to see the different executables and other files produced by the build such as those in the project's loadlib directory. For example:
    • DBDGEN2.DAT
    • DBDGEN2F.DAT
    • PSBGEN3.DAT
    • DEMO001T.ACB
    • DEMO03DD.ACB
    • The MFS files generation creates some .mid, .mod, .dif and .dof files. These files contain system configuration data. You should move them only if you know how to configure your enterprise server.
    • Building the DBD and the PSB files produces respectively dbdgen2.dat, dbdgen2f.dat, psbgen3.dat as well as some .acb files.