Difference between revisions of "VMS IDE Developing"
(Created page with "=Developing= ==Syncing Source Code== When you start working on a project that resides on an OpenVMS machine, you need to download source files to your local machine. For this...") |
|||
Line 1: | Line 1: | ||
+ | * Bulleted list item | ||
=Developing= | =Developing= | ||
Line 20: | Line 21: | ||
=Building= | =Building= | ||
+ | To build a project in VMS IDE: | ||
+ | # Open the Project Explorer view. | ||
+ | # Select the project you want to build in the Project Dependencies panel. | ||
+ | # In the Project Description panel, select the required build type (<code>DEBUG</code> or <code>RELEASE</code>) simply by clicking the '''buildType''' parameter. | ||
+ | # Right-click the project and select ''Build with dependencies'' from the context menu. | ||
+ | To build a project using a custom build procedure, edit the ''task.json'' file | ||
+ | <pre>{ | ||
+ | "type": "task2cmd", | ||
+ | "command": "vmssoftware.synchronizer.buildProject", | ||
+ | "extension": "vmssoftware.synchronizer", | ||
+ | "parameter": "time.com", | ||
+ | "label": "VMS: Time", | ||
+ | "problemMatcher": [] | ||
+ | }</pre> | ||
+ | where | ||
+ | * '''parameter''' is the name of your build procedure (COM file) | ||
+ | * '''label''' meaningful task name | ||
+ | All other parameters must be as shown in example. | ||
=Running= | =Running= | ||
=Debugging= | =Debugging= | ||
+ | To debug your application, press <code>F5</code>. If there is no "launch.json" file in the project directory, you will be asked to select 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 - '''DEBUG''' and '''RUN'''. | ||
+ | For the "program" field, specify the relative path to the executable (from home directory), for example "[.project.bin.release]hello.exe". | ||
+ | If the field is empty, VMS IDE will try to fill it with data from 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 <code>F5</code> again to run debugger. |
Revision as of 16:09, 28 March 2019
- Bulleted list item
Contents
Developing
Syncing Source Code
When you start working on a project that resides on an OpenVMS machine, you need to download source files to your local machine. For this,
- Change the
downloadNewFiles
option to "overwrite" or "edit" - Run "VMS-IDE: Synchronize project files with VMS" command
- 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.
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
Use the Project Dependencies panel to manage project dependencies.
Assuming that you want to add "Project B" to "Project A" dependencies,
- Select "Project A" in the Project Dependencies panel
- Right-click "Project B", and select "Add in dependencies to selected" item from the context menu.
Building
To build a project in VMS IDE:
- Open the Project Explorer view.
- Select the project you want to build in the Project Dependencies panel.
- In the Project Description panel, select the required build type (
DEBUG
orRELEASE
) simply by clicking the buildType parameter. - Right-click the project and select Build with dependencies from the context menu.
To build a project using a custom build procedure, edit the task.json file
{ "type": "task2cmd", "command": "vmssoftware.synchronizer.buildProject", "extension": "vmssoftware.synchronizer", "parameter": "time.com", "label": "VMS: Time", "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.
Running
Debugging
To debug your application, press F5
. If there is no "launch.json" file in the project directory, you will be asked to select 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 - DEBUG and RUN. For the "program" field, specify the relative path to the executable (from home directory), for example "[.project.bin.release]hello.exe". If the field is empty, VMS IDE will try to fill it with data from 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.