Package ship destination removal/cleanup
Article ID: 442612
Updated On:
Products
Issue/Introduction
What is the recommended process for cleaning up obsolete package ship destinations.
Environment
Endevor
Resolution
In Endevor, when you delete a Package Ship destination, the mapping rules associated with that destination are also removed because they are dependent child records of the destination definition.
Step 1: Before deleting a ship destination, it is best practice to take a snapshot of the destination if there is any chance you may need to recreate the destination in the future. This can be accomplished by submitting a BUILD SCL of the current destination.
Sample Build SCL JCL... supplied in the .CSIQJCL(ENBE1000) member.
//<jobcard>
//***********************************************************************
//* BUILD SCL FOR DEST XXXXXXX *
//***********************************************************************
//STEP01C PGM=NDVRC1,PARM='ENBE1000',REGION=4096K
//STEPLIB DD DISP=SHR,DSN=HLQ.CSIQAUTU
// DD DISP=SHR,DSN=HLQ.CSIQAUTH
//CONLIB DD DISP=SHR,DSN=HLQ.CSIQLOAD
//C1MSGS1 DD SYSOUT=*
//C1MSGS2 DD SYSOUT=*
//BSTERR DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//SYSTERM DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SYMDUMP DD DUMMY
//ENESCLIN DD *
BUILD SCL FOR SHIPM DEST "XXXXXXX" TO DSNAME 'your.ddn.SCL' MEMBER 'XXXXDEST' REPL .
Step 2: Delete destination
(Option A: if there are only a few destinations)
Access the Endevor ISPF panels.
Navigate to Option 4 (ENVIRONMENT) and then Option D (DESTINATION).
Locate the destination entry.
Use the Delete (D) line command to remove the destination definition.
(Option B: If there are a large amount of destinations)
Using the same JCL as you used for the Build SCL for Destination... create DELETE SHIPM DEST SCL
DELETE SHIPMENT DESTINATION "XXXXXXX" .
Step 3: ESI cleanup. If you have implemented external security interface (ESI) for your package ship destinations, deleting the destination in Endevor does not automatically remove the security rules from your ESI (ACF2, TSS, or RACF); these must be cleaned up manually.
Verify if there are any associated Mapping Rules or ESI security rules (e.g., C1.PACKAGE.SHIP.XXXXXXX) that also need to be retired. You can review your BC1TNEQU ESI mappings to see if there are any for ship. If there are, you should contact your security team and work with them on reviewing the Endevor rules for any needed cleanup.
Step 4: Validate removal of destination.
Confirm the removal by attempting to build a shipment and verifying destination is no longer in the selection list.
Feedback
