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 [2024/04/02 12:52] – [Work with Log] kkramerpub:imail [2026/03/26 19:45] (current) – [Configure iMail] kkramer
Line 58: Line 58:
  
 <html><pre> <html><pre>
- 12/01/16                            iMail                           IMCFGC1   + 02/26/26                            iMail                           IMCFGC1   
  08:10:36             inFORM Decisions iMail Configuration           QSECOFR     08:10:36             inFORM Decisions iMail Configuration           QSECOFR   
                                                                                                                                                                
Line 74: Line 74:
  Authentication Password. . . .   Authentication Password. . . . 
  Authentication Encrypted (Y/N)   N                                                 Authentication Encrypted (Y/N)   N                                               
 + Outlook 365 OAuth - Config Folder                                               
  Auto wrap message length . . .   1900                                           Auto wrap message length . . .   1900                                         
  Force Socket End (*YES/*NO). .   *YES                                           Force Socket End (*YES/*NO). .   *YES                                         
Line 97: Line 98:
   * 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.
   * 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.
 +  * 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. \\ **8.02 (03/13/26)** \\ **Additional information:** \\ 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}}. 
   * 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 260: Line 262:
   * When the data area is set to 'N' then the iMail log will display without restriction.   * When the data area is set to 'N' then the iMail log will display without restriction.
   * When the data area is set to 'Y' then the iMail log will restrict access to users so they only see their own emails and the '4=Delete', '7=Resend' and '9=Forward Mail' aren't displayed as options.  Only User Profiles with *SECOFR and *SECADM will be able to see all mail logs and be able to use the "4=Delete" and '7=Resend' and '9=Forward Mail' options.   * When the data area is set to 'Y' then the iMail log will restrict access to users so they only see their own emails and the '4=Delete', '7=Resend' and '9=Forward Mail' aren't displayed as options.  Only User Profiles with *SECOFR and *SECADM will be able to see all mail logs and be able to use the "4=Delete" and '7=Resend' and '9=Forward Mail' options.
- 
-  * Option 4 Deletes the eMail 
-  * Option 5 Displays the eMail 
-  * Option 7 Resend the eMail 
-  * Option 8 Displays the eMail log 
-  * Option 9 Forwards the eMail by displaying the EFWDLOG screen (see below) 
- 
  
 <html><pre> <html><pre>
Line 293: Line 288:
                                                                                                                                                                                                        
 </pre></html> </pre></html>
 +
 +  * Option 4 Deletes the eMail (CONFIRM by answering Y/N)
 +  * Option 5 Displays the eMail message details
 +  * Option 7 Resend the eMail
 +  * Option 8 Mail job log is only available for error transactions 
 +  * Option 9 Forwards the eMail by displaying the EFWDLOG screen shown below. (Enhancement to iDocs 8.00; 03/27/24)
 +<html><pre>
 +                       Forward iMail Transaction (EFWDLOG)                      
 +                                                                                
 + Type choices, press Enter.                                                     
 +                                                                                
 + iMail Log ID (ELMAILID)  . . . . > 202404011025400830000000                    
 + To Address . . . . . . . . . . .   ken@informdecisions.com                                            
 +                                                                                
 +                                                                                
 + Subject  . . . . . . . . . . . .   *SAME                                       
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                         Bottom 
 + F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display    
 + F24=More keys                                                                  
 +                                                                                
 +</pre></html>
 +**Paramaters:**
 +  * MSGID (26A): user inputs 26 characters which retrieves record from file FRMEMLLOG by field ELMAILID; 
 +  * TOADDR (128A): user inputs new destination addresses, seperated by blank or colon; 
 +  * SUBJECT (128A): *SAME if user wants to use same subject in field ELEMSUBJ of FRMEMLLOG or enter new subject 
 +
 The **F8** function runs the [[pub:miscadmincmd|PRGMAILLOG]] command to purge the email log file. The **F8** function runs the [[pub:miscadmincmd|PRGMAILLOG]] command to purge the email log file.
  
Line 415: Line 447:
 In most PC based email systems this type of distribution list would be limited to a table confined to potential recipients. This is not true of iMail. Although recipient email addresses can be created here, sender email addresses are created and maintained in this program as well.  Moreover, once a sender’s email address is created that address can be associated with an AS/400 User profile. In this way, when sending an email a user’s originating email address can automatically be generated. In most PC based email systems this type of distribution list would be limited to a table confined to potential recipients. This is not true of iMail. Although recipient email addresses can be created here, sender email addresses are created and maintained in this program as well.  Moreover, once a sender’s email address is created that address can be associated with an AS/400 User profile. In this way, when sending an email a user’s originating email address can automatically be generated.
  
 +====== User Profile Considerations ======
 +With IBM i, user profiles can be created with names up to 10 characters. However, when adding a user to the SNA (Systems Network Architecture) directory entry system using the ADDDIRE command, the User ID (USRID) field is restricted to 8 characters maximum. This limitation stems from legacy SNA and OfficeVision compatibility requirements.
 +
 +When a user profile name exceeds 8 characters (e.g., MWTRAIN10), only the first 8 characters (MWTRAIN1) are used in the directory USRID. This leads to conflicts when:
 +
 +  * Multiple user profiles share the same first 8 characters.
 +  * Directory entries become ambiguous or overwrite each other.
 +  * Messaging and routing via SNADS or other directory-dependent functions fail or misroute messages.
 +
 +**Conflict example:**
 +
 +^ User Profile: ^ Intended Directory ID: ^ USRID truncation:                                                            ^
 +|MWTRAIN1  |MWTRAIN1 |MWTRAIN1 | 
 +|MWTRAIN10 |MWTRAIN10 |MWTRAIN1 (conflict) | 
 +
 +In the example above, both users map to MWTRAIN1 in the SNA directory, causing a conflict.
 +
 +**Resolution: Use Alias IDs (≤8 Characters) for Directory Entries**
 +
 +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:**
 +
 +MWTRAIN10 → Alias: MWTRN010
 +
 +ADDDIRE USRID(MWTRN010 LCLSYSTM) USRD('Alias for MWTRAIN10') USER(MWTRAIN10)
 +
 +
 +==== Work with distribution list ====
 Work with public distribution list, shows the initial public table of email addresses. The maintenance program uses the standard editing options and functions keys to maintain the list. Using an option 1 next to the email address enables that entry to be edited, whereas pressing the F6 key adds a new record to the email table. Work with public distribution list, shows the initial public table of email addresses. The maintenance program uses the standard editing options and functions keys to maintain the list. Using an option 1 next to the email address enables that entry to be edited, whereas pressing the F6 key adds a new record to the email table.
  
pub/imail.1712087564.txt.gz · Last modified: 2024/04/02 12:52 by kkramer