User Guide

cfpop 331
Usage
The cfpop tag retrieves one or more mail messages from a POP server and populates a
ColdFusion query object with the resulting messages, one message per row. Alternatively, it
deletes one or more messages from the POP server.
Note: When the cfpop tag encounters malformed mail messages, it does not generate errors;
instead, it returns empty fields.
To optimize performance, two retrieve options are available. Message header information is
typically short, and therefore quick to transfer. Message text and attachments can be very long,
and therefore take longer to process.
cfpop query variables
The following table describes the variables that provide information about the query that is
returned by
cfpop:
generate
Unique
Filenames
Optional No • Yes: generate unique filenames for files
attached to an e-mail message, to avoid
naming conflicts when files are saved.
• No
debug Optional No • Yes: sends debugging output to standard
output. By default, if the console window is
unavailable on server configurations,
ColdFusion sends output to cf_root/
runtime/logs/coldfusion-out.log. On J2EE
configurations, with JRun, the default
location is jrun_home/logs/
servername-out.log.
Caution: If you set this option to Yes,
ColdFusion MX writes detailed debugging
information to the log, including all retrieved
message contents, and can generate large
logs quickly.
• No: does not generate debugging output.
Variable names Description
queryname.recordCount Number of records returned by query
queryname.currentRow Current row that
cfoutput is processing
queryname.columnList List of column names in query
queryname.UID Unique identifier for the e-mail message file
Attribute Req/Opt Default Description