Rational Developer for System z


Endevor Package Editor Tutorial

This tutorial steps you through editing CA Endevor packages and external SCL files in the CA Endevor Package Editor.
To successfully complete these steps, you must have access to the CARMA host with the CA Endevor Package RAM installed. Contact your system administrator if you are unsure of the setup of your system.
This tutorial guides you through using the basics of using the Endevor Package Editor to open and edit .pck and .scl files.

To open and edit CA Endevor package files in the Endevor Package Editor:

  1. Connect to the CA Endevor Packages RAM

    By connecting to the Endevor repository, you can access any stored packages through Rational® Developer for System z®.
  2. In the CARMA Repositories view, double click an existing package listed in the Package List. Since Endevor packages are marked with the file extension, .pck, the Endevor Package Editor is opened as the default editor.
    Note: If the existing package does not contain valid SCL commands, then the Endevor Package Editor does not open and an error message is displayed in its place.
  3. Take note the three parts of the Endevor Package Editor.
    • The Command Table is at the upper left of the Endevor Package Editor. It displays all the commands in the package.
    • The Command Control is at the upper right of the Endevor Package Editor. These controls can be used to add new commands to the package and perform actions, such as reordering and editing, on existing commands.
    • The Source Preview Pane is at the bottom of the Endevor Package Editor and can be used to preview the package command SCL.
  4. Package commands are listed in the Command Table. Select a command. The Source Preview Pane updates with the SCL source making up the command. The Edit button in the Command Control becomes active.
  5. Select the Edit button while the command is still selected in the Command Table. A dialog opens allowing you to edit the parameters for the command.
  6. Close the edit dialog.
  7. In the Endevor Package Editor, select the command again and press the Move Up or Move Down buttons from the Command Control. These buttons allow you to reorder existing commands.
  8. From the drop-down menu in the Command Control, select GENERATE and click Add.
    Note: The Add button becomes active only after a command is selected from the drop-down menu.
    A dialog opens prompting you for the parameters of the SCL command you selected. Provide all parameters and click OK to add a new SCL command to the package. This new command is added to the list of commands in the Command Table.
  9. In the GENERATE dialog, select the Browse button. A dialog opens to allow you to browse to select an Endevor element from the repository.
  10. Browse to an element you would like to add, select it, and click OK. The parameters are populated based on the Endevor element you selected.
    Note: If this connection is your first time connecting to the CA Endevor RAM in this workspace, a dialog opens and prompts you to define a filter for the Endevor elements to be displayed. Alternatively, you can click Finish to return all Endevor elements.
  11. Open the drop-down menu under Options, select an option from the menu, and click Add. The option is added to the table. You can add as many options as are applicable to the command. For now, click Cancel.
    Note: Already selected options no longer appear in the list to avoid accidentally selecting the same option multiple times.
    Note: Some options, such as CCID, require a value. When an option is selected that needs a value, the input field to the right of the drop-down menu becomes active. Clicking Add after selecting the option and specifying the value adds the option and value to the command and display it in the table.

To open and edit .scl files in the Endevor Package Editor:

  1. In the Remote Systems Explorer, expand MVS Files > My Data Sets.
  2. Expand a PDS with the data mapping: **SCLLIB. This is a PDS that contains .scl files.
  3. Double click one of the members in the PDS. The file opens in the LPEX editor rather than the Endevor Package Editor.
  4. In the Remote Systems Explorer view, right click the same member and select Open With > Endevor Package Editor. Since the member has a .scl extension, it can be edited in the Endevor Package Editor.
    Note: Files with the .scl extension can be edited in the same manner as packages.

Feedback