User Tools

Site Tools


[ Up to Main Menu ][ [ Up To iMail ]

iMail Administration

If you are using iMail standalone, then add your iMail library to your library list. Otherwise, iMail is a menu option off the iDocs main menu.

The main iMail menu appears below:

 IMAIL                     iMail Menu  6.91  06.27.18                            
   iMail Administration                                                         
      1. Configure iMail                                 CFGMAIL                
      2. Work with Log                                   WRKMAILLOG             
      3. Work with Users                                 WRKMAILDST             
      4. Work with Groups                                WRKMAILGRP             
      5. Work with Administration                        WRKMAILADM             
   iMail Functions                                                              
     10. Work with Spooled Files                         WRKSPLINF              
     11. Send Database File                              SNDDBF                 
     12. Send Email Message                              SNDMAIL                
   Configure iMail Server                                                       
     21. Work with iMail Server                          WRKMAILSVR             
     22. Start iMail Server                              STRMAILSVR             
     23. End iMail Server                                ENDMAILSVR             
 F1=Help   F3=Exit   F12=Cancel                                                 
 © Copyright 1994, 2008 inFORM Decisions All Rights Reserved.                   

iMail Administration

The first menu group, iMail Administraion deals primarily with the setup, configuration and security of iMail.

Configure iMail

Selecting this option, and supplying the necessary protocols and defaults is required in order for iMail to function properly.

The screen below displays the current configuration settings.

 12/01/16                            iMail                           IMCFGC1   
 08:10:36             inFORM Decisions iMail Configuration           QSECOFR   
 Configuration Setting            Configuration Value                          
 Domain Name. . . . . . . . . .                          
 Organization Name. . . . . . .   inFORM Decisions                             
 Email Send Method.(SMTP/ESMTP)   SMTP                                         
 SMTP Host Mail Server. . . . .                                  
 SMTP Port. . . . . . . . . . .   00025                                        
 Local Host Mail Client . . . .                                 
 Sender Address . . . . . . . .                    
 Default From Address . . . . .                    
 Default Reply To Address . . .                    
 Authentication User Name . . .
 Authentication Password. . . . 
 Authentication Encrypted (Y/N)   N                                               
 Auto wrap message length . . .   1900                                         
 Force Socket End (*YES/*NO). .   *YES                                         
 Remove Over Printing (*YES/*NO)  *NO                                          
 Auto Recipient Domain (*YES/*NO  *NO                                          
 Log outgoing mail (ON/OFF) . .   ON                                           
                                                                       More. . .
F3=Exit   F10=Save   F12=Cancel   F13=Configure Environment  F14=2nd SMTP                    

The configuration settings above are detailed below with their defaults, options and requirements.

  • Domain Name- This is required setting containing your Local network domain name.
  • Organization Name - Your company name or organization is required in this setting.
  • Email Send Method - Entering either SMTP, Simple Mail Transfer Protocol or ESMTP, Enhanced Simple Mail Transfer Protocol are the two valid entries for this setting to define the protocol used by the email server. Typically, most internal mail servers use SMTP. Otherwise, if your organization uses an email service provider, this provider may use ESMTP which may require additional settings such as user authentication and passwords.
  • SMTP Host Mail Server - This required setting needs either the mail server host name or IP address of your mail server. Although either value may correctly be interpreted as valid, it is recommended that the host name be used. In this way, should the IP address change for the host name, the host name will still be valid, whereas the changing of the IP address for the mail server would result in failed mail delivery.
  • SMTP Port - This required setting's default value is 25 (00025), which is the protocol's standard port. Otherwise, change the setting to comply with the required port of your mail server. Note that leading zeros are required.
  • Local Host Mail Client - This optional setting contains your, System i IP address.
  • Sender Address - This optional setting contains the default email Address that will show as sender address. However, the default sender address will be overridden if the user is listed in the Public Distribution Directory from option 3 of the email menu.
  • 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.
  • Authentication User Name - 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.
  • 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.
  • Remove Over Printing (*YES/*NO) - This value controls whether or not overprinting from sent spooled files needs to be removed prior to being converted and delivered. Only in instances where converted spooled file would yield a distorted PDF file, would this value need to be changed from the default value of *NO to a value of *YES.
  • 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.
  • 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.

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 
F3=Exit   F10=Save   F12=Cancel   F13=Configure Environment   F14=2nd SMTP                    
Press enter to continue.                                                       

  • 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.
  • PDF Orientation - This configuration setting determines the orientation of the rendered PDF attachments. *PORTRAIT will force a portrait orientation; *LANDSCAPE will force a landscape orientation; *SYSDFT will derive the orientation from the original spooled file.
  • TLS/SSL Required - specify TLS, SSL or leave empty. TLS configures the transmission using transport layer security. SSL configures the transmission using SSL. Leaving they entry blank causes iMail to send emails without encryption.
  • Application id for certificate - Using TLS requires a certificate assigned to the iMail client. Specify its ID here. Otherwise leave this field blank. Certificates are managed through the Digital Certificate Manager; please refer to IBM documentation for more information on the DCM. The certificate that you want to install is that of the remote smtp host. You can capture that certificate using the Openssl command line tool. Man page for that tool is found at Openssl; a short example of its use can be seen at BVS Tools.
  • Use Java Mail (ON/OFF) - If ON will use JavaMail and Java APIs to send email. Javamail APIs support SMTP servers using TLS/SSL. If OFF (or blank) will use RPG APIs to send email. RPG APIs don't support SMTP servers using TLS/SSL. NOTE: Javamail could be a better choice because it supports modern mail servers and is Open Source, contributed to by a thousand programmers. The Java program runs on a Java Virtual Machine (JVM), and this machine interprets java code to machine code at run time so it takes a bit longer, but it is much more reliable than RPG mail.
  • iMail Batch Job Queue - Set the job queue which the batch processes of iMail programs will be submitted to.
  • 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.
  • 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:

Submit Process to Batch (YES/NO) - This field is YES will set the default value in Batch Mode of ESNDSPLFD to Y. This field is NO or blank will set the default value in Batch Mode of ESNDSPLFD to N. ESNDSPLFD is a convenient API command which programmers can embed it to their programs. This command can: Send an SCS spool file or merge SCS spool file with iDocs form/check/form set, then email output PCL.

Keep iMail Batch Log (YES/NO) - YES will keep the job log of iMail batch jobs and log CL commands. It is actually parameters in SBMJOB LOG(4 0 *MSG) LOGCLPGM(*YES) SPLFACN(*KEEP).

Run Java Mail in Batch (YES/NO) - Batch Mode = Y and Run Java Mail in Batch = Y: manual merge program (if FORMAPP is specified in command ESNDSPLFD) and iMail process are executed in same job of batch mode Batch Mode = N and Run Java Mail in Batch = Y: manual merge program (if FORMAPP is specified in command ESNDSPLFD) is executed in interactive mode and iMail process is executed in Batch mode Batch Mode = Y and Run Java Mail in Batch = N: manual merge program (if FORMAPP is specified in command ESNDSPLFD) and iMail process are executed in same job of batch mode Batch Mode = N and Run Java Mail in Batch = N: manual merge program (if FORMAPP is specified in command ESNDSPLFD) and iMail process are executed in same interactive job

Configure Environment

This environment setting is available to configure by selecting F13. Doing so renders the screen below:

  12/01/16                          iMail 6.91                      IM6000D1
 13:40:00                  iMail Control Maintenance                KKRAMER 
         System Information:                                               
         Serial Number. . .:  10AE7BC                                      
         Model Number . . .:  520                                          
         Logical Partition.: 000                                           
         OS version . . . .: V5R3M0                                        
         Maintenance Information:                                          
         Target IFS Directory: imail                                       
         Default Library. . .: IDOCS                                 
         Default Code Page. .: 819                                         
         DIF file Code Page .: 819                                         
         JAR Files Directory.:                                                                   
 F1=Help   F3=Exit   F10=Save   F12=Cancel                                 

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.
  • 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.
  • 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).
  • 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.

Note:You can check the existence of ifdjava.jar in /QIBM/UserData/Java400/ext with the command: 
WRKLNK ‘/QIBM/UserData/Java400/ext/ifdjava.jar’.
If the JAR file is missing from your system, you can reatore it with the following command: RST DEV('/qsys.lib/currentiMaillibrary.lib/jarfiles.file') OBJ(('/qibm/userdata/java400/ext/ifdjava.jar'))

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:

 8/16/18                          iMail                              IM4300R1  
 11:52:30                  Secondary SMTP Settings                    KKRAMER   
 Method (SMTP/ESMTP). : SMTP                                                    
 SMTP name. . . . . . :                                        
 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.              

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.

Miscellaneous iMail Settings

The majority of the configurable user setttings have a corresponding user interface from which to change these settings. The same is not true of others. Forturnately, the number of settings lacking a user interface are few, and the need to change these settings are limited.

These configurations are controlled through data areas. The data areas themselves may be changed with the OS command change data area, CHGDTAAARA followed by the data area name.

The following lists these data areas, their meaning, and their possible settings:

  • DSDIFHDR - This controls the heading associated with a field, when a data base is converted to a DIF file. The field headings may either display the field name, or the column heading associated with the field. The possible values associated with this value are: 'Y' and 'N'. If the value is set to 'Y', then the field description will be used, otherwise the field name is used in the column heading.
  • DSORIENT - This data area controls the orientation of resulting spooled files converted from *SCS to PDF format. The possible values of this data area, are *PORTRAIT, *LANDSCAPE, and *SYSDFT. Should the data area contain either *PORTRAIT or *LANDSCAPE, the spooled files convert to PDF will conform to the orientation contained in the data area. Should the data area value contain *SYSDFT, then the PDF will conform to the orientation of the original system spooled file.

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.

  6/03/18                            iMail                            IMEMLOGC1  
 13:35:38                        iMail Send Log                       QSECOFR   
  4=Delete   5=Display   7=Resend   8=Mail log 

 Opt  Date       Time     Sts     Subject                                       
      06/05/17   21:48:54 Sent    Test Subject                                  
      06/05/17   21:48:37 Sent    Test Subject                                  
      06/05/17   21:45:45 Sent    No toaddress                                  
      05/27/17   17:33:25 Sent    CLLE ESNDSPLF Testing 6 of 6                  
      05/27/17   17:33:19 Sent    CLLE ESNDSPLF Testing 5 of 6                  
      05/27/17   17:33:13 Sent    CLLE ESNDSPLF Testing 4 of 6                  
      05/27/17   17:33:07 Sent    CLLE ESNDSPLF Testing 3 of 6                  
      05/27/17   17:33:02 Sent    CLLE ESNDSPLF Testing 2 of 6                  
      05/27/17   17:32:56 Sent    CLLE ESNDSPLF Testing 1 of 6                  
      05/27/17   17:32:51 Sent    ESNDMSG Test 6 of 6 wrapping at 78 Characte   
      05/27/17   17:32:50 Sent    ESNDMSG Test 5 of 6 wrapping at 78 Characte   
      05/27/17   17:32:49 Sent    ESNDMSG Test 4 of 6 wrapping at 78 Characte   
PAGE:        1 /      790                                                    
F3=Exit   F5=Reload   F7=Find   F8=Purge   F11=Next view   F12=Previous 
F17=Top  F18=Bottom    

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.

  6/04/18                            iMail                            IMEMLOGC2 
 11:46:58                        iMail Send Log                       KKRAMER   
  4=Delete   5=Display   7=Resend                                               
 Opt  Date       Time     Sts     From Address                                  
      06/04/2018 10:59:12 SNT                   
      06/04/2018 10:32:32 SNT                   
      06/04/2018 02:42:25 SNT                   
      06/04/2018 02:37:56 SNT                   
      06/04/2018 02:34:24 SNT                   
      06/04/2018 00:29:21 SNT                   
      06/01/2018 18:00:09 SNT                                                   
      06/01/2018 17:59:35 SNT                                                   
      06/01/2018 17:20:02 ERR                   
      06/01/2018 17:19:32 SNT                   
      06/01/2018 16:23:42 SNT                   
      06/01/2018 15:50:58 SNT                   
  PAGE:        1 /      790                                                     
  F3=Exit   F5=Reload   F7=Find   F8=Purge   F11=Next view   F12=Previous       
  F17=Top  F18=Bottom                                                           

The screen below illustrates the forth view of emmail messages.

  6/04/18                            iMail                            IMEMLOGC2 
 11:48:04                        iMail Send Log                       KKRAMER   
  4=Delete   5=Display   7=Resend                                               
                                  ------------ Job -----------                  
 Opt  Date       Time     Sts     Name       User       Number                  
      06/04/2018 10:59:12 SNT     QPADEV000B OFERRER    398492                  
      06/04/2018 10:32:32 SNT     QPADEV000B OFERRER    398492                  
      06/04/2018 02:42:25 SNT     TTRANA0    TTRAN      398456                  
      06/04/2018 02:37:56 SNT     TTRANA0    TTRAN      398456                  
      06/04/2018 02:34:24 SNT     TTRANA0    TTRAN      398456                  
      06/04/2018 00:29:21 SNT     TTRANC0    TTRAN      398440                  
      06/01/2018 18:00:09 SNT     OUTASXLS   OFERRER    398301                  
      06/01/2018 17:59:35 SNT     OUTASPDF   OFERRER    398300                  
      06/01/2018 17:20:02 ERR     QPADEV000B OFERRER    397938                  
      06/01/2018 17:19:32 SNT     QPADEV000B OFERRER    397938                  
      06/01/2018 16:23:42 SNT     QPADEV000B OFERRER    397938                  
      06/01/2018 15:50:58 SNT     QPADEV000B OFERRER    397938                  
  PAGE:        1 /      790                                                     
  F3=Exit   F5=Reload   F7=Find   F8=Purge   F11=Next view   F12=Previous       
  F17=Top  F18=Bottom                                                           

Lastly selecting any one entry from the list with an option 5, displays the details of the message sent with the recipients, and attachements.

  6/04/18                            iMail                            IMEMLOGC6 
 11:43:56                        iMail Send Log                       KKRAMER   
      Message Details                                                           
      Send Date & Time: 06/04/2018  10:59:12                                    
      Status. . . . . : SNT                                                     
      Message ID. . . : 201806041059123290000000                                
      Sending Job . . : QPADEV000BOFERRER   398492                              
      Subject . . . . : test ASITEST2                                           
      From. . . . . . :                             
      To. . . . . . . :                             
      CC. . . . . . . :                                                         
      Attachment. . . : /imail/IDOCLASER398492000003.pdf                        
 F3=Exit   F12=Cancel                                                          
Note: In 6.94 by default the logged email entries are no longer encrypted on the data base. To maintain the data base enycription of the log entries, set the Data Area DSLOGENCRY = ‘Y’ and emailed logging will be encrypted as in prior versions.

Work with Users

Option 3 from the iMail menu allows two tables of email contacts to be created and maintained. The initial table of email contacts lists all the public addresses. That is, the email addresses are shared among all users on the system. The optional table of email contacts lists all the private email addresses created by the user currently logged into the session. In this way, a user can create their own list of email address for their own use without making these email address public to other users.

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.

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.

 10/16/20                            iMail                            IM0610C1  
 11:49:23                 Work with distribution list                 QSECOFR   
 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                             
                                       Current View: *PUBLIC address book       
    Able_________________________  ______________________________________________                                                                            
    Name                           iMail Address                                
    Able Adams            
    Alan Garske                          
    Anh Nguyen           
    Billy Barstow                                    
    Carl Bush                                     
    Charlie Camareo                                
    Daniel Durrango                                
    Eddie Eastwood                                  
    Frank Furter                                      
    George Adams                                     
    Hillary Clinton                                                                                      
 F3=Exit  F6=Add  F9=Public/Private Address Book  F11=Sort by Email  F12=Cancel
 Press enter to continue.                                                       

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.
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.

 4/01/18                            iMail                            IM0610S2
17:50:14                 Work with distribution list                 QSECOFR 
      First Name. .: Able                                             
      Last Name . .: Adams                                            
      Display Name.: Able Adams                                       
      E-Mail. . . .:                                   
      Nickname. . .: AbleA                                                 
      Attach Type .: *PDF        F4=List                              
      Work Number .:                                                  
      Home Number .:                                                  
      Fax Number. .:                                                  
      Pager Number.:                                                  
      Cell Number .:                                                  
      User Profile.:             F4=List                              
 F3=Exit   F10=Update   F12=Previous                                         

An entry is selected to edit with an option 1, and the preceeding screen will be displayed, and may used to enter in the detailed information associated with a user.

User Profile - when the IBM i user profile is assigned to this field and the user is logged in to IBM i, iMail will use the user's email address as the From address overriding any Default From Address in iMail. Use with caution as a From Address isn't allowed if using Outlook 365.

Work with Groups

Note: In all instances, the stored Group Name should not contain any spaces or special characters.

 6/23/07                          iMail 3.0                          IM0650C1  
17:52:31                Work with Distribution Groups                QSECOFR   
                    Current View: *PUBLIC address book                         
 1=Select   3=Copy   4=Delete   7=Rename                                       
Sel  Group Name                 Description                                    
F3=Exit   F6=Add   F12=Cancel                                                  
Press enter to continue.                                                       

  6/23/07                          iMail 3.0                          IM0650C3  
 17:53:50                Work with Distribution Groups                QSECOFR   
                     Current View:                                              
  1=Select  4=Delete                                                            
   Group Name . . . .: TEST                                                     
   Group Description.: Test Group                                               
Sel Name                                 E-Mail Address                         
 F3=Exit   F6=Add   F12=Cancel                                                  

 6/23/07                          iMail 3.0                         IM0650S5 
17:55:33                Work with Distribution Groups               QSECOFR  
 Group. . . : TEST                                                           
 Description: Teset                                                          
 Display Name . . :                                                          
 Email Address. . :                                                          
F3=Exit   F4=Search   F10=Update   F12=Cancel                                

 6/23/07                          iMail 3.0                         IM0650S5   
:                                                                             :
:                  Last             First             iMail                   :
:       Position:                                                             :
: 1=Select                                                                    :
: Opt   Name                            iMail Address                         :
:    AATestLink                            :
:    AbleAdams                                        :
:    AddedGarske                     :
:    Added Now                          :
:    AlanGarske                      :
:    AAAA                                     :
:    BillClinton                                 :
:    BillyBarstow                                  :
:    BB                                       :
:    CharlieCamareo                              :
:    DanielDurrango            Daniel                            :
:    DavisYokana                           :
:    EddieEastwood                                :
:    FrankFurter                                  + :
:  F11=Filter   F12=Previous                                                  :
:                                                                             :

iMail Administration

This menu item 5 deals specifically with two types of administrative settings: numerous default settings within the iMail WRKSPLINF command and several access authorizations to WRKSPLINF functions.

Only the user profile QSECOFR has authority to select this option and change the default settings. If any other user attempts to change the settings, a message will appear notifying the user that proper authorization is necessary to update these settings.

For each of the following settings and defaults being set, the scope and impact of each setting will be explained in detail. All of these settings relate to the global use and authorization of the command WRKSPLINF. A future enhancement will provide a system that will enable individual user profiles specific access to the functions of WRKSPLINF. WRKSPLINF itself allows a user to select a spool file as an attachment in an email and determine the format of the spool.

Once chosen, the screen below should be displayed:

12/21/16                          iMail                            IM0700  
17:59:48                     iMail Administration                  QSECOFR 
Type information, press Enter.                                             
  Allow to use WRKSPLINF (Y/N)  . . : Y                                    
    Allow Selection by USER (Y/N) . : Y                                    
      Initial User to View. . . . . : *CURRENT     F4=List                 
      Allow Change USER  .  (Y/N) . : Y                                    
    Allow Selection by OUTQ (Y/N) . : Y                                    
      Initial OUTQ to View  . . . . : *ALL         F4=List                 
      Allow Change OUTQ  .  (Y/N) . : Y                                    
    Send type default   . . . . . . : *PDF         F4=List                 
    Allow change Send type (Y/N)  . : Y                                    
    Allow change From Address (Y/N) : Y                                    
  Allow to use SNDDBF (Y/N) . . . . : Y                                    
F3=Exit   F10=Save   F12=Cancel                                            

  • Allow to use WRKSPLINF – If this access authorization setting is Y access to the command WRKSPLINF is not restricted in any way. A setting of N restricts access to the command completely and all the remaining access settings below are rendered disabled regardless of their setting being enabled or disabled.
  • Allow selection by user – If the setting is Y, then the command WRKSPLINF will enable access to the F5 key to specify another users spool files to be displayed and accessed. The impact of allowing this setting to remain at the default value of Y, means simply that a user can send not only spool files that they themselves have created, but also any other spool files that another user has created. Your system administrator should be involved in establishing these settings, so as to not undermine any existing security settings on your System i.
  • Initial USER to View – Here either the current user spool files can be displayed or a specific user profile can be defined.
  • Allow change user - On the command WRKSPLINF, the function key F5 allows a user to toggle from processing spool files from a single out queue to processing spool files created by a specific user. Restricting access to a single out queue ensures that unauthorized access to another user’s spool files will be prohibited.
  • Allow selection by out queue - When set to Y, the WRKSPLINF command allows selection of spool files by out queue.
  • Initial Out Queue View – Should the option above be enabled, and selection by out queue is selected, then the default out queue displayed can be specified here.
  • Allow change out queue - This access setting controls whether the WRKSPLINF command will allow the out queue displayed to be changed from the initial out queue view specified above to another out queue. The impact of setting this value to Y again may undermine any existing security settings.
  • Send Type Default – When selecting a spool file as an attachment the default format of the spool file may be any one of the following: *HTML, *PDF, *TXT, *FCFC, and *PRTCTL. Which represent the formats Hypertext mark up language, rich text format, Acrobat reader format, text format, ANSI forms control characters format, and the printer control format respectively. The impact of this setting can affect performance. For example, sending a spool file as a *PDF format may take considerably more time than processing a spool file *FCFC format.
  • Allow change send type – This setting determines whether the Send Type Default may be changed from the current value another format.
  • Allow change from address – When this value is set to N, the default from address will be set with from email address defined in option 1, work with email configuration. This value may not be changed. When the value is set to Y, the default email address will appear and the user may override this value with another address.
  • Allow to use SNDDBF (Y/N) – Since security is a concern when sending and receiving attachments, iMail enables you to control whether or not physical files, and save files may be sent. Disabling this feature with an N, will inhibit both save files, and database files from being sent from the iSeries. Placing a Y in this value will enable this feature allowing save files to be sent, and physical files to be sent as in either Text format or Delimited Interchange Format.
pub/imail.txt · Last modified: 2020/10/16 20:27 by kkramer