Table of Contents
[ Up To iMail ]
iMail Application Servers
Like the iMail server, the iMail application server distributes spooled files. The shortcoming with the iMail server that is overcome by the iMail application server is that the iMail application server enables the user to not only designate the recipient of the email, but also the copied recipients, the blind-copied recipients, the subject, and the message body.
To this end an iMail application maintenance program is provided to enable the user to define all of these delivery options within a single iMail application. The Configure iMail Application Server menu appears below:
IMAIL iMail Menu 6.98 09.21.21
Configure iMail Application Server
31. Work with iMail Applications WRKMAILAPP
32. Work with iMail Application Server WRKAPPSSVR
33. Start iMail Application Server STRAPPSSVR
34. End iMail Application Server ENDAPPSSVR
Bottom
Selection
F1=Help F3=Exit F12=Cancel
Work with iMail Applications
Selecting option 31, Work with iMail Applications, evokes the maintenance program for iMail Applications.
9/21/21 iMail IM1000C1
12:05:31 iMail Server Applications KKRAMER
Type options, press Enter.
1=Select 3=Copy 4=Delete 7=Rename
Opt Application Description
IMAILAPP iMail Sample Application
MYEMAILAPP My First iMail Server App
TESTAPP Test Application
Bottom
F3=Exit F6=Add
Press enter to continue.
From this point, entering the F6 key will create a new application. Doing so will display the following entry screen.
9/21/21 iMail IM1000D7
12:37:24 iMail Server Application KKRAMER
Type choices, press Enter.
Application
Name Description
IMAILAPP iMail Sample Application
From . . . : noreply@informdecisions.com F4=List
To . . . . : tri@informdecisions.com F4=List F7=Group
CC . . . . : tritran82@yahoo.com F4=List F7=Group
Bc . . . . : F4=List F7=Group
Subject. . :
Attach Type: *XLS F4=List
F3=Exit F8=Message F10=Save F12=Cancel F13=Previous
Enter the application and description in the first entries, followed by the parameters for iMail. To and From can be prompted by F4 for a list of stored email addresses.
To make it quicker and simpler to use iMail as a report routing utility, there are also two special keywords for email targets:
*USRPRF This looks into the iMail address book for a user profile that matches the spool file owner, and then use the iMail address book email address as the target address. For the *USRPRF keyword, it uses the user ID of the spool file job for look up in iMail Group (item menu 4. Work with Groups), and if found then the group name will be used.
*SMTPNAME Takes the user profile of the spool file owner, retrieve the smtp address associated with that profile
in the system directory (the smtp name ), and use that email address as the target address.
Once completed, enter F10 to save the entries and continue. To specify a message use F8=Message and complete a detailed message in the screen below:
9/21/21 iMail IM1000D8
12:44:11 iMail Server Application KKRAMER
Message Text
This is a sample message generated from the iMail Application Server
F3=Exit F10=Save F12=Cancel F13=Previous
Work with iMail Application Server
Once the iMail applications have been created, these applications need to be incorporated in an iMail Application server. Selecting the next option, 32 enables data entry of these applications into an iMail Server.
4/16/24 IM2000C1
08:17:47 Server Maintenance QSECOFR
Type options, press Enter.
1=Select 3=Copy 4=Delete 7=Rename 8=Start 9=End
Opt Server Description
IMAPPSVR iMail Applications Server
MYEMAILSVR My Email Server
TESTSVR Test
Bottom
F3=Exit F6=Add
Press enter to continue.
After an existing application is selected with an option 1, or a new one is created with an F6 key the iMail Application Server configuration screen will appear accordingly.
4/16/24 IM2000C3
08:19:13 Server Maintenance QSECOFR
Server. . . . . . . . . . : IMAPPSVR Archive Out Queue. . . . : ARCOUTQ
Description: iMail Applications Server Library. . . . . . . . . : QGPL
Originating Spool Spool iMail
Library Out Queue Attribute Value Application
QGPL SRCOUTQ *FORMTYPE *STD IMAILAPP
More...
F3=Exit F4=Prompt F12=Previous F17= Top F18= Bottom
The following keywords for Spool Attribute are supported:
- *FORMTYPE tests the name of the form of the spool file.
- *JOBNAME tests the name of the job that created the spool file.
- *PRINTFILE tests the name of the printer file.
- *USERDATA tests the user data of the spool file.
- *USERNAME retrieves the user profile from the spooled file. Once extracted the value is compared to a matching user record in the public distribution list sending the spooled file to the user profile’s email address.
Note that the spellings differ from usage elsewhere in the iDocs Suite.
The format of the iMail Application Server is nearly identical to the iMail Server with one notable exception. This server enables you to identify the iMail Application used to process the qualified spooled file. All of the email specifications associated with the iMail Application will be used to route the deliver the spooled file.
Start Applications Server
Option 33 (Or Option 8 from the Server Maintenance screen) enables a specific iMail Applications Server to be start through a specific job queue. Choosing this option renders the entry screen below:
Start Applications Server (STRAPPSSVR)
Type choices, press Enter.
iMail Server . . . . . . . . . . Value, or F4 for list
iMail Job Queue . . . . . . . . QBATCH Character value
Re-process RDY spool file . . . N Y, N
Bottom
F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display
F24=More keys
Enter the iMail Applications server, or prompt for a selection of available iMail Server Applications and select from the valid list. Next to the prompt for the iMail Job Queue, enter the specific job queue used to route the iMail Applications Server.
Enter a Y to re-process RDY spool files. Default is N. Added on Revision iDOCS 8.0 04/09/24.
Benefits: If 'Y“, after starting the engine, the administrator does not need to refresh the spool files alreading existing the the monitored output queue in *RDY status.
Behavior when starting the iMail Server:
When “Re-process RDY spool file” is set to 'Y'
- The server will process spool files in RDY status already in the out queue being monitored.
When “Re-process RDY spool file” is set to 'N'
- The server will only process spool files freshly introduced in *RDY status.
NOTE: To utilize this function in a job scheduled entry use the following command to run:
CALL PGM(iMail-library/IMC3000) PARM('iMail-server-name' ‘Job queue name’)
End iMail Applications Server
Option 34, allows a previously started iMail Application server to be ended. Selecting this item renders the screen below, prompting for the name of the server to end.
End iMail Server (ENDAPPSSVR)
Type choices, press Enter.
iMail Server . . . . . . . . . . Value, or F4 for list
NOTE: To utilize this function in a job scheduled entry use the following command to run:
CALL PGM(iMail-library/IMR4000) PARM('Appl-server-name')
[ Up To Index ]