Endevor package shipping: The destination selection list
Article ID: 427818
Updated On:
Products
Issue/Introduction
When building a package output shipping request using the panels, Endevor presents a selection list of destinations so the user may choose where to ship the package (panel C1SPD10D)
Depending on the case, the list may show all the shipping destinations defined in the package dataset or only a subset of them.
Why does it happen?
Resolution
The behavior depends on the outputs produced by the package being shipped and on whether optional feature SHIP_DEST_LIST_MAP_RULE_ONLY is enabled in the optional features table
By default, the list shows all the destinations defined in the package dataset. However, when optional feature SHIP_DEST_LIST_MAP_RULE_ONLY is enabled in the ENCOPTBL table, the list is filtered so that only those destinations having mapping rules that match some of the package output datasets are included in the list.
The reason for this behavior is in the way package shipping and this option work.
- By default, an output dataset whose DSN does not match any mapping rule is shipped giving the remote dataset the same name as the local dataset.
- However, when SHIP_DEST_LIST_MAP_RULE_ONLY is enabled, the datasets that don't have any matching rule are excluded from the shipping.
When the option is enabled, panel C1SPD10D filters the choice of destinations to prevent the user from selecting a destination that would produce a 'null shipping' (a shipping that doesn't ship anything) which, at the very least, would cause confusion.
Additional Information
You can 'see' the setting of SHIP_DEST_LIST_MAP_RULE_ONLY by taking an options report as follows:
- Get out from Endevor or logoff/logon
- TSO ALLOC FI(EN$TROPT) SYSOUT(X) SPIN(NO)
- Get into endevor up to the first panel and get out
- Browse ddname EN$TROPT among the JES2 outputs from your TSO session
- Scroll down to section "Endevor Site Options Settings"
- See whether SHIP_DEST_LIST_MAP_RULE_ONLY shows in the 'Enabled Options' or in the 'Options Not Enabled' column
For example:
1 Endevor Version 19.0.00 Copyright (C) 2022 Broadcom. All Rights Reserved. 03FEB26 07:14:26 PAGE 9
Endevor Site Options Settings
Optional Features Table - OPTMF20 CREATED: 01/23/25 - 12.25
---------- Enabled Options ----------------- ---------- Options Not Enabled ---------
ALLOW_NON_PKG_ACTIONS 0010 ACM_USE_ELEMENT_NAME
.....
SHIP_DEST_LIST_MAP_RULE_ONLY
In this example, the option is not enabled
Feedback
