Previous Topic: Delete a ProjectNext Topic: How Generate Element Works According to Generate Action Options Setting


Elements

This section contains the following topics:

Open an Element for Editing

Browse Element

List Element Listing

Browse Element History

Browse Element Changes

Browse Element Master

Browse Element Summary

Edit an Element

Create an Element

Move an Element

Generate an Element

Sign In an Element

Close an Element Listing

View Elements

Delete Element

Browse Element Master

Browse Component

Browse Component Changes

List Components

Browse Component History

Canceling Element Actions

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.

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

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.

More information:

Elements

Browse Element

List Element Listing

Browse Element History

Browse Element Changes

Browse Element Master

Browse Element Summary

Edit an Element

Create an Element

Move an Element

Generate an Element

Sign In an Element

Close an Element Listing

View Elements

Delete Element

Browse Element Master

Browse Component

Browse Component Changes

List Components

Browse Component History

Canceling Element Actions

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.

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.

More information:

Elements

Open an Element for Editing

Browse Element

Browse Element History

Browse Element Changes

Browse Element Master

Browse Element Summary

Edit an Element

Create an Element

Move an Element

Generate an Element

Sign In an Element

Close an Element Listing

View Elements

Delete Element

Browse Element Master

Browse Component

Browse Component Changes

List Components

Browse Component History

Canceling Element Actions

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.

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

  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.

Note: 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 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.

More information:

Elements

Open an Element for Editing

Browse Element

List Element Listing

Browse Element History

Browse Element Changes

Browse Element Master

Browse Element Summary

Create an Element

Move an Element

Generate an Element

Sign In an Element

Close an Element Listing

View Elements

Delete Element

Browse Element Master

Browse Component

Browse Component Changes

List Components

Browse Component History

Canceling Element Actions

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.

Note: Do not use the Add To Endevor Action under Team to add the Created element into CA Endevor SCM. To Add the created file keep the option Add file without editing enabled or follow the Edit an Element process to initiate the Add to CA Endevor SCM Action

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.

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 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 uses the defaults every time you perform an action. You can change the settings only with the Action Options dialog.

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

    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.

    Move With History

    Specifies whether you want to move the element with history.

    When selected, CA Endevor SCM moves the element with history.

    If not selected, CA Endevor SCM moves the element without history. This is the default. When you move the element without history CA Endevor SCM searches through the element levels at the source location to find a matching level at the target location. CA Endevor SCM then compares the two and creates a new level at the target location that reflects the differences.

    Delete FROM Element

    Specifies whether the element will be deleted at the source location after it is moved.

    When selected, CA Endevor SCM deletes the element at the source location after it is moved.

    If not selected, CA Endevor SCM does not delete the element at the source location.

    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.

    Acknowledge Element Jump

    Specifies whether the move can execute in a jump situation. A jump situation occurs when a copy of an element being moved is found at a non-mapped stage between the FROM and TO locations of the Move. In a jump situation, CA Endevor SCM Quick Edit examines the REQ ELM JUMP ACKNOWLEDGEMENT field in the System definition.

    When selected, CA Endevor SCM issues a message when an element is jumped during a move, informing you of this fact. If the System definition setting for REQ ELM JUMP ACKNOWLEDGEMENT is set to Y, then Acknowledge Elm Jump must also be set to Y for this move action to complete.

    If not selected, CA Endevor SCM does not issue a message when an element is jumped during a move. If the System definition setting for REQ ELM JUMP ACKNOWLEDGEMENT is set to Y, then the move is not completed.

    Signout/Signin

    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.

    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

    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.

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

See also

Set Action Options Preferences

More information:

Elements

Open an Element for Editing

Browse Element

List Element Listing

Browse Element History

Browse Element Changes

Browse Element Master

Browse Element Summary

Edit an Element

Create an Element

Generate an Element

Sign In an Element

Close an Element Listing

View Elements

Delete Element

Browse Element Master

Browse Component

Browse Component Changes

List Components

Browse Component History

Canceling Element Actions

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 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 uses the defaults every time you perform an action. You can change the settings only with the Action Options dialog.

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 CA Endevor SCM 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:

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.

See also:

How Generate Element Works According to Generate Action Options Setting

Set Action Options Preferences

More information:

Elements

Open an Element for Editing

Browse Element

List Element Listing

Browse Element History

Browse Element Changes

Browse Element Master

Browse Element Summary

Edit an Element

Create an Element

Move an Element

Sign In an Element

Close an Element Listing

View Elements

Delete Element

Browse Element Master

Browse Component

Browse Component Changes

List Components

Browse Component History

Canceling Element Actions