Elements

Open an Element for Editing

You can edit an element after you open it.

To open an element, right-click the element you want to open in the Project view and select Open element.

The Progress Information dialog is briefly displayed, and the element is opened for editing in the workspace.

Alternatively, double-click an element in the Project view to open it in the editor.

Browse Element

Displays the element's current level in the editor with all the statements in the current level of an element.

List Element Listing

You can view the listing of a CA Endevor SCM element using the List listing action. This action is available in the Search Map View, the Element View, and the Project view.

To view an element listing, right-click the element whose processing output you want to view in the Search Map View, the Element View, or the Project view, and select List listing.

The Progress Information dialog is briefly displayed, and the element opens as a text file in the workspace.

Browse Element History

Displays the element's current level in the editor.

You can view the history of the element, which displays all statements in all levels of the element, from the base level through the current level, indicating the level at which each insertion and deletion occurred.

Browse Element Changes

Displays the current level of an element in an ISPF browse panel showing all insertions and deletions that differ from its immediate predecessor.

Browse Element Master

Displays the element Master Control File Information in an editor.

Browse Element Summary

Displays the summary of an element.

Edit an Element

Edited elements are saved in the entry stage. When an element is saved, the processor runs, if one is defined for that element type. You can view the generated output by viewing the listing.

To edit an element, follow these steps:

1. Open the element from the Project view.
   The contents of the element are shown in the workspace.

2. Edit the contents of the element.

   Note: Pressing Return adds new lines.

3. Click File, Save.
   Your changes to the element in your project are saved. The saved element is also updated in the CA Endevor SCM.

Create an Element

You can create an element in the Project View when a project node is selected or when one of the entry stage elements is selected.

To create an element

1. Right-click on the project node.

2. Click Create Element from the pop-up menu.
   The Create Element dialog opens.

3. Fill in the dialog and click OK.

• Element Name
  Specifies the Element Name
  To convert Element Names to upper case, select "Upper Case Element Name." This setting is stored.

• Type
  Specifies an element type. Select a type from the combo box. A default type description and corresponding processor group is displayed.

• Processor Group
  Specifies the processor group. Select a processor group from the combo box.

• Override CCID/COMMENT
  Allows you to update CCID and comments from the project.

• CCID
  Specifies the Change Control Identifier (CCID) associated with this request. Enter a 1- to 12-character value that conforms to CCID naming conventions. A System's definition can require that you specify a CCID for any element action against any element associated with that System. If a CCID is required at the System level and you do not enter a CCID, an Action Prompt panel opens where you can add the CCID.

• Comment
  Specifies the comments associated with this request.
  Limits: 1-50 characters that conform to the naming conventions. A system's definition can require you to specify a comment. If a comment is required an action prompt appears.

• Create element from file
  Creates an element with the content from a selected file.
  You can also create an element from a selected file without opening it for editing. This is useful for uploading files without the need to open them.

Move an Element

You can move an element from one CA Endevor SCM inventory location (Environment, Stage) to the next location on a map route. You can only move an element from one Environment to another if the element you are moving is in Stage 2 of the source Environment. Therefore, to move an element from Stage 1 of the Development Environment into Stage 1 of the QA Environment, you must move the element to Stage 2 in Development and then move it into Stage 1 in QA.

To Move an Element without the Action Options dialog enabled

1. Right-click on the element you want to move in the Projects View, Search View, or Element View.

2. Click Move from the pop-up menu.
   The Move action request is built and submitted to the server. A Progress Information message is displayed until the action completes processing.
   Messages display in the CA Endevor SCM Messages Log View indicating whether the action was successful.

To Move an Element with the Action Options dialog enabled

1. Right click on the element you want to move in the Projects View, Search View, or Element View.

2. Click Move from the pop-up menu.
   The Move Action Options dialog appears with your preferences pre-filled. Change options as necessary:
   General Options

3. Synchronize
   Specifies whether you want the Move action performed when the base level of the element at the source location is different from the current level of the element at the target.
   When selected, CA Endevor SCM creates a sync level at the target that reflects the differences between the base level at the source location and the current level at the target, and then moves the sync level. You must select this option when moving an element that has remained at a source location after being moved using Delete from Element.
   If not selected, CA Endevor SCM does not move the element, if the base level at the source location and the current level at the target are different.

   Important! You must select this option when moving to a location where the out-of-sync condition exists. If the element does not exist at the target of the move, the Synchronize option searches up the map for the element and fetches (copies back) the element to the target and creates a sync level at the target.

   Caution! If you do not select this option, you are in danger of creating a future sync condition. If updates occur to the copy created up the map for any subsequent moves of this element, you must select the Synchronize option from this dialog.

   Signout/Signin

4. Retain Signout
   Specifies whether CA Endevor SCM retains the signout associated with an element at the source location when it is moved to the target location. When selected, CA Endevor SCM retains the source location signout at the target location.

   Note: If you select this option, the Signout To field is unavailable.

5. Signout To
   This option lets you sign the element out to another user at the target location. Specify the TSO user ID of the user to whom you want to sign out the element at the target location.

CCID/Comment

1. Override Project CCID/Comment
   Enables you to override the CCID and Comment associated with this element. You must select this option if you want to enter a custom CCID and Comment in the following fields.

2. CCID
   Specify a different CCID.

3. Comment
   Specify a different comment.

4. Click OK.
   The Move action request is built and submitted to the server. A Progress Information message is displayed until the action completes processing.
   Messages display in the CA Endevor SCM Messages Log View indicating whether the action was successful.

Generate an Element

You can request a Generate action to execute a Generate Processor. Generate Processors execute automatically when an element is added to the specified Environment entry Stage for a Create or Edit action. Typically, the Generate Processor creates an executable form of the element, together with any associated outputs (such as listings).

The processing options "Generate Element in Current location" and "Generate Element in Project location" determine what element source is used to generate elements. These options are mutually exclusive. In dependence on setting of "Generate Element in Project location" option you can also use additional NOSOURCE or COPYBACK options to decide whether the element will be copied back to the entry stage of the specified Project Environment or not.

To Generate an Element with the Action Options dialog disabled

1. Right-click on the element you want to generate in the Projects View, Element View, or Search Map View.

2. Click Generate from the pop-up menu.
   After completing the generate action, messages and outputs display in the <productnam> Log View.

To Generate an Element with the Action Options dialog enabled

1. Right-click on the element you want to generate in the Projects View, Search Map View, or Element View.

2. Click Generate from the pop-up menu.
   The Action Options dialog appears with your preferences pre-filled. Change the options as necessary:

Generate Element in Current location

Select to GENERATE element at its current Stage, element remains in its original state, no COPYBACK not even NOSOURCE option will be in use.

• Generate Element in Project location
  Select to GENERATE element at entry Stage of currently selected Project, either NOSOURCE or COPYBACK option has to be in effect:

  • NOSOURCE
    Select to GENERATE element at entry Stage of currently selected Project, element source is not copied back if element does not exist at target

  • COPYBACK
    Select to GENERATE element at entry Stage of currently selected Project, the first sourced element from up the map will be copied back if necessary

Override Processor Group

• Override Processor Group
  Enables you to override the Processor Group associated with this element, you must select this option if you want to enter a different Processor Group name from the following drop box list.

• Processor Group
  Choose a different Processor Group.

CCID/Comment

• Override Project CCID/Comment
  Enables you to override the CCID and Comment associated with this element. You must select this option if you want to enter a custom CCID and Comment in the following fields.

• CCID
  Specify a different CCID.

• Comment
  Specify a different comment.