Project View
Project View lists CA 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. CA Endevor elements and their CA Endevor types are combined into a single file name in the format element.type.
Project View lists CA 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 CA Endevor systems, subsystems, environment, and stages to elements with local elements in local branch. CA Endevor elements and their CA 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 a CA Endevor branch that contains CA Endevor elements, and local branch that contains local elements.
The Project View has extended functionality that involves a contextual CA 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 CA 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.
- 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.
In CA Endevor, source code and related code objects are known as Elements. An Element is a partitioned data set member, a CA Panvalet, CA Librarian, sequential data set, or USS file that has been placed under the control of CA Endevor. An Element is the smallest object for which the product provides control.
Follow these steps:
- Right-click on a Project Node.
-
Select Create/Add Element from the pop-up menu.
The Create/Add Element wizard opens.Note:Do not use the Add To CA Endevor Action under Team to add the created element into CA Endevor. Instead, to add the created element, add the file without editing option enabled, or follow the edit process to initiate the Add to CA Endevor Action.
- 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.
- Empty Element
- Select the source of the element that you want to create from the following options:
- Open for Editing
- Indicates whether you can open an element for editing after it is created or added. Values: Y/N
- Element Source
- Click Next
- Complete the CA 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 CA Endevor
- Indicates whether the created element should be added into CA 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
- Specifies the CCID associated with this request.
-
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
- Specifies the comments that are associated with this request.
- Element Name
-
Truncate Lines to Source Length.
Truncates lines with number of characters exceeding the Source Length setting in the CA 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>CA Endevor>Action Options>Add/Update - Always open CA Endevor Action Options dialogue.
Sets the CA Endevor Action Options page to be opened every time that you add or create an Element in CA Endevor
Note:Clear this option if you want the values set in Preferences to be used without opening this page.
- Open Element. Performs the CA 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 CA 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 CA 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.
- 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. 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.
- 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 that are stored in full-image delta or log delta formats.
-
Browse Element Summary.Displays a summary of the Element.
Note: This option is not valid for sourceless elements or elements that are stored in full-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
- Browse component history Displays the component list for element's current level in an ISPF Browse panel. This panel shows all component information for all levels of the element, from the base level through the current level. The display also shows the level at which each insertion or deletion occurred
- Browse component changes 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
- Browse Component Summary Displays a summary of the components
- Summary of Component Levels Displays an overview of the component levels
- List Components Displays the component list
Builds SCL Actions for selected elements in the project view. You must have assigned CA 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 CA Endevor actions:
-
Generate.
Builds SCL statement for CA 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 CA 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 CA 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 CA Endevor