#mailtool_init

  *//////////////////////////////////////////////////////////////*      
  * #mailtool_init - Initialize MAILTOOL                         *      
  *                                                              *      
  * Output:                                                      *      
  *   out_errMsg - The error message (if error exists).          *      
  *                                                              *      
  * Returns:                                                     *      
  *   -1 for error, 0 for no error.                              *      
  *                                                              *      
  *//////////////////////////////////////////////////////////////*      
 D #mailtool_init...                                                    
 D                 PR            10i 0       

This function initializes the MAILTOOL function. It should be used as the first thing before setting variables or running the send email function.

When #mailtool_init() is called, the default values in the specified configuration file are used. These values can be overridden using the #mailtool_setValue() function after the initialization has taken place.

The only value that can and should be set before calling the #mailtool_init() function are "configuration_file" and "ignore_blanks".

An example of a JSON configuration file is as follows:

{
  "variables": [{
   "name": "from_email",
   "default": " "
  }, {
   "name": "from_name",
   "default": " "
  }, {
   "name": "subject",
   "default": " "
  }, {
   "name": "message",
   "default": " "
  }, {
   "name": "reply_to_email",
   "default": " "
  }, {
   "name": "reply_to_name",
   "default": " "
  }, {
   "name": "mdn_email",
   "default": " "
  }, {
   "name": "mdn_name",
   "default": " "
  }, {
   "name": "sender_email",
   "default": " "
  }, {
   "name": "sender_name",
   "default": " "
  }, {
   "name": "footer_stream_file",
   "default": " "
  }, {
   "name": "message_id",
   "default": " "
  }, {
   "name": "message_id_domain",
   "default": " "
  }, {
   "name": "send_with_server_type",
   "default": "*IBMSMTP"
  }, {
   "name": "mail_router",
   "default": "*NONE"
  }, {
   "name": "use_mail_router",
   "default": "*NO"
  }, {
   "name": "perform_mx_lookup",
   "default": "*YES"
  }, {
   "name": "use_ssl",
   "default": "*NO"
  }, {
   "name": "smtp_port",
   "default": "25"
  }, {
   "name": "smtp_auth_user",
   "default": " "
  }, {
   "name": "smtp_auth_password",
   "default": " "
  }, {
   "name": "bind_to_ip_address",
   "default": " "
  }, {
   "name": "timeout",
   "default": "30"
  }, {
   "name": "ccsid",
   "default": "819"
  }, {
   "name": "no_attachment_action",
   "default": " "
  }, {
   "name": "body_content_type",
   "default": "text/plain"
  }, {
   "name": "mime_ccsid",
   "default": "819"
  }, {
   "name": "temporary_directory",
   "default": "/tmp"
  }, {
   "name": "importance",
   "default": "normal"
  }, {
   "name": "priority",
   "default": " "
  }, {
   "name": "recipient_separator",
   "default": ","
  }, {
   "name": "close_connection",
   "default": "*YES"
  }, {
   "name": "save_email",
   "default": "*DFT"
  }, {
   "name": "debug",
   "default": "*NO"
  }, {
   "name": "debug_file",
   "default": "mailtooldebug_/%id%/.txt"
  }, {
   "name": "debug_smtp_file",
   "default": "mailtoolsmtp_/%id%/.txt"
  }
 ]
}