The two other members, the sender address and the subject line, are added to the structure. Finally, on line 15, the EmailBlaster gateway instance is invoked with a call to sendGatewayMessage and the message structure is passed.

The Change Up
Clearly there is a problem in making EmailBlaster useful in any capacity if it's only capable of calling to a single listener CFC. It would be imminently more useful if additional data elements could be passed and different e-mail letter content could be used. One way of doing this, which serendipitously helps to demonstrate a cool feature of gateways, is to indicate a different listener CFC in the messageStruct passed to sendGatewayMessage.

The Calling Logic, Part Deux
A few additions to what was our original calling logic will produce Newsletter.cfm (see Listing 3).

Herein there are two additional columns added to the query that is being sent in the messageStruct, firstname, and lastname. Everything else remains more or less the same until line 15 where the structure member cfcPath (which was shown briefly in Table 3) is added, indicating the Newsletter.cfc in the same calling directory (obtained using CFML's expandPath function).

The Listener CFC, Part Deux
The new listener CFC, Newsletter.cfc (see Listing 4), is merely a rehash of the default listener configured in the ColdFusion Administrator for this gateway instance. The one point of change is line 10 where the two new columns added in the calling logic are pasted into the output of the e-mail body.

It should be noted that the sample code for this article requires that you do two things before you can successfully run the examples:

1.  Configure your ColdFusion Server's mail server settings

2.  Change the e-mail addresses used in the templates to valid values:

• EmailBlaster.cfm, line 7
• EmailBlaster.cfm, line 10
• Newsletter, line 9
• Newsletter, 12

Be sure to drop by the CCOJ blog and post your feedback and questions about this article and the series. (Note: Listings 1-4 are also available on the CCOJ blog [http://ccoj.coldfusionjournal.com], ccojas-part2-code.zip.)

• Figure 1