Table of Contents
[ 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.96 11.30.20 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 More... Selection 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. . . . . . . . . . inFORMDecisions.com Organization Name. . . . . . . inFORM Decisions Email Send Method.(SMTP/ESMTP) SMTP SMTP Host Mail Server. . . . . 192.168.0.2 SMTP Port. . . . . . . . . . . 00025 Local Host Mail Client . . . . 192.168.0.82 Sender Address . . . . . . . . admin@yourdomain.com Default From Address . . . . . admin@yourdomain.com Default Reply To Address . . . admin@yourdomain.com 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. 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.
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.
- 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 ¯o_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 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 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 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.
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 restore it with the following command: RST DEV('/qsys.lib/currentiMaillibrary.lib/jarfiles.file') OBJ(('/qibm/userdata/java400/ext/ifdjava.jar'))
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:
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.
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.
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.
3/23/24 iMail IMEMLOGC1 13:35:38 iMail Send Log QSECOFR 4=Delete 5=Display 7=Resend 8=Mail log 9=Forward Mail 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 More... PAGE: 1 / 790 F3=Exit F5=Reload F7=Find F8=Purge F11=Next view F12=Previous
- 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)
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 keysParamaters:
- 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 PRGMAILLOG command to purge the email log file.
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)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.
9/30/21 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 noreply@informdecisions.com 06/04/2018 10:32:32 SNT noreply@informdecisions.com 06/04/2018 02:42:25 SNT noreply@informdecisions.com 06/04/2018 02:37:56 SNT noreply@informdecisions.com 06/04/2018 02:34:24 SNT noreply@informdecisions.com 06/04/2018 00:29:21 SNT noreply@informdecisions.com 06/01/2018 18:00:09 SNT 06/01/2018 17:59:35 SNT 06/01/2018 17:20:02 ERR noreply@informdecisions.com 06/01/2018 17:19:32 SNT noreply@informdecisions.com 06/01/2018 16:23:42 SNT noreply@informdecisions.com 06/01/2018 15:50:58 SNT noreply@informdecisions.com More... PAGE: 1 / 790 F3=Exit F5=Reload F7=Find F8=Purge F11=Next view F12=Previous
The screen below illustrates the fourth view of email messages.
9/30/21 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 More... PAGE: 1 / 790 F3=Exit F5=Reload F7=Find F8=Purge F11=Next view F12=Previous
Lastly selecting any one entry from the list with an option 5, displays the details of the message sent with the recipients, and attachments.
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. . . . . . : noreply@informdecisions.com To. . . . . . . : orlando@informdecisions.com CC. . . . . . . : Attachment. . . : /imail/IDOCLASER398492000003.pdf F3=Exit F12=CancelNote: 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
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 able@adams.com Alan Garske alan.garske@informdecisions.com Anh Nguyen anh@informdecisions.com BB bb@informdecisions.com Billy Barstow billy@barstow.com Carl Bush cbush@aol.com Charlie Camareo charlie@camareo.com Daniel Durrango DanielDurrango.com Eddie Eastwood eddie@eastwood.com Frank Furter frank@furter.com George Adams gadams@hotmail.com Hillary Clinton hclinton@popularvote.gov More... 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. . . .: able@adams.com 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 TEST Bottom 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 erick@informdecisions.com : : AbleAdams able@adams.com : : AddedGarske addedgarske@informdecisions.com : : Added Now addednow@informdecisions.com : : AlanGarske alan.garske@informdecisions.com : : AAAA AA@informdecisions.com : : BillClinton bill@whitehouse.gov : : BillyBarstow billy@barstow.com : : BB bb@informdecisions.com : : CharlieCamareo charlie@camareo.com : : DanielDurrango Daniel Durrango.com : : DavisYokana davis@informdecisions.com : : EddieEastwood eddie@eastwood.com : : FrankFurter frank@furter.com + : : 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.