Email the contents of a Deliver bundle, in its entirety, to a specific DISTID using OM Spool
search cancel

Email the contents of a Deliver bundle, in its entirety, to a specific DISTID using OM Spool

book

Article ID: 444488

calendar_today

Updated On:

Products

OM Deliver

Issue/Introduction

We would like to email the contents of an entire Deliver bundle to a specific DISTID via OM Spool.

We have 8 different reports defined to a Deliver bundle that all go to the same email recipient. Currently, when using OUT=E at the DISTID level, the reports are NOT bundled and the recipient receives 8 individual emails. The user wants one email that includes all 8 reports. How can this be accomplished?

Environment

Deliver, Spool, z/OS

Cause

Using the OUT=E setting at the DISTID level causes each reports not to be bundled, resulting in each report being emailed individually.

Resolution

 

- Deliver currently does not provide an OUT=E parameter for emailing the contents of an entire bundle in a single email.

- To address this limitation, the idea would be to specify OUT=Y for the desired DISTID, so that Deliver writes the bundle out to JES as a single dataset that matches OM Spools post-spool processing criteria. Then have OM Spool pick it up and email the entire Deliver output bundle, in a single email, to the desired recipient.

- An outline of the instructions for how to configure Deliver and have OM Spool email the contents of an entire Deliver bundle in a single email follows:

 

1. Create a Deliver EFORMAT banner member that is specific to emailing to your desired DISTID.  Then run RMODBASE BLOAD to add the Bundle EFORMAT to the Deliver database.

  Example:
  
  your.deliver.CVDED133(BNDLMAIL)   
  ***************************** Top of Data ********
  /EMAIL PARMS                                      
   CLASS=B                 <----- modify  to meet Spool node requirement                         
   DEST=DLVEMAIL    <----- modify  to meet Spool node requirement                                    
   FORMS=                                           
   WRITER=                                          
   SENDRPT=YES                                      
   MAILTO=&yourdistid@email.address                           <----- modify                
   ADDRESS='SUBJECT=REPORT &ARCHID (&DESC) ATTACHED'
****** **************************** Bottom of Data ******

 

2. Create a Deliver BUNDLE DEFINITION to be used for bundling the 8 reports that will get emailed to yourdistid.  

    On this Bundles Definition Screen, specify the EFORMAT from above in the first "Banner" position, and a "BDist" of yourdistid:

   Attributes:                                       
   Banner   ===> ( BNDLMAIL ,          ,          )
   BDist    ===> yourdistid

 


3. Add/Modify the Deliver - Distribution Data for Distid: yourdistid to include/mimic the values coded in the EFORMAT member created in Step 1:

   Example:

   Destination:                                              
   Dest    ===> DLVEMAIL             CA Connect Node ===> NO
   Writer  ===>                                             
   Class   ===> B                                          
   Email   ===> yourdistid@email.address                  
   EFormat ===> BNDLMAIL                                  
   WebSvr  ===> 1                                          

 

4. At the REPORT/DISTID DEFINITION level of the 8 reports in the bundle, access option "D - Distribution specifications" and set the OUT flag for DISTID yourdistid to a 'Y' for all 8 reports.

   Example: 

   Distribution Specifications:                   
   Sel Grp Distribution ID                 Out
            yourdistid                     Y

 

5. Run the 8 jobs that produce the reports and let them get bundled together in Deliver. When Deliver prints the bundle, it will be written out to the JES queue as a single dataset containing all 8 reports. Once in JES, have OM Spool process the dataset and email the contents of the entire bundle.

Additional Information

You can configure OM Spool for POST-SPOOL processing of this dataset.  For more information on how to configure OM Spool to post-spool process this data, see the Output Management Spoolâ„¢ for z/OS 14.0 documentation regarding parameters (XFERCLAS and XFEROPT):

XFERCLAS=B - Tells SPOOL SAPI what POST-SPOOL CLASS to process.

XFEROPT=B   - Tells SPOOL SAPI to match XFERCLAS and Spool NODE (Node DLVEMAIL in this article), for POST-SPOOL processing.