Elements

Open an Element for Editing

You can edit an element after you open it.

To open an element, follow these steps:

  1. Right-click the local element you want to open in the Project view.

  2. Select Open Element.
    The Progress Information dialog is briefly appears and the element opens for editing in the workspace.

    Note: You can select multiple elements using Ctrl-click or Shift-click.

  3. (Alternatively) Double-click an element in the Project view to open n the editor.

    Note: In case there is a local element for the CA Endevor SCM element you are opening, the local element will open in the editor. If there is no local element, the source will first be retrieved from Endevor and saved in a local project as it becomes a local element. The local element opens in the editor.

Edit a Local Element

Edited elements are saved locally in an Eclipse project. Once the element is edited and its source is changed, this change is indicated in the Project view by the plus sign (+).

To edit an element, follow these steps:

  1. Open the element from the Project view.
    The content of the element is displayed in corresponding editor within the workspace.

  2. Edit the contents of the element.

    Note: Pressing Return adds new lines.

  3. Click File and then Save.
    Your changes to the element in your project are saved..

    Notes:

    • You can also use an element to update the CA Endevor SCM copy by following the steps in ADD an Element.

    • During the editing, each of lines that will exceed the Source length defined in the type will be marked either by the Warning sign (if exceeding characters are spaces) or Error sign otherwise.

    • If you have opened an older change level in the Summary View and you wish to add your changes to the current change level, please include the change into the file and then remove it. This action will trigger the file change indicator and the file can be saved/added into CA Endevor SCM. For some external editors there is the possibility to add the change level into CA Endevor SCM by navigating to File menu and selecting Save As.

    • Do not change the name of the file and click OK. The ADD is now initiated for the current change level.

Create/Add Element

This Action will allow users to create new elements and/or Add files from remote (Dataset or USS location) and local file system. It will also let users create a collection of multiple files/members, which can be then Added into CA Endevor® Software Change Manager as a single action emulating batch Add action.

To open Create/Add dialog follow these steps:

  1. Right-click on the project node to open the contextual menu.

  2. Click Create/Add Element action from the menu.

  3. Select option for the origin of Element Source which will be used as source of the newly created element

Note: Optionally, using the Endevor System Explorer View, user can select multiple files/members from Dataset/USS location. Then right clicking on selection and selecting the “Add to Endevor Project'' action from the contextual menu will open Create/Add dialog with rows prefilled with selected files/members.

The Create/Add - Source element information dialog consists of two sections.

  • Source Entry
    Source Entry allows you to select source for the file/member and includes following buttons:

    • Add Empty
      Defines new empty file with name EMPTY.

    • Browse Remote
      Navigate Dataset/USS location for a given initialized Repository in the opened Browse Directory dialog and select multiple Members/Files.

    • Browse Local
      Navigate the local file system in the opened File Dialog and select multiple files.

  • Files/Members to Create/Add
    Contains a table of files/members selected for the Add action, and various options for updating data in the table.

Use the Source Entry buttons to enter files/members into the table, then use a combination of selections and options to update the data in the table to reflect the intended options and behaviors for Add action.

Every row in the table has a checkbox. When selected, these denote that the following line will be affected by the selected option. Lines in the table can be also selected by double clicking. Clicking the “All” checkbox in the option selection section will select all the entries in the table

  • Type
    Select Endevor Type for selected files/members.

  • Processor Group
    Select Endevor processor group for given Endevor Type and selected files/members.

Use the Update button next to Type and Processor group to update selected files/members with the selected Type and/or Processor Group.

Element Name options

  • Uppercase
    Formats the Element name as upper case in selected files/members.

  • Truncate
    Truncates the Element name to 8 characters for selected files/members.

  • Retrieve to Local
    Invokes Retrieve into project location action right after file/member is added into CA Endevor®.

    Note: Retrieve to Local option is only applicable for members/files from Remote (dataset/uss) location.

    Use the Update button next to the Element name options and Retrieve to Local to update selected files/members with selected options.

  • Delete
    Deletes selected files/members in the table.

Table editing

Conduct change directly in the table on lines with enter files/members by clicking on the table cell under following columns:

  • Element name

  • Type: Select Type from the combo box.

  • Processor Group: Select the Processor Group from combo box.

  • Path/Dataset (only applicable for Remote files/members).

  • File/Member (only applicable for Remote files/members).

Note: Table has validation logic for existing Element names as well as validation for required information like Element Type. These issues/problems are denoted by error and warning icons in every single Table row and a specific message is displayed in the top section of the dialog windows as well as the tooltip displayed while hovering cursor on row with displayed icon. Once resolved the validation logic will update state accordingly.

Once all the entries in the table are validated, the Next > option is enabled and clicking the button directs you to the Endevor Element information page.

Endevor Element Information

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

  • 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.

    Note: Information in the Element section displays information depending on the number of elements processed. In the case of a single element all the relevant information is displayed, while when multiple elements are processed only the generic information is displayed.

  • Add Element to Endevor
    Select if you want to add newly created element to CA Endevor SCM. Deselect if you want it to stay only as a local element.

    Notes: A local instance of an element can be added to CA Endevor® Software Change Manager at a later time. Also this option only affects the empty elements and files from the local file system. The remote files/members (Datasets/USS location) are added into CA Endevor® Software Change Manager by default.

  • Generate after Add
    Select if you want the element to be generated after the Add action.

  • Override Signout
    Select if you want to override the current sign out of the element you are adding.

  • 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.

  • Truncate Lines to Source Length
    Allows you to truncate lines with number of characters exceeding the Source Length setting in the Endevor Type definition
    Select one of the options:

    • Always: always remove/truncate exceeding characters

    • Only Spaces: remove only rightmost exceeding spaces

    • Never: never remove any characters from source

  • Remember General Options selections
    Select to save this page selections' in Preferences under Team>CA Endevor SCM>Action Options>Add/Update

  • Always open CA Endevor SCM Action Options dialogue
    Select if you want this page to be opened every time you are adding (can be also when creating an element) an element to Endevor. Deselect if you want values from Preferences to be used without opening this page.

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.

Important! Your settings in the in the Action Options Preferences dialog determine if you see the Action Options dialog when generating an element. In the Preferences dialog, if you select the Always open CA Endevor SCM Action Option dialog check box, the Action Options dialog opens. This option allows you to change the settings. If you do not select this check-box, the CA Endevor SCM uses the defaults every time you perform an action. You can change the settings only with the Action Options dialog.

Remember Options and Signout/Signin selections

Select to save this page selections' in Preferences under Team>CA Endevor SCM>Action Options>Move

Always open CA Endevor SCM Action Options dialog

Select if you want this page to be opened every time you are moving an element. Deselect if you want values from Preferences to be used without opening this page.

To Move an Element without the Action Options dialog enabled

  1. Right-click on the CA Endevor SCM 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 CA Endevor SCM 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.

Important! Your settings in the in the Action Options Preferences dialog determine if you see the Action Options dialog when generating an element. In the Preferences dialog, if you select the Always open CA Endevor SCM Action Option dialog check box, the Action Options dialog opens. This option allows you to change the settings. If you do not select this check-box, the CA Endevor SCM uses the defaults every time you perform an action. You can change the settings only with the Action Options dialog.

Remember General Options selections

Select to save this page selections' in Preferences under Team>CA Endevor SCM>Action Options>Move

Always open CA Endevor SCM Action Options dialog

Select if you want this page to be opened every time you are generating an element. Deselect if you want values from Preferences to be used without opening this page.

To Generate an Element with the Action Options dialog disabled

  1. Right-click on the CA Endevor SCM 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 CA Endevor SCM 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:

Note: You can select either "Generate Element in Current location" or "Generate Element in Project location" option. Selecting one disables the other.

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.

Note: The drop box list contains all of the available Processor Groups defined for selected location.

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.

Canceling an Element

Eclipse queues element action requests when you select multiple elements. The application executes the requests one at a time. Press the Cancel button on the progress window to cancel a request before the application executes that request. You cannot cancel executed requests.

Example: You press Cancel on a delete action with 4 selected elements when the application is processing the deletion of the second element. The application cancels the pending delete requests for the third and fourth elements but completes the deletion of the second element.

An exception that permits cancellation of in progress retrieval actions (such as Browse, List, and other actions that only retrieve data from the mainframe).

Revert Element

Use this action the revert changes done to the local element (indicated by the plus sign), or to revert the local element to the version in CA Endevor SCM in case of the conflict status.

Sign In an Element

You can sign in an element that was signed out for an Edit action using the Signin action. This action removes the signout user ID associated with the element. Signin is only available for Systems for which Signin/Signout is in effect.

You can also use the Signin action to sign an element out to another user.

Important! Your settings in the Action Options Preferences dialog determine if you see the Action Options dialog when signing in an element. In the Preferences dialog, if you select the Always open CA Endevor SCM Action Option dialog check box, the Action Options dialog opens. This option allows you to change the settings. If you do not select this check-box, the CA Endevor SCM uses the defaults every time you perform an action. You can change the settings only with the Action Options dialog.

To signin an element without the Action Options dialog enabled, follow these steps:

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

  2. Click Signin from the pop-up menu.
    The messages and outputs display in the CA Endevor SCM Log View after completing the Signin action.

To signin an element with the Action Options dialog enabled, follow these steps:

  1. Right-click on the CA Endevor SCM element you want to Signin in the Projects View, Search Map View, or Element View.

  2. Click Signin from the pop-up menu.
    The Action Options dialog auto populates your preferences. Change the options as necessary:

View Elements

You can browse an element in read-only mode in the workspace, if the element is signed out to another user or if the element is not signed out. You cannot edit elements while you are browsing them.

Note: Use the Open element action to open elements for editing.

To browse an element, right-click the element you want to open in either the Project view, Search Map view, or Element view, and select View element.

Note: You can select multiple elements using Ctrl-click or Shift-click.

The Progress Information dialog is briefly displayed, and the element opens in read-only mode for browsing in the workspace, using the default editor for the element type.

Delete Element

Deletes an element from both the workspace and the CA Endevor SCM project in the workspace. It allows you to override CCID and Comments provided in the project definition.

Browse Element

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

Note: This option is not valid for sourceless elements.

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.

Note: This option is not valid for sourceless elements or elements stored in image delta or log delta formats.

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.

Note: This option is not valid for sourceless elements or elements stored in full-image delta or log delta formats.

Browse Element Master

Displays the element Master Control File Information in an editor.

Browse Element Summary

Displays the summary 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.

Note: You can select multiple elements using Ctrl-click or Shift-click.

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

Close an Element Listing

To close the element listing in the workspace, click Close (X) on the element tab.

Browse Component

Displays the component list for element's current level in Editor.

Browse Component History

Displays the component list for element's current level in an ISPF Browse panel, which shows all component information for all levels of the element, from the base level through the current level. The display shows the level at which each insertion or deletion occurred.

List Components

You can list components in the Element, Project, or Search Map Views.

Follow these steps:

  1. Select an element and select the List Components option.
    The Components view appears.

  2. Either select "Filter Input Components or "Filter Output Components"
    The filtered components appears and shows Member, Execution Step DDNAME and Dataset Name columns.
    The icon before the Member name shows whether it is an input or output component.

Add Changed Local Element to Endevor

When a local element is changed (a plus "+" sign precedes the name), you can add the element to CA Endevor SCM using the :Add element" action.

To add a local element from local eclipse project to CA Endevor SCM, follow these steps:

  1. Right-click on the local element node.

  2. Click Add Element from the pop-up menu.
    The Add Element Actions Options dialog opens.

  3. Fill in the appropriate information and click OK.

    • Element Name
      Specifies element name and will be already prefilled depending on the selected element. It is not possible to change this value for explicit Add action.

    • Type
      Specifies an element type and will be already prefilled depending on the selected element. It is not possible to change this value for explicit Add action.

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

    • Add Element to Endevor
      This checkbox will be already selected and disabled as it is mandatory for this specific action.

    • Generate after Add
      Select if you want the element to be generated after the Add action.

    • Override Signout
      Select if you want to override the current sign out of the element you are adding.

    • 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.

    • Truncate Lines to Source Length
      Allows you to truncate lines with number of characters exceeding the Source Length setting in the Endevor Type definition
      Select one of the options:

      Always: Always remove/truncate exceeding characters
      Only Spaces: Remove only rightmost exceeding spaces
      Never: Never remove any characters from source

    • Remember General Options selections
      Select to save this page selections' in Preferences under Team>CA Endevor SCM>Action Options>Add/Update

    • Always open CA Endevor SCM Action Options dialogue
      Select if you want this page to be opened every time you are adding (can be also when creating an element) an element to Endevor. Deselect if you want values from Preferences to be used without opening this page.

  4. (Optional) There will be two validations performed to see if the local element being added and the CA Endevor SCM element are in sync:

    1. The first validation will check if the local element being added is in sync with the CA Endevor SCM element. This is to prevent any potential regression.

      In case any conflict is detected, detailed information about the conflict will be displayed.

      There will be 3 merge options presented.

      Auto-merge: If this option is selected, the plugin will attempt an automatic merge. In case of a conflict, Eclipse Compare editor will open to perform a manual merge.

      Note: This option has 2 sub-options as detailed in the Auto-Merge options, but they are disabled in this case as only the "Only update Local Element" option is possible.

      Merge: Open Eclipse Compare editor to merge the local element with the CA Endevor SCM Element.

      Do not merge: No merge is performed and the Local Element will be added to Endevor as is.

    2. The second validation will check if the CA Endevor SCM element is in sync with the next occurrence on the map.

      In case conflict is detected, dialog will be displayed giving detailed information about the conflict.

      The following 3 options will be presented.

      Auto-merge: If selected, the plugin will attempt to perform an automatic merge. In case of a conflict, Eclipse Compare editor will be opened to perform a manual merge.

      There are 2 sub-options in section Auto-Merge options for this choice:

      1. Add updated Local Element to Endevor - In case there is no conflict and merge will be performed without user input, the Add action will be automatically triggered on the changed Local Element.

      2. Only update Local Element - In case there is no conflict and merge will be performed without users input, only the Local Element will be updated without it being added to Endevor.

      Merge: Open Eclipse Compare editor to merge the local element with the CA Endevor SCM Element.

      Do not merge: No merge will be performed and the Local Element will be added to Endevor as is.

    Note: Merging in this case will be performed AFTER the Add action.

    To continue with the Add action using selected option, click on Continue. To cancel the Add action, click on Cancel.

    If using any option that opens the Eclipse Compare editor, please follow the steps from CA Endevor SCM Plug-in for Eclipse Help > Elements > Compare and Merge Elements in project location, starting with step 3.

Retrieve to Local

Use this action to retrieve the Endevor element to the Eclipse project, creating a Local element. To retrieve an Endevor element to the Eclipse project, follow these steps:

  1. Right-click on the element you want to retrieve in the Projects View.

  2. Click Retrieve to Local from the pop-up menu.

    Note: The messages and outputs display in the CA Endevor SCM Log View after completing the Retrieve action.

Compare and Merge Elements

There are two scenarios in which the Compare and Merge Element action can be used. In both, the actual compare and merge is done in the Eclipse Compare editor.

Compare and Merge Local element

Compare and Merge the Local element with the Endevor element from the same CA Endevor SCM inventory location (Environment, Stage). In the Eclipse Compare editor, you can see the differences between the local and the Endevor element, but only edit and save the local element.

To compare and merge a local element with the Endevor element, follow these steps:

  1. Right-click the local element you want to compare and merge.

    Note: The Compare and Merge action is available only when the local element was edited or there was a synchronization conflict. These element statuses are marked with the appropriate signs and decorators next to the local element.

  2. Select Compare and Merge Elements.

  3. (Optional) In case of a conflict (Local Element is out-of-sync with the Endevor element), information will be displayed about the out-of-sync situation.

    There will be 3 options presented.

    Auto-merge: If selected, the plugin will attempt to perform an automatic merge. In case this is not possible due to a conflict, Eclipse Compare editor will be opened to perform a manual merge.

    Note: This option has 2 sub-options in section Auto-Merge options, but they are disabled in this case as only the "Only update Local Element" option is possible.

    Merge: Open Eclipse Compare editor to merge the Local element with the CA Endevor SCM Element.

    Do not merge: This option is disabled for explicit Compare and Merge Elements action.

  4. The Progress Information dialog is displayed and the compare editor is opened, displaying the source of the local element on the left and the source of the Endevor element on the right. Use this editor to merge the changes into the local element on the left.

    Note: You can select multiple elements using Ctrl-click or Shift-click.

  5. If you are satisfied with the merge, click the Mark as Merged button on the top right corner of the compare editor.

    Note: The Mark as Merged button will update the local element’s status, setting it to be synchronized with the Endevor element.

Compare and Merge Endevor Element in Project Location

Compare and Merge the out-of-sync Endevor element from the CA Endevor SCM inventory project location with the next occurrence on the lifecycle map. The Eclipse Compare editor, shows the differences between the Endevor element in project location, the next occurrence of Element on the lifecycle map, and their ancestor if there is any. You can only edit and add back to Endevor the Endevor element in project location.

To compare and merge the Endevor element in project location and the next occurrence of Element, follow these steps:

  1. Right-click the Endevor element from the CA Endevor SCM inventory project location you want to compare and merge.

    Note: The Compare and Merge action is available only when the Endevor element from the CA Endevor SCM inventory project location is out-of-sync with the next occurrence on the lifecycle map. These element statuses are marked with the appropriate signs and decorators next to the Endevor element.

  2. Select Compare and Merge Elements.

  3. The check is performed to find out if this element was already merged with the next occurrence on the lifecycle map it is out-of-sync with. In case it has already been merged and there exist a merge change level, pop-up message will be displayed informing the user about it.

    Note: The proper resolution of out-of-sync scenario can be done only in Endevor when the Endevor element from the CA Endevor SCM inventory project location is moved to the location of the next occurrence on the map. Therefore, once the Endevor element in project location is merged and added to Endevor, special change level will be created using CCID EP#MERGE and specifying details in the Comment. As a result, when you next try to merge in the Eclipse plugin will know that the merge was already done.

  4. Detailed information about the out-of-sync situation is displayed.

    There will be 3 options presented.

    Auto-merge: if this option is selected, plugin will attempt to perform an automatic merge. In case this is not possible due to a conflict, Eclipse Compare editor will be opened to perform a manual merge.

    There are 2 sub-options in section Auto-Merge options for this choice:

    1. Add updated Local Element to Endevor - If there is no conflict and merge will be performed without user input, the Add action will be automatically triggered on the changed Local Element.

    2. Only update Local Element - If there is no conflict and merge will be performed without users input, only Local Element will be updated without it being added to Endevor.

    Merge: Open Eclipse Compare editor to merge the local element with the CA Endevor SCM Element.

    Do not merge: This option is disabled for explicit Compare and Merge Elements action.

  5. The plugin will look for the ancestor of both the Endevor element from the CA Endevor SCM inventory project location, and the next occurrence on the map.

    There can be 3 possible outcomes:

    1. Ancestor is found and will be used.

    2. The proper ancestor does not exist and no other potential ancestor is found. In this case 2-way merge will be used (without ancestor).

    3. The proper ancestor does not exist, but other potential ancestors are found. In this case, a dialog containing list of possible ancestors is presented.

  6. Next, all the required sources need to be retrieved from Endevor. The progress of the retrieves is shown in the Progress Information dialog. Once all the sources are retrieved, the compare editor is opened displaying the source of the Endevor element from the CA Endevor SCM inventory project location on the left and the source of the next occurrence of the Endevor element on the map on the right. If you have set you want to show also ancestor in preferences (in Window > Preferences > General > Compare/Patch , Text Compare tap option Initially show Ancestor pane), source of the ancestor Element is shown above the both aforementioned Elements.

  7. If you are satisfied with the merge, click the Add to Endevor button on the top right corner of the compare editor.

  8. This will open an Add action dialog or immediately perform the Add action based on the setting in the preferences (in Window > Preferences > Team > CA Endevor SCM > Action Options , Add/Update tab, option Always open CA Endevor SCM Action Options dialog)

  9. Note: In case you will try to close the Eclipse Compare dialog without adding to Endevor first, you will be notified by a pop-up. Here, you will have a chance to perform the Add action or continue with the close basically cancel the merge.

Retrieve to z/OS

Use this action to retrieve the Endevor element to the PDS or USS location.
To retrieve an Endevor element to the PDS or USS location, follow these steps:

  1. Right-click on the element you want to retrieve in the Projects View.

  2. Click Retrieve to z/OS from the pop-up menu.
    The Action Options dialog appears. Change the options as necessary:

General Options

Override Signout
Select to RETRIEVE the element with OVERRIDE SIGNOUT option in request. This option updates the signout ID at the appropriate stage, with the user ID of the person performing the override.

Replace Member
Select to replace the member in the target location in case it already exists there.

No Signout
Select to RETRIEVE the element with NO SIGNOUT option in request. This option will not update the signout ID.

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.