Endevor Package Editor tutorial

This tutorial steps you through editing CA Endevor® packages and external SCL files in the CA Endevor® Package Editor.

Before you begin

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.

About this task

This tutorial guides you through the basics of using the Endevor Package Editor to open and edit .pck and .scl files.

Procedure

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 Developer for z/OS®.
  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. 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 window opens allowing you to edit the parameters for the command.
  6. Close the edit window.
  7. In the Endevor Package Editor, select the command again and click the Move Up or Move Down buttons from the Command Control.
    These buttons allow you to reorder existing commands.
  8. From the menu in the Command Control, select GENERATE and click Add.
    Note: The Add button becomes active only after a command is selected from the menu.
    A window opens prompting you for the parameters of the SCL command you selected.
  9. Provide all parameters and click OK to add an SCL command to the package.
    This new command is added to the list of commands in the Command Table.
  10. In the GENERATE window, click Browse.
    A window opens to allow you to select an Endevor element from the repository.
  11. 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 window 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.
  12. Open the 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:
    • After you add an option to a command, the option is removed from the list so that you do not accidentally add the same option multiple times.
    • 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 menu becomes active. Selecting the option, specify the value, and then click Add.

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

  1. In the Remote Systems view, expand MVS Files > My Data Sets.
  2. Expand a PDS with the data mapping **SCLLIB.
    This file 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 view, right-click the same member and select Open With > Endevor Package Editor.
    Because the member has an .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.