Default language.

Generate

Generate allows users to submit a batch job to do, for example, a compile/link/bind of the selected components. Three generate actions are available:

  • Generate does the following:
    • Submits a batch job to perform, for example, a compile/link/bind of the selected component This option is enabled if the mainframe ISPW's Browse Component Type Detail screen's Generate Flag indicator is set to Y; it defaults to N. The Generate Flag indicator must be individually set for each component type (for example, COB and ASM).
    • If deploy is configured with the Selective Deploy functionality in the ISPW instance, users can select which environments to deploy t If deploy is configured in the ISPW instance without Selective Deploy, the parts are deployed to all environments.
  • Generate with Options, in addition to the above actions, allows the user to make the following modifications to the set that processes the generate:
    • Modify the set attributes, such as the description and change type.
    • Select the date and time to process the generate operation.
    • Specify parameters for the generate process (if the Generate Options dialog is set up in the ISPW instance and the selected task is at the TEST level). Refer to ISPW Technical Reference Guide on custom dialogs for more information.
    • Select processing options (such as whether to lock, unlock, or hold the set).
    • If deploy is configured in the ISPW instance, select deploy options (such as the date and time for the deploy implementation and activation).
  • Generate with Parms, in addition to the generate actions, does the following if the selected task is at the TEST level:
    • Launches the Generate Options dialog box where users can set parameters for the generate process. This option only appears if customization was completed in the ISPW instance. Refer to the ISPW Technical Reference section on custom dialogs for more information.

To generate

  1. If desired, to allow viewing of compile diagnostics, ensure that the compile will be processed using the Compuware Shared Services COBOL or PL/I Language Preprocessor and that Compuware Shared Services PTFs are current. The preprocessor step is explained in the Compuware Shared Services User/Reference Guide.

  2. Do one of the following:

    • In a view that supports tasks (with the exception of the ISPW Set view), right-click one or more tasks and select Generate.
    • In a view that displays tasks, select one or more tasks and click Generate.PNG.
    • In a view that displays tasks, select one or more tasks and, from the View menu, select Generate.
    • In the Project Explorer view, right-click one or more tasks in an ISPW project and select ISPW>Generate.

    Important

    These menu options are only available if the ISPW instance was configured to require a generate for the selected component type.

  3. If the Deploy Environments dialog box appears, select one of the following radio buttons to specify the deploy environments:
    • Do not deploy - No deployment takes place.
    • Deploy to all environments - The set is deployed to all environments listed in the Deploy Environment column.

    • Deploy to specific environments - The check boxes in the Deploy Environment column are enabled. Select the check boxes for the environments in which to deploy the set. To filter the list of environments, in the Find field, enter the first few characters of any column. The table refreshes to show only the environments that match the filter.

      Important

      This is only applicable if Selective Deploy was configured in the ISPW instance.

  4. Click OK.
  5. To see information about the progress and results of the generation, do one of the following:
    • Look at the Console view, which shows the generate messages.
    • If the generate action was initiated from a view that displays tasks, look at the Status column.
      • If the generate action completes with no errors, the Message column says OK.
      • If there were errors during generation, the Message column says Generate Failed.
  6. After the generation has completed and if there are any generate failures, refer to the Problems view to view compile diagnostics. Then do the following:
    1. Do either of the following in the Problems view to open the source in an editor and position the cursor at the line of code that caused an error:
    2. Double-click the error or right-click it and select Go to.

    3. Right-click a problem marker and select Go to Source Listing.

      If not already opened, the source opens in the default editor, positioned to the selected problem.

    4. Make any necessary changes to the program and click Save.PNG or, from the File menu, select Save.

    5. From a view that displays tasks, regenerate the program

      Important

      Users can also show compile diagnostics from a view that displays tasks, by selecting the task or tasks and either clicking showcompilediagnostics.jpgor right-clicking and selecting Show Compile Diagnostics.

  7. If desired, in a view that displays tasks, right-click the task that was generated and select View Generate Listing to view the compiled source listing that the IBM compiler generated.
  8. If desired, from the Console view following a generate failure, open the job output in an editor as follows:
    • To view the generate job output, click the job ID's hyperlink.
    • To view the output of a DD, click the link for the DD from the list of the JES job DD name hyperlinks.
  9. If desired, open the set within the Set view by clicking on the set ID's hyperlink, which will show the tasks that were processed, along with the set information such as the set log.

To generate with options

  1. If desired, to allow viewing of compile diagnostics, ensure that the compile will be processed using the Compuware Shared Services COBOL or PL/I Language Preprocessor and that Compuware Shared Services PTFs are current. The preprocessor step is explained in the Compuware Shared Services User/Reference Guide.

  2. Do one of the following:

    • In a view that supports tasks (with the exception of the ISPW Set view), right-click one or more tasks and select Advanced Operations>Generate with Options.
    • From the Project Explorer view, right-click one or more tasks in an ISPW project and select ISPW>Generate with Options.
      The Generate Set Options page of the Generate with Options wizard appears. 

    Important

    These menu options are only available if the ISPW instance was configured to require a generate for the selected component type.

  3. Revise the set attributes as necessary based on the field definitions.

    Important

    The Application and Release ID fields are read-only.

  4. Optionally, select the Schedule check box then click capture.jpg. Select the start date and time to process the generate action.

    Important

    The date and time specified uses the time zone of the ISPW CM server.

  5. Click Next. The Generate Options page of the Generate with Options wizard appears if only one task was selected, the selected task is at the TEST level, and the Generate Options dialog has been set up in the ISPW instance.

    Important

    Clicking Finish instead of Next on this or any wizard page bypasses the remaining wizard pages, processes the set, and, if configured, displays the Deploy Environments page for selecting the environments in which to deploy the set. See below for instructions on using the Deploy Environments page.

  6. Set parameters for the generate process.
  7. Click Next. The Set Processing Options page of the Generate with Options wizard appears.

  8. Select one of the following radio buttons:

    • Process the set (Lock) - Select to process tasks in the set.
    • Leave the set open for changes (Unlock) - Select to not process tasks in the set so that further changes can be made, such as adding tasks.
  9. Optionally, select the Hold the set until it is manually released check box to cause the set to be marked as Held (not to execute when locked) as an initial state.

  10. Click Finish or Next. The following occurs:

    • If the set is unlocked, the set is created and remains open for further changes.
    • If the set is locked and Selective Deploy was not set up in the ISPW instance, processing occurs.
    • If the set is locked and Selective Deploy was set up in the ISPW instance, the Deploy Environments page of the Generate with Options wizard appears. Select one of the following radio buttons to specify the deploy environments, then click Finish.
      • Do not deploy - No deployment takes place.
      • Deploy to all environments - The set is deployed to all environments listed in the Deploy Environment column.
      • Deploy to specific environments - The check boxes in the Deploy Environment column are enabled. Select the check boxes for the environments in which to deploy the set. To filter the list of environments, in the Find field, enter the first few characters of any column. The table refreshes to show only the environments that match the filter.
  11. To see information about the progress and results of the generation, do one of the following:
    • Look at the Console view, which shows the generate messages.
    • If the generate action was initiated from a view that displays tasks, look at the Status column.
      • If the generate action completes with no errors, the Message column says OK.
      • If there were errors during generation, the Message column says Generate Failed.
  12. After the generation has completed and if there are any generate failures, refer to the Problems view to view compile diagnostics. Then do the following:
    1. Do either of the following in the Problems view to open the source in an editor and position the cursor at the line of code that caused an error:
    2. Double-click the error or right-click it and select Go to.
    3. Right-click a problem marker and select Go to Source Listing.
      If not already opened, the source opens in the default editor, positioned to the selected problem.
    4. Make any necessary changes to the program and click Save.PNG or, from the File menu, select Save.

    5. From a view that displays tasks, regenerate the program.

      Important

      Users can also show compile diagnostics from a view that displays tasks, by selecting the task or tasks and either clicking showcompilediagnostics.jpgor right-clicking and selecting Show Compile Diagnostics.

  13. If desired, in a view that displays tasks, right-click the task that was generated and select View Generate Listing to view the compiled source listing that the IBM compiler generated.
  14. If desired, from the Console view following a generate failure, open the job output in an editor as follows:
    • To view the generate job output, click the job ID's hyperlink.
    • To view the output of a DD, click the link for the DD from the list of the JES job DD name hyperlinks.
  15. If desired, open the set within the Set view by clicking on the set ID's hyperlink, which will show the tasks that were processed, along with the set information such as the set log.

To generate with parms

  1. If desired, to allow viewing of compile diagnostics, ensure that the compile will be processed using the Compuware Shared Services COBOL or PL/I Language Preprocessor and that Compuware Shared Services PTFs are current. The preprocessor step is explained in the Compuware Shared Services User/Reference Guide.

  2. Do one of the following:

    • In a view that displays tasks (with the exception of the ISPW Set view), right-click one or more tasks and select Generate With Parms.
    • From the Project Explorer view, right-click one or more tasks in an ISPW project and select ISPW>Generate with Parms.

    The Generate Options dialog box appears. This dialog box is populated based on customized XML on the mainframe and allows generation based on customer-specific settings. This functionality is only available if the selected task is at the TEST level.

    Important

    These menu options are only available if the ISPW instance was configured to require a generate for the selected component type.

  3. Set parameters for the generate process.
  4. Click OK to perform the generate.
  5. If the Deploy Environments dialog box appears, select one of the following radio buttons to specify the deploy environments:
    • Do not deploy - No deployment takes place.
    • Deploy to all environments - The set is deployed to all environments listed in the Deploy Environment column.

    • Deploy to specific environments - The check boxes in the Deploy Environment column are enabled. Select the check boxes for the environments in which to deploy the set. To filter the list of environments, in the Find field, enter the first few characters of any column. The table refreshes to show only the environments that match the filter.

      Important

      This is only applicable if Selective Deploy was configured in the ISPW instance.

  6. Click OK.
  7. To see information about the progress and results of the generation, do one of the following:
    • Look at the Console view, which shows the generate messages.
    • If the generate action was initiated from a view that supports tasks, look at the Status column.
      • If the generate action completes with no errors, the Message column says OK.
      • If there were errors during generation, the Message column says Generate Failed.
  8. After the generation has completed and if there are any generate failures, refer to the Problems view to view compile diagnostics. Then do the following:

    1. Do either of the following in the Problems view to open the source in an editor and position the cursor at the line of code that caused an error:

      • Double-click the error or right-click it and select Go to.
      • Right-click a problem marker and select Go to Source Listing.

      If not already opened, the source opens in the default editor, positioned to the selected problem.

    2. Make any necessary changes to the program and click save.gif or, from the File menu, select Save.

    3. From a view that displays tasks, regenerate the program.

      Important

      Users can also show compile diagnostics from a view that displays tasks, by selecting the task or tasks and either clicking showcompilediagnostics.jpgor right-clicking and selecting Show Compile Diagnostics.

  9. If desired, in a view that displays tasks, right-click the task that was generated and select View Generate Listing to view the compiled source listing that the IBM compiler generated.

  10. If desired, from the Console view following a generate failure, open the job output in an editor as follows:

    • To view the generate job output, click the job ID's hyperlink.
    • To view the output of a DD, click the link for the DD from the list of the JES job DD name hyperlinks.
  11. If desired, open the set within the Set view by clicking on the set ID's hyperlink, which will show the tasks that were processed, along with the set information such as the set log.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*