PKMR208E THE PACKAGE SELECTED IS NOT AVAILABLE

Products

• Endevor

Issue/Introduction

An Endevor user trying to execute a package in foreground might get error message "INVALID SELECTION" in the "Package Foreground Options Menu" panel. The ISPF message ID (displayed by MSGID command) is PKMR208E and the full message text is PKMR208E THE PACKAGE SELECTED IS NOT AVAILABLE.

The message could also arise when selecting a package in the package shipment panel

How to troubleshoot this message?

Environment

Release : 18.0

Component : Endevor Software Change Manager

Cause

When the user enters a 'package ID' in a package processing panel (either specific or containing wildcards) Endevor builds a list of packages that fulfill the specified criteria. The resulting list may contain zero, one or several packages.

When the list contains several packages, it is displayed so that the user may select which package to process.

When it contains a single package, processing continues with the returned package. This is the expected result when the user specifies a full package ID without wildcards.

When the list contains zero packages and the user had specified a full package id, message PKMR208E is returned to indicate that the specified package is not eligible for the requested action. This may have several causes, including:

• For any action, the package is not in the correct status for the action. For example, for EXECUTE action, it needs to be in APPROVED or EXEC-FAIL
• For any action, the user has no permission to perform the action.
• For EXECUTE, the package has an execution time window and the action is being attempted out of the window
• For BACKOUT, BACKIN  or output shipping, the package does not have backout information.

Resolution

The status of the package as well as its execution window can be checked using the 'display package' option.

This panel also indicates whether the package has backout information. Options B (Display Data Set Backout Info) and/or BU (Display USS Backout Information) at the top of the panel display as highlighted (and may be selected) when there is backout information associated with the package.

About security, the way Endevor decides whether a userid is allowed to act upon a package depends first thing on the package security model in effect set by PKGSEC= parameter in C1DEFLTS TYPE=MAIN macro. The easiest way to see this setting is via option 1 (display) and 3 (site) from the Endevor primary options menu. It shows up in the second panel, in 'security' field under "Package Processing Options" and the value may be either:

• APPROVER - The user needs to be an approver in order to act upon a package once it has been CAST
• ESI - External security decides whether to allow the package action
• MIGRATE - If user is an approver, it is allowed the action. If it is not, external security may still allow the action

To see whether the userid is an approver for the package, go to the 'display package' panel. If option A (approvers) is highlighted, it means that the package has approvers. In this case, option A shows the approver groups associated with the package. If the option is not highlighted, the package has no approves so any user would pass the approver security check.

To see whether external security is being used and whether it is allowing or denying  the action upon the package, an external security trace (EN$TRESI) can be obtained.

In a few words, the checklist is:

• Check package status and backout information (if applicable) in the package display panel
• Check the package security option in effect in C1DEFLTS (approver, ESI or migrate)
• If approver or migrate, see whether the user is an approver for the package
• If ESI or if migrate with the user not being an approver, see (via an ESI trace) whether ESI is allowing or denying the action