Project View
Project View lists CA Endevor SCM 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 SCM systems, subsystems, environment, and stages to elements with local elements in local branch. CA Endevor SCM elements and their CA Endevor SCM 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 CA Endevor SCM branch that contains CA Endevor SCM elements, and local branch that contains local elements.
The Project View has extended functionality that involves a contextual CA Endevor SCM 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 SCM 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.
Notes:
-
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 CA Endevor SCM, 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 SCM. 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 SCM Action under Team to add the created element into CA Endevor SCM. 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 SCM Action. For instructions about how to edit an element, see Elements.
-
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
-
-
Click Next
-
Complete the CA Endevor SCM 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 SCM
Indicates whether the created element should be added into CA Endevor SCM. 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 appearsNote: 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 CA Endevor SCM 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 SCM>Action Options>Add/Update -
Always open CA Endevor SCM Action Options dialogue.
Sets the CA Endevor SCM Action Options page to be opened every time that you add or create an Element in CA Endevor SCMNote: 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 CA Endevor SCM 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 SCM 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 SCM defined life cycle map.Notes:
-
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
Build Package Actions
Builds SCL Actions for selected elements in the project view. You must have assigned CA Endevor SCM 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 SCM actions:
-
Generate.
Builds SCL statement for CA Endevor SCM 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 SCM 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 SCM 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 SCM