Launching a debug session for z/OS batch applications with property groups

You can create a z/OS Batch Application using a property group launch configuration to generate JCL with appropriate options and submit JCL to run z/OS batch applications. This launch configuration does not support using a debug profile. Property groups and the launch configuration are not available in IBM® Debug for z/OS®.

About this task

Creating a z/OS Batch Application using a property group launch configuration

About this task

You can create a z/OS Batch Application using a property group launch configuration from the Debug perspective or from the Debug As context menu for items in the Remote Systems and z/OS Projects views.

Procedure

  1. From the main toolbar, click the down arrow to the right of the debug icon (Debug icon) and select Debug Configurations.
    The Debug Configurations wizard opens.
  2. In the wizard, from the list on the left, right-click z/OS Batch Application using a property group and select New.
    The z/OS Batch Application using a property group debug configuration wizard opens.
  3. In the Name field, enter a name for the new launch configuration.
  4. On the JCL Options tab, specify JCL generation options and optionally a non-CICS profile to activate as part of the launch.
  5. Complete the required fields and any other optional fields in the wizard.
    For more information about the fields, see the topics about the tabs.
  6. Click Apply.
    The new configuration is saved on the client. When you click Debug, the remote debug profile is activated. Then, JCL is generated and submitted to start your debug session.

Using the launch configuration in code coverage mode

About this task

You can create a z/OS Batch Application using a property group launch configuration from the Debug perspective or from the Code Coverage As context menu for items in the Remote Systems view and the z/OS® Projects view.

Procedure

  1. From the main toolbar, click the down arrow to the right of the Compiled Code Coverage icon (Compiled Code Coverage icon) and select Compiled Code Coverage Configurations.
    The Compiled Code Coverage Configurations wizard opens.
  2. On the Code Coverage tab, specify any code coverage options.
  3. Complete other fields in the wizard as necessary.
    For more information about the fields, see the topics about the tabs.
  4. Click the Coverage button. If a non-CICS profile is specified, the profile is activated. Then, JCL is generated and submitted to start your compiled code coverage session.

Using the launch configuration from the Remote Systems or z/OS Projects view

Procedure

  1. Right-click one of the following types of items:
    • Any COBOL, HLASM, PL/I, C/C++ source
    • Load Module
  2. From the menu, select Debug As > z/OS Batch Application using a property group to run debug or select Code Coverage As > z/OS Batch Application using a property group to run code coverage.
    Notes:
    • A property group must be associated with the item before you invoke the context menu action.

Using the launch configuration when you are editing

Procedure

  1. When you are editing COBOL, HLASM, PL/I, or C/C++ source that is associated with a property group, right-click the type of item.
  2. From the menu, select Debug As > z/OS Batch Application using a property group to run debug or select Code Coverage As > z/OS Batch Application using a property group to run code coverage.
    Notes:
    • These steps generate JCL to compile, link, and debug your program.
    • Save the contents of the editor before you debug. Otherwise, the changes are not visible in the debug session.

Viewing the batch job in Remote Systems View

About this task

After you launch a debug or code coverage session, JCL is generated and submitted automatically. In the Debug view, a debug target that represents the JES job is displayed with a label indicating the job status. You can use this JES job target to quickly access the job in the Remote Systems View.

Procedure

  1. In the Debug view, select the JES job target, which is the first child of the launch, and right-click to open the context menu.
  2. From the menu, select Show In Remote Systems.
    The Remote Systems view is opened and the job is selected under the Retrieved Jobs filter in the JES subsystem.