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:
- 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®.
- 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.
- 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.
- 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.
- 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.
- Close the edit dialog.
- 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.
- 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.
- In the GENERATE dialog, select the Browse button. A dialog opens to allow you to browse to select an Endevor
element from the repository.
- 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.
- 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:
- In the Remote Systems Explorer,
expand MVS Files > My Data Sets.
- Expand a PDS with the data mapping: **SCLLIB. This is a PDS that contains .scl files.
- Double click one of the members in the PDS. The file opens in the LPEX editor rather than the Endevor
Package Editor.
- 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.