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 [2018/06/07 09:50] – [Work with Users] kkramerpub:imail [2024/04/02 13:48] (current) – [Work with Log] kkramer
Line 1: Line 1:
-<html>&#091;</html>[[iMail | Up To iMail ]]<html>&#093;</html>+<html>&#091;</html>[[start | Up to Main Menu ]]<html>&#093;&#091;</html>  
 +<html>&#091;</html>[[start#imail | Up To iMail ]]<html>&#093;</html>
  
  
Line 9: Line 10:
  
 <html><pre> <html><pre>
- IMAIL                     iMail Menu  6.87  12.05.16                            + IMAIL                     iMail Menu  6.96  11.30.20                            
                                                                                                                                                                  
    iMail Administration                                                             iMail Administration                                                         
Line 78: Line 79:
  Auto Recipient Domain (*YES/*NO  *NO                                            Auto Recipient Domain (*YES/*NO  *NO                                          
  Log outgoing mail (ON/OFF) . .   ON                                             Log outgoing mail (ON/OFF) . .   ON                                           
-                                                              More. . . +                                                                       More. . . 
-F3=Exit   F10=Save   F12=Cancel   F13=Configure Environment                    +F3=Exit   F10=Save   F12=Cancel   F13=Configure Environment  F14=2nd SMTP                    
 </pre></html> </pre></html>
  
Line 101: Line 102:
   * 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> <html><pre>
Line 120: Line 120:
                                                                                                                                                                
                                                                          Bottom                                                                           Bottom 
-F3=Exit   F10=Save   F12=Cancel   F13=Configure Environment                    +F3=Exit   F10=Save   F12=Cancel   F13=Configure Environment   F14=2nd SMTP                    
 Press enter to continue.                                                        Press enter to continue.                                                       
                        
Line 134: Line 134:
   * 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.   * 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.
- + 
 +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).
        
 Configuration parameters that have been removed from prior versions:  Configuration parameters that have been removed from prior versions: 
Line 151: Line 153:
 ==== Configure Environment ==== ==== Configure Environment ====
  
-This environment setting is available to configure by selecting F13. Doing so renders the screen below:+This environment setting is available to configure by selecting **F13**. Doing so renders the screen below:
  
 <html><pre> <html><pre>
-  12/01/16                          iMail 6.87                      IM6000D1 +  12/01/16                          iMail 6.91                      IM6000D1 
- 13:40:00                  iMail Control Maintenance               QSECOFR + 13:40:00                  iMail Control Maintenance                KKRAMER 
                                                                                                                                                        
                                                                                                                                                        
Line 182: Line 184:
 The first portion of this display shows only the System i information useful for licensing and compatibility purposes. The lower half, Maintenance Information, enables the configurable settings to be changed. By in large, these settings will retain the default shipped values. However, to be as configurable, these values are exposed and may be changed.  The first portion of this display shows only the System i information useful for licensing and compatibility purposes. The lower half, Maintenance Information, enables the configurable settings to be changed. By in large, these settings will retain the default shipped values. However, to be as configurable, these values are exposed and may be changed. 
  
-  * Target IFS Directory - The target IFS directory contains the path off the root directory that will retain iMail attachements. +  * Target IFS Directory - The target IFS directory contains the path off the root directory that will retain iMail attachments. 
   * Default Library - The default library contains the library that iMail will refer to as a current library. In this way, iMail may be relocatable to another library defined by this value.   * Default Library - The default library contains the library that iMail will refer to as a current library. In this way, iMail may be relocatable to another library defined by this value.
-  * Default Code Page - This is useful for globalization purposes. Should you be running this software on a non United States system, and another code page needs to be used to accomodate your language, the code page can be set here. +  * Default Code Page - This is useful for globalization purposes. Should you be running this software on a non United States system, and another code page needs to be used to accommodate your language, the code page can be set here. 
-  * DIF File Code Page - The DIF file code page is essentially the same setting as above, but for a specifice file conversion of datatabase to DIF (Data interchange Format). +  * DIF File Code Page - The DIF file code page is essentially the same setting as above, but for a specific file conversion of database to DIF (Data interchange Format). 
-  * JAR Files directory - If the path is blank, then the Java ARchive files are saved in the default directory: /QIBM/USERDATA/JAVA400/EXT. If specified here, they are save in the specified directory.+  * JAR Files directory - If the path is blank, then the Java ARchive files are saved in the default directory: /QIBM/USERDATA/JAVA400/EXT. If specified here, they are save in the specified directory.  
 + <html> <pre> 
 +Note: You can check the existence of ifdjava.jar in /QIBM/UserData/Java400/ext with the command: <br> WRKLNK ‘/QIBM/UserData/Java400/ext/ifdjava.jar’. <br> 
 +If the JAR file is missing from your system, you can restore it with the following command:  
 + RST DEV('/qsys.lib/<i>currentiMaillibrary</i>.lib/jarfiles.file') OBJ(('/qibm/userdata/java400/ext/ifdjava.jar'))      
 +</pre></html> 
 + 
 +If a path is not specified in the iMail configuration, you can use CLASSPATH to specify the ifdjava.jar at the system level and when any java job is started, ifdjava.jar is loaded accordingly. 
 +**Note:** If not using the JAVA iMail option to send emails you can ignore CLASSPATH, but some RPG options still require JAVA.  i.e. if using iMail to send a Data Base file to XML a JAVA method is utilized.  If the ifdjava.jar file resides in QIBM you do not need CLASSPATH.   
 +==== Configure Secondary SMTP Settings ==== 
 + 
 +The **F14** (6.92) configures a second SMTP Host Mail Server if the first one does not connect is available. Doing so renders the screen below: 
 + 
 +<html><pre>  
 + 8/16/18                          iMail                              IM4300R1   
 + 11:52:30                  Secondary SMTP Settings                    KKRAMER    
 +                                                                                 
 + Settings                                                                        
 + Method (SMTP/ESMTP). : SMTP                                                     
 + SMTP name. . . . . . : relay.rclick.com                                         
 + Port . . . . . . . . :   25           Auth. Encrypted (Y/N): N                  
 + Auth. User Name. . . :                                                          
 + Auth. Password . . . :                                                          
 + TLS/SSL Required . . :                Use Javamail (Y/N) . : N                  
 +                                                                                 
 + Schedule day .: (Y=Select)                                                      
 +   MON  TUE  WED  THU  FRI  SAT  SUN                                             
 +    Y    Y    Y              Y    Y                                              
 + Schedule time :                                                                 
 +   Start Time (HHMM): 1500                                                       
 +   End Time . (HHMM): 2300                                                       
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                 
 +                                                                                 
 + F3=Exit  F10=Save  F12=Previous                                                 
 + © Copyright 1994-2018 inFORM Decisions, Inc. All Rights Reserved.               
 +</pre></html> 
 + 
 +These are the settings for 2nd SMTP and you can schedule for the time it is active. Once the iMail program runs during this active time, the 2nd SMTP settings will be effective.
  
  
Line 214: Line 256:
 ==== Work with Log ==== ==== Work with Log ====
  
-Option 2 from the iMail menu allows an administrator to view the status of out going emails from the System i. No preliminary configuration for this option is necessary. Illustrated in the screen shot, a log of previously sent email displays in descending chronological order.+Option 2 from the iMail menu allows an administrator to view the status of out going emails from the System i. No preliminary configuration for this option is necessary. Illustrated in the screen shot, a log of previously sent email displays in descending chronological order.\\ 
 +**Note:** What is displayed on the log is controlled by the Data area DSMLOGAUT.   
 +  * 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.
  
 <html><pre> <html><pre>
-  6/03/18                            iMail                            IMEMLOGC1  +  3/23/24                            iMail                            IMEMLOGC1  
  13:35:38                        iMail Send Log                       QSECOFR     13:35:38                        iMail Send Log                       QSECOFR   
                                                                                                                                                                    
-  4=Delete   5=Display   7=Resend   8=Mail log +  4=Delete  5=Display   7=Resend   8=Mail log   9=Forward Mail 
  
                                                                                                                                                                  
Line 239: Line 284:
 PAGE:        1 /      790                                                     PAGE:        1 /      790                                                    
 F3=Exit   F5=Reload   F7=Find   F8=Purge   F11=Next view   F12=Previous  F3=Exit   F5=Reload   F7=Find   F8=Purge   F11=Next view   F12=Previous 
-F17=Top  F18=Bottom     
                                                                                                                                                                                                        
 </pre></html> </pre></html>
  
-Pressing the F11 function key changes the current view of the logged messages to reveal more properties of logged email messages. Pressing the F11 once more reveals a third view of messages.+  * 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. 
 + 
 +<html><pre> 
 +  9/30/21                            iMail                            IMEMLOGC2  
 + 09:57:32                        iMail Send Log                       KKRAMER    
 +       ...........................................................               
 +  4=De :                  Purge iMail Log                        :               
 +       :                                                         :               
 +       : Press Enter to Purge                                    :               
 + Opt   :                                                         :               
 +       : Sent From :                                             :               
 +       : Sent To . :                                             :               
 +       : Status. . :     SNT, SND, ERR                           :               
 +       : From Date : 20210101 YYYYMMDD                           :               
 +       : To Date . : 20210101 YYYYMMDD                           :               
 +       : User ID . :                                             :               
 +       :                                                         :               
 +       : F12=Cancel                                              :               
 +       :                                                         :               
 +       :.........................................................:               
 +      09/29/2021 07:48:36 SNT     orlando@informdecisions.com                    
 +      09/29/2021 06:46:45 SNT     noreply@informdecisions.com                    
 +                                                                        More...  
 +                                                                                 
 +                                                                CONFIRM: N (Y/N) 
 +                                                                                 
 +                                                                                  
 +</pre></html> 
 +Fill in the desired Purge parameters and press **Enter**.  
 +Confirm with a **Y** and press **Enter** again to initiate the purge.  
 +   
 +Pressing the **F11** function key changes the current view of the logged messages to reveal more properties of logged email messages. Pressing the F11 once more reveals a third view of messages.
  
 <html><pre> <html><pre>
-  6/04/18                            iMail                            IMEMLOGC2 +  9/30/21                            iMail                            IMEMLOGC2 
  11:46:58                        iMail Send Log                       KKRAMER     11:46:58                        iMail Send Log                       KKRAMER   
                                                                                                                                                                  
Line 268: Line 379:
   PAGE:        1 /      790                                                        PAGE:        1 /      790                                                     
   F3=Exit   F5=Reload   F7=Find   F8=Purge   F11=Next view   F12=Previous          F3=Exit   F5=Reload   F7=Find   F8=Purge   F11=Next view   F12=Previous       
-  F17=Top  F18=Bottom                                                            +                                                                                  
-                                                                                +
 </pre></html> </pre></html>
  
-The screen below illustrates the forth view of emmail messages.+The screen below illustrates the fourth view of email messages.
  
 <html><pre> <html><pre>
-  6/04/18                            iMail                            IMEMLOGC2 +  9/30/21                            iMail                            IMEMLOGC2 
  11:48:04                        iMail Send Log                       KKRAMER     11:48:04                        iMail Send Log                       KKRAMER   
                                                                                                                                                                  
Line 297: Line 407:
   PAGE:        1 /      790                                                        PAGE:        1 /      790                                                     
   F3=Exit   F5=Reload   F7=Find   F8=Purge   F11=Next view   F12=Previous          F3=Exit   F5=Reload   F7=Find   F8=Purge   F11=Next view   F12=Previous       
-  F17=Top  F18=Bottom                                                            +                                                                                                                 
-                                                                                                                    +
 </pre></html> </pre></html>
  
  
-Lastly selecting any one entry from the list with an option 5, displays the details of the message sent with the recipients, and attachements.+Lastly selecting any one entry from the list with an option 5, displays the details of the message sent with the recipients, and attachments.
  
  
Line 325: Line 434:
       Attachment. . . : /imail/IDOCLASER398492000003.pdf                               Attachment. . . : /imail/IDOCLASER398492000003.pdf                        
                                                                                                                                                                  
-                                                                                 +                                                                               
-                                                                                                                                                                                                                                              +
  F3=Exit   F12=Cancel                                                            F3=Exit   F12=Cancel                                                          
 </pre></html> </pre></html>
 +**Note:** In 6.94 by default the logged email entries are no longer encrypted on the data base. To maintain the data base encryption of the log entries, set the Data Area DSLOGENCRY = ‘Y’ and emailed logging will be encrypted as in prior versions. 
  
 ==== Work with Users ==== ==== Work with Users ====
Line 342: Line 450:
  
 <html><pre> <html><pre>
-  6/03/18                            iMail                            IM0610C1   + 10/16/20                            iMail                            IM0610C1   
- 17:49:23                 Work with distribution list                 QSECOFR   + 11:49:23                 Work with distribution list                 QSECOFR   
                                                                                                                                                                  
  1=Select 4=Delete  5=View 6=Delete Name from List and all Distribution Groups    1=Select 4=Delete  5=View 6=Delete Name from List and all Distribution Groups  
  7=Selectively Delete Name from Distribution Groups  8=View Groups                               7=Selectively Delete Name from Distribution Groups  8=View Groups                             
                                        Current View: *PUBLIC address book                                               Current View: *PUBLIC address book       
-                                                                                 +    <font  color="#778899"><u>Able</u></font>_________________________  ______________________________________________                                                                             
-Sel Name                           iMail Address                                 +    Name                           iMail Address                                 
-    Able Adams                     able@adams.com                                +    Able Adams                     able@adams.com  
-    John Adams                     jadams@whitehouse.gov                         +    Alan Garske                    alan.garske@informdecisions.com                 
-    AA AAA                         AA@informdecisions.com                       +    Anh Nguyen                     anh@informdecisions.com
     BB                             bb@informdecisions.com                            BB                             bb@informdecisions.com                       
     Billy Barstow                  billy@barstow.com                                 Billy Barstow                  billy@barstow.com                            
-    George Bush                    gbush@whitehouse.gov                         +    Carl Bush                      cbush@aol.com                         
     Charlie Camareo                charlie@camareo.com                               Charlie Camareo                charlie@camareo.com                          
-    Bill Clinton                   bill@whitehouse.gov                           
     Daniel Durrango                DanielDurrango.com                               Daniel Durrango                DanielDurrango.com                          
     Eddie Eastwood                 eddie@eastwood.com                                Eddie Eastwood                 eddie@eastwood.com                           
     Frank Furter                   frank@furter.com                                  Frank Furter                   frank@furter.com                             
-    Alan Garske                    alan.garske@informdecisions.com               +    George Adams                   gadams@hotmail.com                             
-                                                                                +    Hillary Clinton                hclinton@popularvote.gov                                                                                
                                                                         More...                                                                          More... 
  F3=Exit  F6=Add  F9=Public/Private Address Book  F11=Sort by Email  F12=Cancel  F3=Exit  F6=Add  F9=Public/Private Address Book  F11=Sort by Email  F12=Cancel
Line 370: Line 477:
 **Option 8**=View Groups to see what group(s) this user is belong to. This makes it easier to see all the groups one individual belongs to in the address book. (V6.89+)\\ **Option 8**=View Groups to see what group(s) this user is belong to. This makes it easier to see all the groups one individual belongs to in the address book. (V6.89+)\\
 \\ \\
-**F9**=only those email addresses created by the current user will be displayed. Note that the user profile, EMAILUSER, is displayed above the list of private emails.+**F9**= only those email addresses created by the current user will be displayed. Note that the user profile, EMAILUSER, is displayed above the list of private emails. 
 +\\ 
 +**F11**= Toggles between 'Sort by Email' and 'Sort by Name'. 6.95+ provides a starting position by entering a string of characters on the starting line above the name or email address. Enter the starting point and Press F11.
  
 <html><pre>  <html><pre> 
pub/imail.1528390256.txt.gz · Last modified: 2022/06/25 17:02 (external edit)