inFORM Decisions Information Portal

User Tools

Site Tools

Trace:
pub:imail

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
pub:imail [2025/03/21 20:44] – [User Profile Considerations] kkramerpub:imail [2026/04/21 14:38] (current) – [Configure iMail] kkramer
Line 56: Line 56:
  
 The screen below displays the current configuration settings. The screen below displays the current configuration settings.
 +
  
 <html><pre> <html><pre>
- 12/01/16                            iMail                           IMCFGC1    +  4/21/26                            iMail                            IMCFGC1    
- 08:10:36             inFORM Decisions iMail Configuration           QSECOFR    + 11:43:59             inFORM Decisions iMail Configuration            KKRAMER    
-                                                                                +                                                                                 
- Configuration Setting            Configuration Value                           +  Configuration Setting            Configuration Value                           
- Domain Name. . . . . . . . . .   inFORMDecisions.com                           +  Domain Name. . . . . . . . . .   informdecisions.com                           
- Organization Name. . . . . . .   inFORM Decisions                              +  Organization Name. . . . . . .   inFORM Decisions                              
- Email Send Method.(SMTP/ESMTP)   SMTP                                          +  Email Send Method.(SMTP/ESMTP)   ESMTP                                         
- SMTP Host Mail Server. . . . .   192.168.0.2                                   +  SMTP Host Mail Server. . . . .   smtp.office365.com                            
- SMTP Port. . . . . . . . . . .   00025                                         +  SMTP Port. . . . . . . . . . .   00587                                         
- Local Host Mail Client . . . .   192.168.0.82                                  +  Local Host Mail Client . . . .   AS400                                         
- Sender Address . . . . . . . .   admin@yourdomain.com                     +  Sender Address . . . . . . . .   admin@yourdomain.com                   
- Default From Address . . . . .   admin@yourdomain.com                     +  Default From Address . . . . .   admin@yourdomain.com                  
- Default Reply To Address . . .   admin@yourdomain.com                     +  Default Reply To Address . . .   admin@yourdomain.com                   
- Authentication User Name . . . +  Authentication User Name . . .                      
- Authentication Password. . . .  +  Authentication Password  . . .                                 
- Authentication Encrypted (Y/N)   N                                                +  Authentication Encrypted (Y/N)   N                                             
- Auto wrap message length . . .   1900                                          +  Using OAuth 2.0 (DELEGATE/APP)   DELEGATE                                      
- Force Socket End (*YES/*NO). .   *YES                                          +  Outlook 365 OAuth Config Folder  /home/anguyen                                 
- Remove Over Printing (*YES/*NO)  *NO                                           +  OAuth Client ID . . . . . . . .            
- Auto Recipient Domain (*YES/*NO  *NO                                           +  OAuth Client Secret (APP mode).                                                
- Log outgoing mail (ON/OFF) . .   ON                                            +  OAuth Tenant ID . . (APP mode).                                                
-                                                                       More. . . +                                                                        More...  
-F3=Exit   F10=Save   F12=Cancel   F13=Configure Environment  F14=2nd SMTP                    + F3=Exit   F10=Save   F12=Cancel   F13=Configure Environment  F14=2nd SMTP       
 + Press enter to continue.   
 +</pre></html>  
 +Page down to continue.... 
 +<html><pre> 
 +      4/21/26                            iMail                            IMCFGC1    
 + 11:43:59             inFORM Decisions iMail Configuration            KKRAMER    
 +                                                                                 
 +  Configuration Setting            Configuration Value                           
 +  Auto wrap message length . . .                                                 
 +  Force Socket End (*YES/*NO). .   *YES                                          
 +  Remove Over Printing (*YES/*NO)  *YES                                          
 +  Auto Recipient Domain (*YES/*NO  *NO                                           
 +  Log outgoing mail (ON/OFF) . .                                                 
 +  Debug iMail (ON/OFF) . . . . .                                                 
 +  XLS Col from column text (Y/C/B  C                                             
 +  PDF Orientation  . . . . . . .   *SYSDFT                                       
 +  TLS/SSL Required (TLS/SSL)       TLS                                           
 +  Application id for certificate                                                 
 +  Use Java Mail (ON/OFF) . . . .   ON                                            
 +  iMail Batch Job Queue. . . . .                                                 
 +  Run Java Mail in Thread (YES/NO  NO                                            
 +  Ifs path for message macro file                                                
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                         Bottom  
 + F3=Exit   F10=Save   F12=Cancel   F13=Configure Environment  F14=2nd SMTP       
 + Press enter to continue.                                                                                                       
 </pre></html> </pre></html>
- 
 The configuration settings above are detailed below with their defaults, options and requirements. The configuration settings above are detailed below with their defaults, options and requirements.
  
Line 94: Line 122:
   * Default From Address - From address to be used if left blank in email commands.   * Default From Address - From address to be used if left blank in email commands.
   * Default Reply To Address - The address that will by default receive a reply if the recipient sends a response.   * Default Reply To Address - The address that will by default receive a reply if the recipient sends a response.
-  * Authentication User Name - This optional setting works with the ESMTP send method when authentication is required. +  * Authentication User Name - This optional setting works with the ESMTP send method when authentication is required. DELEGATE requires username. 
-  * Authentication Password - This optional setting works with the ESMTP send method when authentication is required. +  * Authentication Password - This optional setting works with the ESMTP send method when authentication is required. DELEGATE requires password. 
-  * Authentication Encrypted (Y/N) - This optional setting works with the ESMTP send method when encryption is required.+  * Authentication Encrypted (Y/N) - This optional setting works with the ESMTP send method when encryption is required. Select Delegated permissions if your application requires a user to sign in so that the access token can be issued for that sign-in. \\ **8.02 (04/21/26)** \\ **Additional information for using OAuth authentication:** \\ Microsoft 365 for iMail OAuth Configuration requirements {{pub:imail:helpful_notes_to_acquiring_the_oauth_information_you_will_need_from_microsoft_365_to_use_imail.pdf|PDF}}. \\ Instructions to configure iMail’s OAuth Authentication option {{pub:imail:instructions_to_configure_imail_s_oauth_authentication_option.pdf|PDF}}. \\ Guide for the two authentication modes supported by iMail for sending emails through Microsoft 365. {{pub:imail:oauth_setup_guide.pdf|PDF}}. 
 +  * Using OAuth 2.0 (DELEGATE/APP) - Select Application permissions if your application doesn't need any user to sign in. Select Delegated permissions if your application requires a user to sign in so that the access token can be issued for that sign-in. 
 +  * Outlook 365 OAuth - Config Folder - This field displays the directory path. The file name is always //iMailOAuth.config// and it’s not shown on configuration screen. If this field is specified, it will use Outlook 365 Open Authentication instead of username/password authentication.  
 +  * OAuth Client ID . . . . . . . .    -   Required when using OAuth 2.0 (DELEGATE/APP)  
 +  * OAuth Client Secret (APP mode).    -   APPLICATION requires Client Secret (no need username and password)  
 +  * OAuth Tenant ID . . (APP mode).     -  APPLICATION requires Tenant ID (no need username and password)  
 + 
   * Auto wrap message length - This required parameter contains the maximum line length for a message line before the line wraps to a new line. The default value is 78. If needing to control the message line length with embedded carriage returns and line feeds, then this value should be set to a default value of 1900.    * Auto wrap message length - This required parameter contains the maximum line length for a message line before the line wraps to a new line. The default value is 78. If needing to control the message line length with embedded carriage returns and line feeds, then this value should be set to a default value of 1900. 
   * Force Socket End (*YES/*NO) - Controls the ending of the conversation with the mail server.   * Force Socket End (*YES/*NO) - Controls the ending of the conversation with the mail server.
Line 102: Line 137:
   * Auto Recipient Domain (*YES/*NO) - This controls the ability to use a short hand method to define an email recipient. Should a recipient name not be supplied with only a name (i.e. your name), then the domain would automatically be added to the end of the name (i.e. yourname@yourdomain.com).   * Auto Recipient Domain (*YES/*NO) - This controls the ability to use a short hand method to define an email recipient. Should a recipient name not be supplied with only a name (i.e. your name), then the domain would automatically be added to the end of the name (i.e. yourname@yourdomain.com).
   * Log outgoing mail (ON/OFF) - Controls whether or not out going email is logged. Note that the message body, and attachment contents are not logged.   * Log outgoing mail (ON/OFF) - Controls whether or not out going email is logged. Note that the message body, and attachment contents are not logged.
- 
-<html><pre> 
-10/27/17                            iMail                            IMCFGC1    
-08:10:39             inFORM Decisions iMail Configuration            QSECOFR    
-                                                                                
- Debug iMail (ON/OFF) . . . . .   ON         
- XLS Col from column text (Y/C/B  C          
- PDF Orientation  . . . . . . .   *SYSDFT    
- TLS/SSL Required (TLS/SSL)       TLS           
- Application id for certificate              
- Use Java Mail (ON/OFF) . . . .   ON 
- iMail Batch Job Queue. . . . .  
- Run Java Mail in Thread (YES/NO)           
- Ifs path for message macro file  /imail/ 
- iMail signature folder . . . .   /home/user/imail_signatures  
-  
-                                                                                
-                                                                         Bottom  
-F3=Exit   F10=Save   F12=Cancel   F13=Configure Environment   F14=2nd SMTP                     
-Press enter to continue.                                                        
-            
-</pre></html> 
   * Debug iMail (ON/OFF) - For diagnostic purposes, and only when needed, turning on this settings helps to trouble shoot issues with email delivery.   * Debug iMail (ON/OFF) - For diagnostic purposes, and only when needed, turning on this settings helps to trouble shoot issues with email delivery.
   * XLS Col from column text (Y/C/B) - Determines whether or not column text is associated with the column data. If 'C' is entered in this setting, then the database COL keyword text associated with the field will be used to derive the column description. If 'Y' is entered, then the column name will be used to describe the column. If 'B' is entered, then the column text will be derived from the column description should it exist, otherwise the field name will be used.   * XLS Col from column text (Y/C/B) - Determines whether or not column text is associated with the column data. If 'C' is entered in this setting, then the database COL keyword text associated with the field will be used to derive the column description. If 'Y' is entered, then the column name will be used to describe the column. If 'B' is entered, then the column text will be derived from the column description should it exist, otherwise the field name will be used.
Line 133: Line 146:
   * Run Java Mail in Thread (YES/NO) - If YES it submits the job to the defined iMail job queue.   * Run Java Mail in Thread (YES/NO) - If YES it submits the job to the defined iMail job queue.
   * Ifs path for message macro file - Define the IFS folder to store macro files which are used in iMail API. In iMail message, user can define macro with convention &macro_name, then the macro will be looked up in this IFS folder.   * Ifs path for message macro file - Define the IFS folder to store macro files which are used in iMail API. In iMail message, user can define macro with convention &macro_name, then the macro will be looked up in this IFS folder.
-  * iMail signature folder - The IFS folder to store signature HTML files if signature feature is used with Java mail. When iMail sends an email, it will check if the signature folder specified, and look for the signature file (.htm or .html) of the From Address, if not found, then it will look for any entry for the current user ID name.\\ NOTE: To utilize this feature first create a HTM file with the way you want the signature line to look for each user and save to the directory location on the IFS that you want to store the HTM files. When saving he files, use the same name as the corresponding User Profile the file will be used with when sending an email. When activated, the formatted email will include the signature line. +  * <del>iMail signature folder - The IFS folder to store signature HTML files if signature feature is used with Java mail. When iMail sends an email, it will check if the signature folder specified, and look for the signature file (.htm or .html) of the From Address, if not found, then it will look for any entry for the current user ID name.\\ NOTE: To utilize this feature first create a HTM file with the way you want the signature line to look for each user and save to the directory location on the IFS that you want to store the HTM files. When saving he files, use the same name as the corresponding User Profile the file will be used with when sending an email. When activated, the formatted email will include the signature line. 
 +</del>
 Use **F13=Configure Environment** for more environmental options.\\ Use **F13=Configure Environment** for more environmental options.\\
 Use** F14=2nd SMTP** to specify a specify a second SMTP Host Mail Server if the first one does not connect (6.92). Use** F14=2nd SMTP** to specify a specify a second SMTP Host Mail Server if the first one does not connect (6.92).
Line 466: Line 479:
 To avoid conflicts while preserving your actual user profile names, you can assign a unique 8-character alias for the directory entry's USRID and link it to the full user profile using the USER() parameter. This allows the directory to uniquely identify each user while complying with the 8-character limit.  To avoid conflicts while preserving your actual user profile names, you can assign a unique 8-character alias for the directory entry's USRID and link it to the full user profile using the USER() parameter. This allows the directory to uniquely identify each user while complying with the 8-character limit. 
  
-Example Alias Directory Entries+**Example Alias Directory Entries:**
  
 MWTRAIN10 → Alias: MWTRN010 MWTRAIN10 → Alias: MWTRN010
pub/imail.1742615061.txt.gz · Last modified: 2025/03/21 20:44 by kkramer