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}"
- In launch.json created for Starting an interactive debug session with IBM Z Open Debug,
remove the following attributes if specified previously.
- Add the following attributes to use the zOpenDebug connection profile created in the Zowe team configuration file.:
"connection": { "type": "zowe", "name": "zOpenDebug" },