Managing debug profiles with the Z Open Debug Profiles view

You can use this view to create, edit, activate, inactivate, and delete debug profiles for COBOL and PL/I applications. Profiles can be created for CICS® and non-CISC (batch, IMS, Db2®) applications.

Open the Z Open Debug Profiles view by selecting View > Command Palette > Debug: Z Open Debug Profiles.

If your Debug Profile Service has been configured to use a self-signed certificate, add the self-signed certificate in the Google Chrome browser.

What is displayed in this view

In the view, the following columns are displayed for profiles by default:
Profile Name
Displays the name of the profile.
Location
Displays the location of the profile.
  • For CICS profiles, the CICS region defined in the profile is displayed.
  • For non-CICS profiles, the sequential data set where the DTSP information is stored is displayed.
Connection
Displays the z/OS® connection defined in the VS Code Settings.
Activate
Displays the current state of the profile. You can toggle the profile between Active and Inactive.
Note: Only one CICS profile per user can be active in a CICS region. Only one non-CICS profile can be active on a z/OS system per user.
Edit
Open the profile in the Debug Profile Editor for editing.

You can click any column header to sort the list of profiles based on the contents of that column in default, ascending, or descending order.

Creating a CICS profile

To create a new CICS profile, complete the following steps:
  1. In the view toolbar, click Create Profile > CICS. The Debug Profile Editor opens.
  2. In the Debug Profile Editor, specify the required values and save the profile. The profile is then added to the Z Open Debug Profiles view.
For more information, see Creating a debug profile for a CICS application with Z Open Debug.

Creating a non-CICS profile

To create a new non-CICS profile, complete the following steps:
  1. In the view toolbar, click Create Profile > Batch, IMS, Db2. The Debug Profile Editor opens.
  2. In the Debug Profile Editor, specify the required values and save the profile. The profile is then added to the Z Open Debug Profiles view.
For more information, see Creating a debug profile for a non-CICS application with Z Open Debug.

Modifying a profile

To modify an existing profile, complete the following steps:
  • Click the edit icon in the Edit column for the profile. The Debug Profile Editor opens.
  • In the Debug Profile Editor, modify the values and click Update at the bottom of the editor to save the profile.

Activating a profile for debug

A profile must be activated to trigger z/OS Debugger in debug mode when the resources defined in the profile appear.
Note: Only one CICS profile per user can be active in a CICS region. Only one non-CICS profile can be active on a z/OS system per user.

To activate z/OS Debugger in debug mode for a profile, click the slider control in the Activate column.

Inactivating a profile

To prevent z/OS Debugger from being triggered when your application or transaction is started, inactivate the profile by clicking the slider control in the Activate column.
Note: Profiles are not automatically inactivated when you shut down the client or disconnect from the host.

Deleting a profile

To delete a profile, complete the following steps:
  1. Select the profiles that you want to delete.
  2. In the view toolbar, click Delete.
  3. On the confirmation dialog, select Delete.
The profiles are now removed. If the profile is active when you delete it, it is also deleted on the host.