Migrating from Z Open Debug v3 to v4

This page is for users migrating from IBM Z Open Debug version 3 to version 4.

What happens during migration

When you install Z Open Debug v4 either from a .vsix file or from the VS Code Marketplace, if Z Open Debug v3 was previously installed, a message pops up to confirm migration.

Click Migrate to start the migration process. During the migration, the following changes would happen:

The values that were specified in Settings are used to create a zOpenDebug connection profile in the Zowe team configuration file.
Any existing debug profiles are converted to a new format, and are now listed in the Z Open Debug Profiles view integrated in Zowe Explorer.
The extension for IBM Z Open Debug Profiles view (zopendebug-profileui-<version>.vsix) is uninstalled.

What to do after migration

After migration, complete the following steps:

Remove the attributes that are no longer used from the configuration files.
- In launch.json created for Starting an interactive debug session with IBM Z Open Debug, remove the following attributes if specified previously.
```
"secure": true,
"ignoreCertificateErrors": true,
"password": "${command:AskForPassword}",
```
- In attach.json created for Listing parked z/OS Debugger debug sessions on a z/OS host, remove the following attributes if specified previously.:
```
"secure": true,
"ignoreCertificateErrors": true,
"useConnectionDetailsFromSettings": true 
"password": "${command:AskForPassword}"
```
Add the following attributes to use the zOpenDebug connection profile created in the Zowe team configuration file.:
```
"connection": { 
    "type": "zowe", "name": "zOpenDebug"
},
```