Package View
Package View lists the Packages that are related to a specified repository. The Package View interface has an embedded visual notification when the selected Package action is processing. When the Package is being processed, the selected element table row flashes BLUE until the action process ends. If there is an error, the background color of the table row is set to RED. The next action on the Package resets the error condition of the highlighting functionality.
Package View lists the Endevor Packages that are related to a specified repository. The Package View interface has an embedded visual notification when the selected Package action is processing. When the Package is being processed, the selected element table row flashes BLUE until the action process ends. If there is an error, the background color of the table row is set to RED. The next action on the Package resets the error condition of the highlighting functionality.
Package View Tools
The Package View tool bar has buttons to initiate the following actions.
- Refresh Package View
- Initiates the request to update data in Package View.
- Create Package
- This Wizard page allows you to fill in appropriate fields, options, and task completion that creates a package in a selected repository. You can then click next on this page to navigate to the Package Notes Wizard page.
- (Optional) Package Notes Wizard
- On this Wizard sub-page, you can enter Package Notes that are associated with the Create Package action.
- Sort Package
- Sorts the display of packages in the Package View in alphabetical order, either ascending or descending. This action is applied to all fields.
Package View Actions
You can perform the following actions from the Package View:
- Reset Package
- Sets the status of any Package of any status back to In-Edit to modify the Package.
- Cast Package
- Prepares the Package for review and subsequent execution. Casting a Package freezes the content and prevents further changes to the Package. You can use the Cast Package action on every Package with the In-Edit status.
- Approve Package
- Approves a package in In-Approval status for execution
- Deny Package
- Changes the status of a package from In-Approval to Denied
-
Package Notes are enabled for this feature.
-
- Execute Package
- Executes a Package. You can use the Execute action on Packages that have a status of Approved or Exec-failed.
- Commit Package
- Removes all Backout/Backin data from a package but retains package event information. You can use the Commit action on a Package only if the Package has a status of Executed or Exec-failed.
- Delete Package
- Deletes a Package.
- Update Package
- Opens a dialog to update the properties of the specified package as follows:
- Package Description
- Package Options:
- Package Type
- Promotion Package Values: Y/N
- Sharable Package Values: Y/N
- Enable Backout Values: Y/N
- Package Execution window
- Assign Project
- Assigns the currently selected Package to the project as a project contextual Package. After you assign the Package, go to Project View, and select the required actions in the contextual menu for an Endevor Actions SCL creation.
Package View Icons
The Package View includes a column showing the following icons which indicate the status and contents of the Package:
-
Local SCL existsA text file containing the SCL for the Package is present in the .endevorPackagesproject inside the Eclipse workspace -
Package has been denied -
Package execution has failedPackage is in exec-failed status
Package View Status Indicators
The Package View also indicates Package status by highlighting Package entries as follows:
- Package in edit
- indicates that package status is as follows:
- IN-EDIT
- Package in approval process
- indicates that package status is as follows:
- IN-APPROVAL
- APPROVED
- DENIED
- Package in post-execution state
- indicates that package status is as follows:
- IN-EXECUTION
- EXECUTED
- EXEC-FAILED
- COMMITTED
Package SCL management
The Package SCL is handled differently to how it is handled on the ISPF panel interface. The SCL is not edited directly in the Package.
When you edit a Package SCL, the SCL is downloaded from the remote repository (Endevor) to the local project in the Eclipse workspace. The Package SCL status is indicated by the terms Local and Remote to differentiate the two stages of the Package SCL in the Endevor Eclipse-Based UI. Edit the Local SCL, and once satisfied with the edits, you can then use it to update the Package in the remote repository (Update Remote Package SCL action).- Local SCL
- A text file containing the SCL for a particular Package present in the
.endevorpackagesproject that is located inside the Eclipse workspace. It is a local representation of the Package SCL and can be different from the Package SCL in the remote repository (Endevor). The presence of a local SCL for a particular Package is indicated by a blue down arrow icon (
) in the "St" column next to the Package in the Package View. - Remote SCL.
- The SCL for a particular Package in the Endevor remote repository
You can perform the following actions from the Package SCL Management:
- Edit Package SCL
- If the Local SCL is present, it is opened in the editor. If the Local SCL is not present, it is first downloaded from the remote repository, and then stored locally as a Local SCL. This Local SCL is then opened in the editor. This action can be used only on Packages in In-Edit status.
- Update Remote Package SCL
- Updates the specified Package in the remote repository using the Local SCL. The Local SCL is then deleted. This action can be used only on Packages with a Local SCL, and in In-Edit status.
- Revert Package SCL
- Discards all the changes that are applied to the Local SCL, and reverts to the remote SCL. This option downloads the remote SCL for the particular Package from remote repository and overwrites the Local SCL. This action can be used only for Packages with a Local SCL and in In-Edit status.
- Browse Package SCL
- Allows you to browse the SCL in read-only mode. If the Local SCL is present, select which SCL (Local or Remote) to browse.
- Local SCL:
- Local SCL opens in the editor in read-only mode with extension
.browse.local. - Remote SCL:
- Remote SCL is downloaded from the remote repository and stored in the system Temp location. You can then open it in the editor in read-only mode with extension .
browse.remote.
Package Notes
To open the Package Notes, locate a package in the repository in Package View. Right-click on the Package, and select the option to Browse, or Edit Package Notes from the menu. A display panel then appears with the Package name and eight 60-character note fields. The Browse and Edit views display options as follows:
- Browse
- Cancel
- Exits the Package Notes view and returns to the main Package View
- Edit
- Update
- Updates the Package Notes in view, as required, and prompts to confirm changes on exit
- Cancel
- Exits the Package Notes view and returns to the main Package View
Enclose the Package note text in single or double quotation marks. If you use multiple text lines, enclose each text line in quotation marks and separate the lines with commas.
Example:
-
Package last amended by user J.Smith on 7th July 2014 -
Package shows data for June - September 2018