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.

eehs18007

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.
Note:
  • The Package Create wizard mirrors the options for Package Define in the mainframe Endevor application but excludes Package Notes functionality

  • The Package Create wizard allows you to include import of the SCL file from the local Eclipse workspace.

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.
The Cast Package action dialog includes the following tabs:
Options:
Allows you to specify Package actions as follows:
Package Execution Window
Specifies the execution window of the Package as part of cast processing as follows:
Start Date
Values: DDMMMYY (for example: 01JAN19)
Start Time
Values: HH:MM (for example: 00:01)
End Date
Values: DDMMMYY (for example: 02JAN19)
End Time
Values: HH:MM (for example: 23:59)
Note:

You can use the Execution Window clause only if the Package ID is fully qualified. If you specify the start date, specify the start time. If you specify the end date, specify the end time.

Enable Backout
Enables or disables the backout facility for the Package.
Values: Y/N
Validate Components
Enables component validation within the Package
Values:
Yes
Causes the action to fail if component validation fails.
No
Causes the action to proceed, without checking components.
Warn
Generates a warning in the Endevor Log View if component validation fails.
Package Notes
Allows you to include further information about the contents and purpose of the Package.
Approve Package
Approves a package in In-Approval status for execution
  • Package Notes are enabled for this feature.
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
The Update Package menu item is only available for Packages in In-Edit mode.
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.
Note:

Only Packages with In-Edit status are available for selection for Package assignment.

Package View Icons

The Package View includes a column showing the following icons which indicate the status and contents of the Package:

  • icon_local3.png Local SCL existsA text file containing the SCL for the Package is present in the .endevorPackages project inside the Eclipse workspace

  • icon_denied.png Package has been denied
  • icon_failed2.png 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 .endevorpackages project 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 (icon_local3.png) 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
Note:

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