Project View

Project View lists Endevor elements at the entry stage for the selected project and also corresponding local elements that reside in the Eclipse project. This view is a hierarchical display in which you can drill down through  systems, subsystems, environment, and stages to elements with local elements in local branch. Endevor elements and their Endevor types are combined into a single file name in the format element.type.

eehs18007

Project View lists Endevor elements at the entry stage for the selected project and also corresponding local elements that reside in the Eclipse project. This view is a hierarchical display in which you can drill down through Endevor systems, subsystems, environment, and stages to elements with local elements in local branch. Endevor elements and their Endevor types are combined into a single file name in the format element.type.

The Project View consists of Project Nodes that represent specific projects. Each Project Node then consists of an Endevor branch that contains Endevor elements, and local branch that contains local elements.

The Project View has extended functionality that involves a contextual Endevor Package. This package is set for the entire project. Once it is assigned to the Build Package Actions in the contextual menu, the package is enabled. You can build or update the SCL for a selected Endevor action. When the SCL is updated, the contextual package can be updated.

When you select a project in the Project, Search Map, Elements, or Properties Views, these views populate the data relevant to the selected project.

Note:
  • Selecting a view only opens the views if the Search Map, Elements, or Properties views are already open in the main window.
  • The Refresh button only refreshes selected projects. You do not need to refresh the project repository before this action, as it is done automatically where the repository was not already refreshed.

  • You can create an element in the Project View when a Project Node is selected.

Create an Element

In Endevor, source code and related code objects are known as Elements. An Element is a partitioned data set member, a Panvalet, Librarian, sequential data set, or USS file that has been placed under the control of Endevor. An Element is the smallest object for which the product provides control.

Follow these steps:

  1. Right-click on a Project Node.
  2. Select Create/Add Element from the pop-up menu.

    The Create/Add Element wizard opens.

    Note:

    Do not use the Add To Endevor Action under Team to add the created element into Endevor. Instead, to add the created element, add the file without editing option enabled, or follow the edit process to initiate the Add to Endevor Action.

  3. Fill in the Source element information:
    Element Source
    • Select the source of the element that you want to create from the following options:
      • Empty Element
        • Creates an Element without content
      • DSN
        • Specifies the data set name (DSN) and/or Member name and creates an Element using the content from a selected member
      • Local File
        • Specifies the path to the local file or use Browse button to select the path to the local file. This source option creates an Element using the content from a selected local file.
      • USS
        • Specifies the Path and File name and creates an Element using the content from a specified USS file.
    Open for Editing
    • Indicates whether you can open an element for editing after it is created or added. Values: Y/N
  4. Click Next
  5. Complete the Endevor Element Information:
    Element Name
    • Specifies the Element Name. To convert Element Names to uppercase, select Upper Case Element Name. This setting is stored.
    Type
    • Specifies an element type. Select a Type from the drop-down box. A default Type description and corresponding processor group are displayed.
    Processor Group
    • Specifies the processor group. Select a Processor Group from the drop-down box.
    Add Element to Endevor
    • Indicates whether the created element should be added into Endevor. If not selected, only a local Element is created. Values: Y/N
    Generate After Add
    • Indicates whether the element should be generated after the Add action. Values: Y/N
    Override Signout
    • Indicates whether to override the current sign out of the Element you are adding. Values: Y/N
    Override CCID/COMMENT.
    • Allows you to update the Change Control Identifier (CCID) and comments from the project.
    CCID
    • Specifies the CCID associated with this request.
      System definition can require that you specify a CCID for any element action against any element that is 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
    • Enter a one to twelve character value that conforms to CCID naming conventions
    Comment
    • Specifies the comments that are associated with this request.
      System definition can require you to specify a comment. If a comment is required an action prompt appears
    Note:

    Comments are limited to 1-50 character length, and must conform to the naming conventions

Truncate Lines to Source Length.
Truncates lines with number of characters exceeding the Source Length setting in the Endevor Type definition.
Select one of the following options:
Always -
Always remove/truncate exceeding characters
Only Spaces -
Remove only rightmost exceeding spaces
Never -
Never remove any characters from the source
Remember General Options Selections.
Retains current selections in Preferences under: Team>Endevor>Action Options>Add/Update
Always open Endevor Action Options dialogue.
Sets the Endevor Action Options page to be opened every time that you add or create an Element in Endevor
Note:

Clear this option if you want the values set in Preferences to be used without opening this page.

Project View Actions

Open Element.
Performs the Endevor retrieve operand without the signout action and opens the element for editing. The element is opened using the default editor for this element file extension as defined in Eclipse file associations. This action is only available in Project View.
Delete element.
Deletes an element from both the workspace and the Endevor project in the workspace. This action allows you to override CCID and comments that are provided in the project definition.
Move.
Moves an element across the Endevor defined life cycle map.
Note:

  • 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.
  • You can move an element from Stage 1 of the Development Environment into Stage 1 of the QA Environment. To do this, you must move the element to Stage 2 in Development and then move it into Stage 1 in QA.
Generate
Executes 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).
Sign In
Signs in an element that was signed out for an Edit 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.
List listing.
Queries the application for the output listing that is associated with the element in the specified environment and stage. The requested listing is displayed as a read-only listing in the workspace using the default editor.
Note:

You can view listings only for elements that create and store the output component in their processors. For details and requirements, see the Extended Processors section.

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.
Show 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. This indicates the level at which each insertion and deletion occurred.
Note: This option is not valid for sourceless elements or elements that are stored in image delta or log delta formats.
Summary of Element Levels
Displays an overview of the element levels
Browse Element Master
Displays the element Master Control File Information in an editor
Browse Component
Displays the component list for element's current level in Editor
Show Components History
Display the component list for element's current level in an ISPF browse panel, which shows all the inserts and deletions that have been made to the component information for the element's current level
Summary of Component Levels
Displays an overview of the component levels.

Build Package Action

Builds SCL Actions for selected elements in the project view. You must have assigned Endevor package to project (Contextual Package), this package is then set for the entire project.

When assigned, the build package actions are located in the contextual menu To Package. This menu includes the following Endevor actions:

Generate.
Builds SCL statement for Endevor generate action, with appropriate options, as selected on the generate action dialog. Built statement appends to or overwrites existing SCL file.
Delete.
Builds SCL statement for Endevor delete action, with appropriate options, as selected on the delete action dialog. Built statement appends to or overwrites existing SCL file.
Move.
Builds SCL statement for Endevor move action, with appropriate options, as selected on the move action dialog. Built statement appends to or overwrites existing SCL file.

Once the SCL is updated, use Update Remote Package SCL to reflect those changes in the core Endevor