bvstone

MAILTOOL Update - Clear Recipients Function Now Available

Posted:

MAILTOOL Update - Clear Recipients Function Now Available

With MAILTOOL v9.10 we have added a new subprocedure named #mailtool_clearRecipients().

Documentation for this new feature can be found in the documentation.

What this function allows you to do is clear either all, or just a specific type (ie, TO, CC or BCC) of recipient from the list.

Here's an example of using this new feature:

     H DFTACTGRP(*NO) BNDDIR('BVSTOOLS')
      ****************************************************************
      * Prototypes                                                   *
      ****************************************************************
      /COPY QCOPYSRC,P.MAILTOOL
      ****************************************************************
     D ErrMsg          S            256    INZ
     D rc              S             10i 0
     D msgID           S             13s 0
     D myMessage       S          65535
      ****************************************************************
      /free

       myMessage = 'This is my message!  It could be long or short!';

       if (#mailtool_init() >= 0);
         rc = #mailtool_setValue('configuration_file':
                                 '/bvstools/bvstools_mailtool.json');
         rc = #mailtool_loadDefaults();
         rc = #mailtool_addTORecipient('bvstone@gmail.com');
         rc = #mailtool_addTORecipient('bvstone@outlook.com');
         rc = #mailtool_setValue('subject':'Test #mailtool_clearRecipients');
         rc = #mailtool_setMsgPtr(%addr(myMessage):%len(%trim(myMessage)));
         rc = #mailtool_sendMail(errMsg:msgID);

         rc = #mailtool_clearRecipients();
         rc = #mailtool_setValue('subject':'just bvstone at gmail');
         rc = #mailtool_addTORecipient('bvstone@gmail.com');
         rc = #mailtool_sendMail(errMsg:msgID);

         rc = #mailtool_clearRecipients();
         rc = #mailtool_setValue('subject':'gmail and 2 ccs');
         rc = #mailtool_addTORecipient('bvstone@gmail.com');
         rc = #mailtool_addCCRecipient('bvstone@outlook.com');
         rc = #mailtool_addCCRecipient('bvstone@yahoo.com');
         rc = #mailtool_addAttachment('/tmp/paypal.txt');
         rc = #mailtool_sendMail(errMsg:msgID);

         rc = #mailtool_clearRecipients(TO);
         rc = #mailtool_setValue('subject':'just 2 ccs');
         rc = #mailtool_sendMail(errMsg:msgID);
       endif;

       *INLR = *ON;
      /end-free

As you can see, this example sends 4 emails and simply changes the recipient list each time.   Other values can be changed before the email as well such as the subject and message and attachments (but attachments cannot be removed without calling the #mailtool_init() subprocedure again to reset everything).

The only things that are reset after each email send are the MIME file (if you happen to be using your own vs. letting MAILTOOL built it) and the debug file names which are reset to the defaults after each email is sent.

As always, feel free to contact us with any questions.  Thanks!

Brad
www.bvstools.com




Latest Posts:

JOBWATCH 5.10 Released with New Feature to Monitor CPU Percentages JOBWATCH 5.10 Released with New Feature to Monitor CPU Percentages
Posted by May 10, 2021
BVSTools >> BVSTools Announcements >> Job Watch (JOBWATCH) Specific Announcements
Iseries Access data transfer Iseries Access data transfer
Posted by April 29, 2021
IBM Power Systems >> (QGPL) IBM i
YAJL - Parsing YAJL - Parsing
Posted by April 4, 2021
Programming >> RPG Programming
Create LPAR partition and install OS Create LPAR partition and install OS
Posted by March 24, 2021
IBM Power Systems >> (QGPL) IBM i
G4MS Now Allows User/Password Authentication Option G4MS Now Allows User/Password Authentication Option
Posted by March 16, 2021
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
IPDS printer file using CHRSIZ IPDS printer file using CHRSIZ
Posted by February 25, 2021
Programming >> RPG Programming
How to Correctly Send the Display Machine Information (DSPMCHINF) Data to BVSTools for Key Generation How to Correctly Send the Display Machine Information (DSPMCHINF) Data to BVSTools for Key Generation
Posted by February 9, 2021
BVSTools >> BVSTools Software Discussion
G4MS Updated to v7.10 - Required Update for All G4MS Users G4MS Updated to v7.10 - Required Update for All G4MS Users
Posted by November 12, 2020
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
MAILTOOL Errors with Microsoft Office 365 (2020) MAILTOOL Errors with Microsoft Office 365 (2020)
Posted by September 3, 2020
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
Using MAILTOOL With Office 365 and Two Factor Authentication (2FA or MFA) Using MAILTOOL With Office 365 and Two Factor Authentication (2FA or MFA)
Posted by August 17, 2020
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
Updating DNS With Dynamic IP Addresses After a Router Reboot/Power Outage Updating DNS With Dynamic IP Addresses After a Router Reboot/Power Outage
Posted by August 16, 2020
Programming >> Proof of Concept (POC)
GETURI v10.10 Released with New ILE Functions GETURI v10.10 Released with New ILE Functions
Posted by August 12, 2020
BVSTools >> BVSTools Announcements >> Get URI (GETURI) Specific Announcements
MAILTOOL Updated to Allow G4GSMAIL as Option in Routers File MAILTOOL Updated to Allow G4GSMAIL as Option in Routers File
Posted by June 28, 2020
BVSTools >> BVSTools Announcements >> eMail Tool (MAILTOOL) Specific Announcements
BVSTools Now Offers Interface with Infor's ION APIs BVSTools Now Offers Interface with Infor's ION APIs
Posted by May 15, 2020
BVSTools >> BVSTools Announcements
More V7R4 IFS File CCSID Issues and The Fix More V7R4 IFS File CCSID Issues and The Fix
Posted by March 4, 2020
IBM Power Systems >> (QGPL) IBM i

Reply




Copyright 1983-2020 BVSTools
GreenBoard(v3) Powered by the eRPG SDK, MAILTOOL Plus!, GreenTools for Google Apps, jQuery, jQuery UI, BlockUI, CKEditor and running on the IBM i (AKA AS/400, iSeries, System i).