Rational Developer for System z

Starting a single-service project from the Remote Systems view

This topic describes how to start a single-service wizard from the Remote Systems view.
Note: Only the Create New Service Interface (bottom-up) wizard is available when you open the launchpad from this context.
This topic contains the following subtopics:

Starting the single-service wizard

To start a single-service wizard from the Remote Systems view:
  1. Open the Remote Systems view:
    1. On the main menu of the workbench, select Window > Show View > Remote Systems.
    2. The Remote Systems view opens.
  2. Use the Remote Systems view to create a connection to MVS™ on the remote z/OS® system (see Step B3(a). Create a connection to the remote z/OS system).
  3. Start the connection (see Step B3(b). Start the connection to the remote z/OS system).
  4. Expand MVS Files > My Data Sets.
  5. Right-click the partitioned data set that you want to use.
  6. Right-click a COBOL data set member file (the file extension must be .cbl, .cob, .ccp, or .cpy).
  7. Select Enable Enterprise Web Service. The Wizard Launchpad opens.
  8. In the Wizard Launchpad:
    1. Select the appropriate runtime environment, development scenario, application mode, and conversion type.
      Note: In this context some of the selections on the Wizard Launchpad and in the Create New Service Interface (bottom-up) wizard are different. See Differences in the Wizard Launchpad and wizard pages.
    2. Click Start.
  9. The single-service wizard opens.

Differences in the Wizard Launchpad and wizard pages

When you open the Wizard Launchpad in this context you encounter the following differences as you work through the wizard pages:

Limitations when you open the launchpad from the Remote Systems view

You should be aware of the following limitations when you open the Enterprise Service Tools Wizard Launchpad from the Remote Systems view:
  • The launchpad is available only if you right-click a remote COBOL member on MVS.
  • From the launchpad, only the Create New Service Interface (bottom-up) wizard is available.
  • On the launchpad, the Save generation properties option is not supported in this context.
  • The batch processor does not support this option.

Error detection and reporting

You should be aware of the following information about error detection and error reporting:
  • Syntax errors in the COBOL source file or its dependent copybooks are reported in the Remote Error List view.
  • If an error message in the Remote Error List indicates that a COPY item was not found, for example:
    IGYLI0049-S, The "COPY" library was not found.
    then two possible causes for this error are as follows (there are other possible causes):
    • The COBOL source file (extension .cbl, .cob, or .ccp) that you right-clicked before opening the launchpad has dependencies, but when the Create New Service Interface (bottom-up) wizard prompted, "Does your source file have any dependent files?", you selected No (see Differences in the Wizard Launchpad and wizard pages).
    • The COBOL copybook file source file (extension .cpy) that you right-clicked before opening the launchpad has dependencies. You cannot specify a COBOL copybook file unless it has no dependencies.
  • When the wizard is checking dependencies, the wizard can display in the Check Dependencies window one of the following error messages:
    • If the JES system is not connected, then the wizard displays the following error message:
      The submitted job as ended with a JCL Error. 
       Check the build properties and retry the operation.
    • If there is a JCL error (for example, you specified a PDS that does not exist in the SYSLIB), then the wizard displays the following message:
      The submitted job as ended with a JCL Error. 
       Check the build properties and retry the operation.

Feedback