Mail Blast/400 -...

24
Mail Blast/400 Copyright © 1992-2002 ... RJS Software Systems Inc. User Guide RJS Software Systems Inc. 14041 Burnhaven Drive, Suite 120 Burnsville, MN 55337 Phn: (952) 898-3038 Fax: (952) 898-1781 Sales Email: [email protected] Support Email: [email protected] Web Site: http://www.rjssoftware.com

Transcript of Mail Blast/400 -...

Page 1: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/400Copyright © 1992-2002 ... RJS Software Systems Inc.

User Guide

RJS Software Systems Inc. 14041 Burnhaven Drive, Suite 120

Burnsville, MN 55337

Phn: (952) 898-3038Fax: (952) 898-1781

Sales Email: [email protected] Email: [email protected]

Web Site: http://www.rjssoftware.com

Page 2: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Table of ContentsPart I Mail Blast/400 2

................................................................................................................................... 21 Overview .......................................................................................................................................................... 2Introduction to Mail Blast/400

.......................................................................................................................................................... 2About RJS Software Systems, Inc.

.......................................................................................................................................................... 2Licensing Information

.......................................................................................................................................................... 3Contacting RJS Software Systems, Inc.

................................................................................................................................... 32 Installation .......................................................................................................................................................... 3Introduction to Installation .......................................................................................................................................................... 3AS/400 Prerequisites

.......................................................................................................................................................... 3AS/400 Installation

.......................................................................................................................................................... 4AS/400 User Authorization Code Entry

.......................................................................................................................................................... 4Deinstallation of Mail Blast/400

................................................................................................................................... 43 Getting Started .......................................................................................................................................................... 4Introduction to Getting Started .......................................................................................................................................................... 4Installing the Mail Blast/400 Software .......................................................................................................................................................... 4Overview of Mail Blast/400 Software

.......................................................................................................................................................... 5General Overview of Mail Blast Process

.......................................................................................................................................................... 5First Steps - Creating your first mail merge letter template

.......................................................................................................................................................... 7Mail merge template database substitution keywords

.......................................................................................................................................................... 8Creating entries in the Name and Address File

.......................................................................................................................................................... 9Setting the Default From Email Address .......................................................................................................................................................... 10Setting the Default SMTP Host Setting .......................................................................................................................................................... 11Running Mail Blast processing interactively .......................................................................................................................................................... 15What's Next After Getting Started?

................................................................................................................................... 154 Main Menu .......................................................................................................................................................... 15Introduction to Main Menu .......................................................................................................................................................... 15Getting to the Main Menu

.......................................................................................................................................................... 16Available Options on the Main Menu

................................................................................................................................... 175 AS/400 Commands .......................................................................................................................................................... 17Introduction to AS/400 Commands .......................................................................................................................................................... 17BLMPROCESS: Run Mail Blast Processing .......................................................................................................................................................... 20BLMRESET: Reset Processed Address Flags .......................................................................................................................................................... 21BLMHOST: Set Default SMTP Host

.......................................................................................................................................................... 22BLMFROM: Set Default From Address

................................................................................................................................... 236 Problem Handling .......................................................................................................................................................... 23Common Errors .......................................................................................................................................................... 23Other Errors

Index 0

Mail Blast/400I

Copyright © 1992-2002 ... RJS Software Systems Inc.

Page 3: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/400 2

Copyright © 1992-2002 ... RJS Software Systems Inc.

1 Mail Blast/400

1.1 Overview

1.1.1 Introduction to Mail Blast/400

Mail Blast/400 is an automated email product for the AS/400 - iSeries which allows broadcast emailmessages to be sent to prospects and customers in an automated fashion.

Mail Blast/400 is a great way to keep in touch with your customers and send them current marketinginformation, literature, newsletters and more.

The Mail Blast/400 software allows pre-defined letter templates to be created with embeddedkeywords that allow Mail Blast letters to be personalized as they are mailed out.

Up to ten file pre-defined file attachments can also be sent along with each email message. Theattachments can be sent in compressed (ZIP) or uncompressed format.

Multiple name and address databases can be maintained to allow for several different mailing lists tobe created for custom blast emailings.

Email messages are sent via any SMTP mail server such as MS Exchange, Lotus Domino, etc. TheAS/400 SMTP server can be used, but is not required.

Make sure to tell us how you're going to use our software. Your ideas are what keep our productsgrowing.

1.1.2 About RJS Software Systems, Inc.

RJS Software is a privately-held software and hardware company dedicated to providing high-qualityAS/400 - iSeries, Client/Server and web-based products and customer services. Customer Service iscentral to the company's objective. Read more about us on our web site.

Copyright© 1992-2002 by RJS Software Systems Inc. All rights reserved.This manual and the softwaredescribed in it are copyrighted with all rights reserved. No part of this publication may be reproduced,transmitted, transcribed, stored in a retrieval system or translated into any language in any form byany means without the written permission of RJS Software Systems.

TrademarksMail Blast/400 is a trademark of RJS Software Systems. Brand names and product names aretrademarks or registered trademarks of their respective companies.

1.1.3 Licensing Information

Mail Blast/400 is licensed on a per AS/400 system partition basis.

Page 4: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/4003

Copyright © 1992-2002 ... RJS Software Systems Inc.

1.1.4 Contacting RJS Software Systems, Inc.

For technical support, please review the following information before contacting RJS SoftwareSystems.

For Technical Support with Mail Blast/400Because of the complexity of dealing with the various AS/400 connectivity environments, pleasegather and organize as much information as possible on the problem prior to contacting RJS SoftwareSystems for support.

If you have a question about an Mail Blast/400 operation, first browse through the Online Help to tryto find your answer prior to calling RJS Software Systems.

Contact InformationTelephone support is available on normal business days from 9:00 am to 5:00 pm central time.(952) 898-3038 Voice(952) 898-3038 Fax

Support is available via Email at [email protected].

You may also find the answer to your question on our web site: www.rjssoftware.com.

1.2 Installation

1.2.1 Introduction to Installation

This section covers the installation of the Mail Blast/400 software on the AS/400 system.

1.2.2 AS/400 Prerequisites

A RISC AS/400 system running V4R2-V5R2 or above is required to run the software.

TCP/IP connectivity must be enabled. If TCP/IP is not active, the software will not work.

Access to an SMTP mail server such as MS Exchange, Lotus Domino or any other valid SMTPserver is required to deliver mail messages.

If you're not sure whether you have an SMTP mail server running, contact RJS Software Systems forassistance.

1.2.3 AS/400 Installation

This section includes instructions for restoring the Mail Blast/400 AS/400 library.

AS/400 Installation Using RSTLIB commandInsert the RJS CD into the AS/400 CD Drive and sign on to the AS/400 with a user ID that hassecurity officer authority.

Run the following AS/400 command to restore the Mail Blast/400 library:RSTLIB SAVLIB(RJSBLAST) DEV(OPT01) OPTFILE('/RJSBLAST')

AS/400 Installation Using FTPThis method of installation is described in the RJS Product Catalog and also on the RJS SoftwareSystems installation screen on the RJS CD-ROM.

Page 5: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/400 4

Copyright © 1992-2002 ... RJS Software Systems Inc.

Note: All web download packages contain an automated FTP upload utility.

1.2.4 AS/400 User Authorization Code Entry

Sign on to the AS/400 with a user ID that has security officer authority.

Entering Mail Blast/400 Access CodeAdd the RJSOFFICE library to the user library list by typing: ADDLIBLE RJSBLAST and pressingEnter

Go to the Mail Blast/400 main menu by typing: GO RJSBLAST and pressing Enter.

Take option 1 and enter the appropriate access codes listed on the access code sheet provided byRJS Software Systems.

If you have questions or problems with entering the access codes, contact RJS Software Systemsfor assistance.

1.2.5 Deinstallation of Mail Blast/400

The following sections describe how to remove the Mail Blast/400 from an AS/400 system.

Removing Mail Blast/400 from an AS/400To remove Mail Blast/400from an AS/400, perform the following individual steps.

Make sure the RJSBLAST library is not being used.

Delete the RJSBLAST library from the AS/400 by entering the following command:DLTLIB LIB(RJSBLAST)

1.3 Getting Started

1.3.1 Introduction to Getting Started

The purpose of this section is to describe how to quickly get started using the Mail Blast/400 softwareto start sending mass emails from your AS/400 applications.

1.3.2 Installing the Mail Blast/400 Software

If you haven't installed the software yet, go back to the installation section and install the softwarebefore continuing. If you're just reading ahead to find out what to do, then please continue.

1.3.3 Overview of Mail Blast/400 Software

Mail Blast/400 is an automated email product for the AS/400 - iSeries which allows broadcast emailmessages to be sent to prospects and customers in an automated fashion.

Mail Blast/400 is a great way to keep in touch with your customers and send them current marketinginformation, literature, newsletters and more.

The Mail Blast/400 software allows pre-defined letter templates to be created with embeddedkeywords that allow Mail Blast letters to be personalized as they are mailed out.

Up to ten file pre-defined file attachments can also be sent along with each email message. The

Page 6: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/4005

Copyright © 1992-2002 ... RJS Software Systems Inc.

attachments can be sent in compressed (ZIP) or uncompressed format.

Multiple name and address databases can be maintained to allow for several different mailing lists tobe created for custom blast emailings.

Email messages are sent via any SMTP mail server such as MS Exchange, Lotus Domino, etc. TheAS/400 SMTP server can be used, but is not required.

Make sure to tell us how you're going to use our software. Your ideas are what keep our productsgrowing.

1.3.4 General Overview of Mail Blast Process

A blast email campaign will generally consist of the following steps:

• A new email message template will get created. If personalization is required, the special@KEYWORDS can be used as described in the Mail merge template database substitutionkeywords section.

• If any PC file attachments will be sent, they will need to be copied to an IFS folder on the AS/400.

• Email addresses must be manually or programatically entered into the BLMADR00 file or a copy ofthe file.

• The BLMPROCESS command will be run specifying the email message template, emailname/address file and up to 10 file attachments to send. Each email recipient will receive a copy ofthe selected letter and file attachments. After a recipient is mailed to, the processed flag is set fortheir address and must be reset prior to the next email process. Note: file attachments are notrequired for text-only messages.

1.3.5 First Steps - Creating your first mail merge letter template

Before you can send a Mail Blast/400 email message, you must create a template. The lettertemplate can include plain text as well as special keywords which can automatically substituteinformation such as into each outbound email based on information within the Mail Blast/400 nameand address file.

Steps to create a letter templateSign on to the AS/400 system and add the RJSBLAST library to your library list by using the followingAS/400 command: ADDLIBLE RJSBLAST.

1.) Go to the Mail Blast/400 menu (GO RJSBLAST) and select menu option 5, Edit Email MessageTemplates.

The template entry list screen will be shown.

Page 7: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/400 6

Copyright © 1992-2002 ... RJS Software Systems Inc.

Mail Blast/400 Email Message Template Entry List

2.) Press F6 to create a new message member, use option 1 to edit an existing message template oruse option 4 to delete an existing message template.

Page 8: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/4007

Copyright © 1992-2002 ... RJS Software Systems Inc.

Creating or Editing a Message Template

3.) Type the description and message text for the new template.

The message description will be automatically used as the email subject line when the template isused for mailing.

The message text can currently have up to 500 lines of text, including blank lines.

Use the page keys to page through the email template.

4.) When finished entering text information in the mail merge template, press F12 to save thetemplate.

Congratulations. Your first letter template is now ready to use.

1.3.6 Mail merge template database substitution keywords

The following name/address database keywords can be inserted anywhere in the message text andthe appropriate values will get substituted into the message at runtime from the selected name andaddress file:

@EFCOMP - Company (Company Name)@EFNAM - Agent Name (Can be used for anything)@EFIRST - First Name (Recipient first name)@ELAST - Last name (Recipient last name)@EADDR - Email Address@EBDNM - Broker/Dealer Name (Can be used for anything)

Page 9: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/400 8

Copyright © 1992-2002 ... RJS Software Systems Inc.

@ESAL - Salutation (Mr,Mrs, Ms, etc.)@ETITLE - Title (President, Vice President, etc.)@EVAR1 - User variable field 1 (Can be used for anything)@EVAR2 - User variable field 2 (Can be used for anything)@EVAR3 - User variable field 3 (Can be used for anything)@EVAR4 - User variable field 4 (Can be used for anything)@EVAR5 - User variable field 5 (Can be used for anything)

1.3.7 Creating entries in the Name and Address File

From the Mail Blast/400 menu (GO RJSBLAST), select Option 6, Edit Mail Blast Name/AddressFile.

This option can be used to edit an existing name/address file. The default AS/400 file name is:BLMADR00 in library RJSBLAST.

Note: The DDS for this file can be found in the source file: SOURCE in library BLMADR00. You cancreate as many copies of this file as needed to accomodate multiple mailing lists.

Edit Mail Blast Name/Address File List Screen

Press F6 to create a new name/address record or, use option 2 to edit an existing address record,option 5 to display an existing record or option 4 to delete an existing record.

Page 10: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/4009

Copyright © 1992-2002 ... RJS Software Systems Inc.

Edit Mail Blast Name/Address File Detail Screen

Enter the information for the new name/address record and press Enter to save the record or F12 tocancel and goback to the name/address list screen.

The activated setting must be set to (Y)es, otherwise the new name/address will not be used duringprocessing.

Note: Do not enter anything in the processed flag field. This is used by the Mail Blast/400 processing.

Make sure to enter a few name/address records for your first Mail Blast test run.

1.3.8 Setting the Default From Email Address

Before sending email via Mail Blast/400 a default from address must be set. If a mail bounces backduring processing, the default from email address will receive a copy of the bounced back message.

From the Mail Blast/400 menu (GO RJSBLAST), select Option 21, Set Default From Address.

Page 11: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/400 10

Copyright © 1992-2002 ... RJS Software Systems Inc.

Setting Default From Address

Enter the following parameters:

Option*SET

Default from email addressSet to a valid email address such as [email protected]

Press Enter to set the Default From Address

Note: This setting can be overridden at run time on the BLMPROCESS command.

1.3.9 Setting the Default SMTP Host Setting

Before sending email via Mail Blast/400 a default SMTP mail server host name must be set. Thisvalue should point to a valid DNS host name or a name created in the AS/400 host table (GOCFGTCP, option 10) that points to a valid IP address where the SMTP server is located.

Note: Do not enter an IP address in this setting. Only use a valid host name.

From the Mail Blast/400 menu (GO RJSBLAST), select Option 20, Set Default SMTP Host.

Page 12: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/40011

Copyright © 1992-2002 ... RJS Software Systems Inc.

Setting Default SMTP Host

Enter the following parameters:

Option*SET

Outbound SMTP mail serverSet to a valid DNS entry or host name pointing to a SMTP mail server. In this example we have anAS/400 host entry named RJS1 which points to an internal SMTP server.

Press Enter to set the Default SMTP Host

Note: This setting can be overridden at run time on the BLMPROCESS command.

1.3.10 Running Mail Blast processing interactively

This step runs the actual email processing using a selected message template, up to 10 PC fileattachments from the AS/400 IFS and the selected name/address file.

Note: This command will typically be run in batch mode. Multiple copies of BLMPROCESS can besubmitted to allow multiple jobs to be processing the same name/address list at the same time. Evenif multiple jobs are processing the list at the same time, only one email will get sent to each recipient.Running multiple BLMPROCESS jobs can improve performance when sending emails to large lists bybalancing the load between multiple AS/400 jobs.

From the Mail Blast/400 menu (GO RJSBLAST), select Option 10, Run Mail Blast ProcessingInteractively

Page 13: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/400 12

Copyright © 1992-2002 ... RJS Software Systems Inc.

The Mail Blast/400 processing command BLMPROCESS will be prompted.

Mail Blast/400 processing prompt 1 - BLMPROCESS

Page 14: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/40013

Copyright © 1992-2002 ... RJS Software Systems Inc.

Mail Blast/400 processing prompt 2 - BLMPROCESS

Mail Blast/400 processing prompt 3 - BLMPROCESS

Enter the parameters as listed below for this first test run:

Mail Blast Name/Address FileThis is the Name/Address file which will get processed. Default: BLMADR00. A member name must beselected.

Enter *FIRST which will use the first and only name/address file member in the BLMADR00 file.

Mail Blast Template Msg FileThis is the selected message template member which will be processed. A message template membername must be selected.

Enter the mamber name for your message template.

Example: M000000001

From email addressThis is the email address where the email messages are originating from and will bounce back to ifundeliverable. This should be set to a valid system administrator email address in your email system.

Leave *DEFAULT in the parameter so the default from address is used.

SubjectThis is the subject of the email.

If *TEMPLATEDESC is used, the email message template description is used as the email subject

Page 15: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/400 14

Copyright © 1992-2002 ... RJS Software Systems Inc.

line.

SMTP server nameThis is the SMTP server where all outgoing email messages will be forwarded to for delivery. If youuse LOCALHOST for this entry, the local AS/400 SMTP server or Domino Server will be used. A hostname should always be used, not an IP address. A host name can be set up for a SMTP server fromthe following menu: (GO CFGTCP, option 10)

*DEFAULT will use the default SMTP server setting.

Mime content typeTypically the default value of 'text/plain' should be used, however if messages will be formatted asHTML, 'text/html' can be used.

Attachment file 1 - 10These are the IFS attachments which will be sent out with the selected email message templates ifspecified. This is a good way to distribute documents to a number of users at the same time.

If PC document files are stored in AS/400 shared folders, /QDLS must be appended to the file path,so the documents can be found in the appropriate shared folder. If documents are placed in a regularIFS folder, the forward slash must always be appended to the path (/).

IFS File Example: /DOCS/DOC1.PDF refers to a file named DOC1.PDF in the DOCS IFS folder.

QDLS Example: /QDLS/DOCS/DOC1.PDF refers to a file named DOC1.PDF in the DOCS folder inthe QDLS shared folders.

Note: It is not required to send file attachments when mailing. They will only be sent if specified. Eachrecipient receives a copy of the same file attachments if sending files along with the main message.

Zip attachment filesWhen this setting is enabled, all attachment files are zipped before mailing.

Delivery confirmation requestA delivery confirmation request will be sent with each email message. An email will be returned to thesender after the mail is delivered.

Note: This setting may not always work. It's dependent on the recipients email system allowingconfirmation requests to be requested.

Read confirmation requestA read confirmation request will be sent with each email message. An email will be returned to thesender after the mail is read.

Note: This setting may not always work. It's dependent on the recipients email system allowingconfirmation requests to be requested.

High priority requestThis email message will be sent with a high priority flag so it shows up as a high priority messagewhen delivered.

Page 16: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/40015

Copyright © 1992-2002 ... RJS Software Systems Inc.

1.3.11 What's Next After Getting Started?

You should now have the basics down for creating and sending Mail Blast/400 letter templates to aname and address list.

The next few sections are a reference for each of the Mail Blast/400 commands and availableparameters.

If there's something you would like to see covered in more detail or you have enhancementsuggestions, feel free to email RJS Software Systems with your suggestions. Send suggestions to:[email protected]

1.4 Main Menu

1.4.1 Introduction to Main Menu

This section gives an overview of the Mail Blast/400 main menu and the available options.

Mail Blast/400 Main Menu

1.4.2 Getting to the Main Menu

Sign on to the AS/400 system and add the RJSBLAST library to your library list using the followingAS/400 command: ADDLIBLE RJSBLAST

Next type: GO RJSBLAST and press Enter. This will take you to the Mail Blast/400 main menu.

Page 17: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/400 16

Copyright © 1992-2002 ... RJS Software Systems Inc.

1.4.3 Available Options on the Main Menu

Option 1 - Enter Mail Blast/400 License CodeThis menu option is used to enter the AS/400 access code for the Mail Blast/400 software. Anaccess code will be provided to you by RJS Software Systems Inc.

Option 5 - Edit Email Message TemplatesThis menu option is used to enter or change message templates for blast email campaigns. Once atemplate is created it can be used for subsequent emailings.

Option 6 - Edit Mail Blast Name/Address FileThis option can be used to edit an existing name/address file. The default AS/400 Name and Addressfile name is: BLMADR00.

Option 7 - Reset Processed Status for Email Names/AddressesThis step should be run after a mass-emailing has been completed and before the next mass-emailingis done using the same name/address file.

Option 10 - Run Mail Blast Processing Interactively - BLMPROCESSThis option can be used to run the Blast Mail Processing (BLMPROCESS) interactively for a selectedemail address list using the selected letter template and optional file attachments.

Option 11 - Submit Mail Blast Processing to BatchThis option can be used to run the Blast Mail Processing (BLMPROCESS) as a batch job.

Option 12 - Display Mail Blast Log EntriesThis option can be used to display the log entries showing which emails were sent.

Option 13 - Clear Mail Blast Log EntriesThis option can be used to clear the Mail Blast/400 log file.

Option 20 - Set Default SMTP Host - BLMHOSTThis option can be used to set the SMTP email host which will be used for mailing reports

Option 21 - Set Default From Address - BLMFROMThis option can be used to set the default SMTP From email address for a Mail Blast campaign.

Option 22 - Set Default ZIP File Extension - BLMZIPEXTThis option can be used to set the default zip compression file extension to something other than .ZIPif required.

Option 23 - Set Default SMTP Port - BLMPORTThis option can be used to set the default SMTP mail TCP/IP port to use. Normally this setting shouldbe left set to 25 which is the standard SMTP mail port.

Option 24 - Set Default SMTP Buffer Size - BLMBUFFERThis option can be used to set the default SMTP TCP/IP data buffer size. Normally this setting shouldnot be changed.

Option 30 - Ping Remote SMTP Server - PINGThis option can be used to ping a TCP/IP host to see if it's active on the network.

Option 31 - Connect to SMTP Server via TelnetThis option can be used to connect to a SMTP server on port 25 to see if it's active and acceptingmail connections.

Page 18: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/40017

Copyright © 1992-2002 ... RJS Software Systems Inc.

Option 32 - AS/400 TCP/IP Configuration MenuThis option can be used to go to the AS/400 TCP/IP setup menu and create host entries via option10. Each SMTP mail server being used to send outbound mail must have a host entry in the AS/400TCP/IP host table on on a DNS server.

1.5 AS/400 Commands

1.5.1 Introduction to AS/400 Commands

This section gives an overview of the Mail Blast/400 AS/400 commands.

1.5.2 BLMPROCESS: Run Mail Blast Processing

This step runs the actual email processing using a selected message template, up to 10 PC fileattachments from the AS/400 IFS and the selected name/address file.

Note: This command will typically be run in batch mode. Multiple copies of BLMPROCESS can besubmitted to allow multiple jobs to be processing the same name/address list at the same time. Evenif multiple jobs are processing the list at the same time, only one email will get sent to each recipient.Running multiple BLMPROCESS jobs can improve performance when sending emails to large lists bybalancing the load between multiple AS/400 jobs.

Mail Blast/400 processing prompt 1 - BLMPROCESS

Page 19: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/400 18

Copyright © 1992-2002 ... RJS Software Systems Inc.

Mail Blast/400 processing prompt 2 - BLMPROCESS

Mail Blast/400 processing prompt 3 - BLMPROCESS

Page 20: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/40019

Copyright © 1992-2002 ... RJS Software Systems Inc.

Command parameters

Mail Blast Name/Address FileThis is the Name/Address file which will get processed. Default: BLMADR00. A member name must beselected.

Enter the data member or *FIRST which will use the first and only name/address file member in theaddress file.

Mail Blast Template Msg FileThis is the selected message template member which will be processed. A message template membername must be selected.

Enter the mamber name for your message template.

Example: M000000001

From email addressThis is the email address where the email messages are originating from and will bounce back to ifundeliverable. This should be set to a valid system administrator email address in your email system.

Leave *DEFAULT in the parameter so the default from address is used.

SubjectThis is the subject of the email.

If *TEMPLATEDESC is used, the email message template description is used as the email subjectline.

SMTP server nameThis is the SMTP server where all outgoing email messages will be forwarded to for delivery. If youuse LOCALHOST for this entry, the local AS/400 SMTP server or Domino Server will be used. A hostname should always be used, not an IP address. A host name can be set up for a SMTP server fromthe following menu: (GO CFGTCP, option 10)

*DEFAULT will use the default SMTP server setting.

Mime content typeTypically the default value of 'text/plain' should be used, however if messages will be formatted asHTML, 'text/html' can be used.

Attachment file 1 - 10These are the IFS attachments which will be sent out with the selected email message templates ifspecified. This is a good way to distribute documents to a number of users at the same time.

If PC document files are stored in AS/400 shared folders, /QDLS must be appended to the file path,so the documents can be found in the appropriate shared folder. If documents are placed in a regularIFS folder, the forward slash must always be appended to the path (/).

IFS File Example: /DOCS/DOC1.PDF refers to a file named DOC1.PDF in the DOCS IFS folder.

QDLS Example: /QDLS/DOCS/DOC1.PDF refers to a file named DOC1.PDF in the DOCS folder inthe QDLS shared folders.

Note: It is not required to send file attachments when mailing. They will only be sent if specified. Each

Page 21: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/400 20

Copyright © 1992-2002 ... RJS Software Systems Inc.

recipient receives a copy of the same file attachments if sending files along with the main message.

Zip attachment filesWhen this setting is enabled, all attachment files are zipped before mailing.

Delivery confirmation requestA delivery confirmation request will be sent with each email message. An email will be returned to thesender after the mail is delivered.

Note: This setting may not always work. It's dependent on the recipients email system allowingconfirmation requests to be requested.

Read confirmation requestA read confirmation request will be sent with each email message. An email will be returned to thesender after the mail is read.

Note: This setting may not always work. It's dependent on the recipients email system allowingconfirmation requests to be requested.

High priority requestThis email message will be sent with a high priority flag so it shows up as a high priority messagewhen delivered.

1.5.3 BLMRESET: Reset Processed Address Flags

This step should be done after a mass-emailing has been completed and before the next mass-emailing is done using the same name/address file.

When this step is run, the processed flag field: EPROC is reset to blanks for each record in the nameand address file (BLMADR00) so it's ready for the next emailing. This field is set to value 'P' while it'sbeing processed and 'Y' once email processing has completed for the email address. The field will beset to blanks when the reset process is run.

Page 22: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/40021

Copyright © 1992-2002 ... RJS Software Systems Inc.

Reset Processed Address Flag - BLMRESET

Command parameters

FileEnter the AS/400 name/address file name to reset.

LibraryEnter the AS/400 library name for the file.

Member nameEnter the AS/400 file member to reset. Normally this setting will be *FIRST.

1.5.4 BLMHOST: Set Default SMTP Host

Before sending email via Mail Blast/400 a default SMTP mail server host name must be set. Thisvalue should point to a valid DNS host name or a name created in the AS/400 host table (GOCFGTCP, option 10) that points to a valid IP address where the SMTP server is located.

Note: Do not enter an IP address in this setting. Only use a valid host name.

Page 23: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/400 22

Copyright © 1992-2002 ... RJS Software Systems Inc.

Setting Default SMTP Host - BLMHOST

Command parameters

Option*SET - Set new value.

*DSP - Display current value when Enter pressed. All other parameters are ignored.

Outbound SMTP mail serverSet to a valid DNS entry or host name. In this example we have an AS/400 host entry named RJS1which points to an internal SMTP server.

Note: This setting can be overridden at run time on the BLMPROCESS command.

1.5.5 BLMFROM: Set Default From Address

Before sending email via Mail Blast/400 a default from address must be set. If a mail bounces backduring processing, the default from email address will receive a copy of the bounced back message.

Page 24: Mail Blast/400 - downloads.rjssoftware.comdownloads.rjssoftware.com/docs/rjsblast/Manuals/rjsblast.pdf · 1 Mail Blast/400 1.1 Overview 1.1.1 Introduction to Mail Blast/400 Mail Blast/400

Mail Blast/40023

Copyright © 1992-2002 ... RJS Software Systems Inc.

Setting Default From Address - BLMFROM

Command parameters

Option*SET - Set new value.

*DSP - Display current value when Enter pressed. All other parameters are ignored.

Default from email addressSet to a valid email address such as [email protected]

Note: This setting can be overridden at run time on the BLMPROCESS command.

1.6 Problem Handling

1.6.1 Common Errors

If errors occur while running the Mail Blast/400 API's, always make sure to check the AS/400 job logby using the DSPJOBLOG command from the AS/400 command line. Many times the job log will givesome idea as to what is failing.

1.6.2 Other Errors

If you cannot resolve the problem you're experiencing by using the previous troubleshooting methods,you should contact RJS Software Systems for advice on solving the problems you're experiencing.