VMS IDE Developing

From VSI OpenVMS Wiki
Revision as of 13:53, 29 March 2019 by Andrey.logachev (talk | contribs)
Jump to: navigation, search

Loading Existing Project

When you start working on a project that resides on OpenVMS machine, you need to download source files to your local machine. Use the Synchronizer tool as described below to download the source files.

  1. Change the downloadNewFiles option to "overwrite" or "edit"
  2. Run "VMS-IDE: Synchronize project files with VMS" command
  3. After all project files are downloaded, change the downloadNewFiles option to "skip" or "edit" to prevent silent overwriting of local files.

Managing Project Source Files

You can view and edit all project files from the Explorer view of Visual Studio Code. Please refer to Visual Studio Code https://code.visualstudio.com/docs/getstarted/userinterface documentation if you want to learn more about Explorer view.

The OpenVMS project structure may look like shown below:

VMS IDE Explorer

Managing the Project

You can manage your VMS project from the Project Explorer view. To open the view, click Project Explorer icon on the Activity Bar.

Managing Dependencies

If you work on a complex project and you need to add dependencies, use the PROJET DEPENDENCIES section.
Assuming that you want to add "Project B" to "Project A" dependencies,

  1. Select "Project A" in the Project Dependencies panel
  2. Right-click "Project B", and select "Add in dependencies to selected" item from the context menu.


To remove a project from dependencies

  1. Open the Project Dependencies section.
  2. Right-click the project, then select Remove from dependencies.

Building

Building MMS

In most cases,MMS file is generated automatically when running build command. If you need to create the MMS file separately, you can do this by pressing F1 and running VMS-IDE: Create MMS.

Building VMS Project

To build a project in VMS IDE:

  1. Open the Project Explorer view.
  2. Select the project you want to build in the Project Dependencies section.
  3. In the Project Description section, select the required build type (DEBUG or RELEASE) by clicking the buildType parameter.
  4. Right-click the project and select Build with dependencies from the context menu.

Before running build procedure VMS IDE checks that files are modified (sourceState parameter is set to modified) and there is no actual build on the server (buildState is not build). If conditions are met, VMS IDE uploads source files to the OpenVMS machine and runs build procedure. If you need to build the project, even if there are no changes, use Rebuild with dependencies.

Building with Custom Procedure

To build a project using a custom build procedure, edit the task.json file

{
  "type": "task2cmd",
  "command": "vmssoftware.synchronizer.buildProject",
  "extension": "vmssoftware.synchronizer",
  "parameter": "build.com",
  "label": "Build Procedure",
  "problemMatcher": []
}

where

  • parameter is the name of your build procedure (COM file)
  • label meaningful task name

All other parameters must be as shown in example.

NOTE: see Visual Studio Code documentation for more information on tasks.

Debugging

Use Debugger view to debug OpenVMS projects.

NOTE: Before running debugger, make sure that you have actual DEBUG builds on OpenVMS system.

To start debugging session, press F5. If there is no "launch.json" file in the project directory, you will be asked to select the environment. Select VMS Debugger from the popup list. The launch.json file will be created and filled with the required information. There are two types of launch configuration - DEBUG and RUN.

"configurations": [
        {
            "type": "vms_dbg",
            "request": "launch",
            "name": "Debug",
            "program": "",
            "arguments": "",
            "stopOnEntry": true,
            "typeRun": "DEBUG"
        }
]

For the program field, specify the relative path to the executable, for example [.project.bin.release]hello.exe. If the field is empty, VMS IDE will try to fill it with data from the project settings.

To choose which configuration will take action go to "Debug" (Ctrl-Shift-D) and select the appropriate configuration from the drop-down list. Press F5 again to run debugger.