159 lines
9.5 KiB
HTML
159 lines
9.5 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
||
|
|
<!DOCTYPE html
|
||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
|
<html lang="en-us" xml:lang="en-us">
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
|
|
<meta name="security" content="public" />
|
||
|
|
<meta name="Robots" content="index,follow" />
|
||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
|
|
<meta name="DC.Type" content="reference" />
|
||
|
|
<meta name="DC.Title" content="QtmmSendMail API" />
|
||
|
|
<meta name="abstract" content="You can use the Send MIME Mail (QtmmSendMail) API to send e-mail from an iSeries program." />
|
||
|
|
<meta name="description" content="You can use the Send MIME Mail (QtmmSendMail) API to send e-mail from an iSeries program." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzairsendrece.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzairrzairfixapi.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzairattchfl.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzairrzairfixapi.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2004, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzairsendmime" />
|
||
|
|
<meta name="DC.Language" content="en-us" />
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
|
|
<title>QtmmSendMail API</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzairsendmime"><a name="rzairsendmime"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">QtmmSendMail API</h1>
|
||
|
|
<div><p>You can use the Send MIME Mail (QtmmSendMail) API to send e-mail
|
||
|
|
from an iSeries™ program.</p>
|
||
|
|
<div class="section"><p>The QtmmSendMail API supports sending multiple
|
||
|
|
mail attachments at one time, but the Send Distribution (SNDDST) command does
|
||
|
|
not. This API is in the service program QTCP/QTMMSNDM. Application programs
|
||
|
|
must bind to this service program.</p>
|
||
|
|
<p>The QtmmSendMail API works in the
|
||
|
|
following way:</p>
|
||
|
|
<ol><li>You create an ASCII file with an entire MIME note. The headers are all
|
||
|
|
in US-ASCII coded character set identifier (CCSID) 367.</li>
|
||
|
|
<li>The application calls the QtmmSendMail API and gives it both the name
|
||
|
|
of the file and the addresses that the framework and SMTP must use to forward
|
||
|
|
the e-mail.</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Authorities</h4><p>The MIME integrated-file-system file
|
||
|
|
must exist for the duration of the QMSF framework pass. The conversion and
|
||
|
|
delivery exit points that are called by the QMSF job must be able to read
|
||
|
|
this file. A built-in exit program removes (unlinks) the link. If this is
|
||
|
|
the last link, the framework deletes the file.</p>
|
||
|
|
<dl><dt class="dlterm">Directory authority</dt>
|
||
|
|
<dd>The data authority must be *X for product QMSF.</dd>
|
||
|
|
<dt class="dlterm">File authority</dt>
|
||
|
|
<dd>QTCP and QMSF must have:<ul><li>Data authority *RWX</li>
|
||
|
|
<li>Object authority *ALL</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Required parameter group</h4><dl><dt class="dlterm">File name</dt>
|
||
|
|
<dd>(Input Char(*)) The character string of the integrated-file-system file
|
||
|
|
name of the ASCII MIME note. You must specify the entire path. After the framework
|
||
|
|
finishes processing the file, it unlinks the file. If this is the last link,
|
||
|
|
the framework deletes the file. This file must contain an Internet-ready MIME
|
||
|
|
note that adheres to the standards that are called Request for Comment (RFC).</dd>
|
||
|
|
<dt class="dlterm">Length of file name</dt>
|
||
|
|
<dd>(Input Binary(4)) The number of bytes in the file name (the absolute path
|
||
|
|
name). The maximum length is 255 bytes (no NULL that is assumed at the end).</dd>
|
||
|
|
<dt class="dlterm">Originator address (SMTP)</dt>
|
||
|
|
<dd>(Input Char(*)) The character string of an SMTP originator address; for
|
||
|
|
example, smith@myhost.mytown.com. All SMTP addresses should be in coded character
|
||
|
|
set identifier (CCSID) 500.</dd>
|
||
|
|
<dt class="dlterm">Length of originator</dt>
|
||
|
|
<dd>(Input Binary(4)) The length of the originator address string (not including
|
||
|
|
any NULL). The maximum length is 256 bytes.</dd>
|
||
|
|
<dt class="dlterm">First recipient address (SMTP)</dt>
|
||
|
|
<dd>(Input ADDT0100(*)) The first address structure that contains a recipient
|
||
|
|
address. All SMTP addresses should be in CCSID 500.</dd>
|
||
|
|
<dt class="dlterm">Total number of recipients</dt>
|
||
|
|
<dd>(Input Binary(4)) The number of recipient address structures (there must
|
||
|
|
be at least one).</dd>
|
||
|
|
<dt class="dlterm">Error code</dt>
|
||
|
|
<dd>(I/O Char(*)) The structure that returns error information.</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">ADDTO100 format</h4><p>This table shows the layout for
|
||
|
|
format ADDT0100.</p>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="11.11111111111111%" id="d0e108">Offset Dec</th>
|
||
|
|
<th valign="top" width="11.11111111111111%" id="d0e110">Offset Hex</th>
|
||
|
|
<th valign="top" width="22.22222222222222%" id="d0e112">Type</th>
|
||
|
|
<th valign="top" width="22.22222222222222%" id="d0e114">Field</th>
|
||
|
|
<th valign="top" width="33.33333333333333%" id="d0e116">Field description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" width="11.11111111111111%" headers="d0e108 ">0</td>
|
||
|
|
<td valign="top" width="11.11111111111111%" headers="d0e110 ">0</td>
|
||
|
|
<td valign="top" width="22.22222222222222%" headers="d0e112 ">BINARY(4)</td>
|
||
|
|
<td valign="top" width="22.22222222222222%" headers="d0e114 ">Offset to next address structure</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e116 ">The number of bytes from the beginning of this address structure to
|
||
|
|
the beginning of the next one. It must be at least the size of the fixed part
|
||
|
|
of this address structure and the recipient address length.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="11.11111111111111%" headers="d0e108 ">4</td>
|
||
|
|
<td valign="top" width="11.11111111111111%" headers="d0e110 ">4</td>
|
||
|
|
<td valign="top" width="22.22222222222222%" headers="d0e112 ">BINARY(4)</td>
|
||
|
|
<td valign="top" width="22.22222222222222%" headers="d0e114 ">Address length</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e116 ">The length in bytes of the SMTP address. The maximum length is 256
|
||
|
|
bytes. This maximum length is determined by Internet standards.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="11.11111111111111%" headers="d0e108 ">8</td>
|
||
|
|
<td valign="top" width="11.11111111111111%" headers="d0e110 ">8</td>
|
||
|
|
<td valign="top" width="22.22222222222222%" headers="d0e112 ">CHAR(8)</td>
|
||
|
|
<td valign="top" width="22.22222222222222%" headers="d0e114 ">Address Format name</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e116 ">The characters that identify the particular structure. (Current value
|
||
|
|
ADDT0100). It is used for level control of the structure.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="11.11111111111111%" headers="d0e108 ">16</td>
|
||
|
|
<td valign="top" width="11.11111111111111%" headers="d0e110 ">10</td>
|
||
|
|
<td valign="top" width="22.22222222222222%" headers="d0e112 ">BINARY(4)</td>
|
||
|
|
<td valign="top" width="22.22222222222222%" headers="d0e114 ">Distribution type</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e116 ">The type of recipient. Possible values are: <ul><li><span class="uicontrol">0</span> Normal</li>
|
||
|
|
<li><span class="uicontrol">1</span> Carbon copy</li>
|
||
|
|
<li><span class="uicontrol">2</span> Blind carbon copy</li>
|
||
|
|
</ul>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="11.11111111111111%" headers="d0e108 ">20</td>
|
||
|
|
<td valign="top" width="11.11111111111111%" headers="d0e110 ">14</td>
|
||
|
|
<td valign="top" width="22.22222222222222%" headers="d0e112 ">BINARY(4)</td>
|
||
|
|
<td valign="top" width="22.22222222222222%" headers="d0e114 ">Reserved</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e116 ">This field is reserved and must be set to 0.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="11.11111111111111%" headers="d0e108 "> </td>
|
||
|
|
<td valign="top" width="11.11111111111111%" headers="d0e110 "> </td>
|
||
|
|
<td valign="top" width="22.22222222222222%" headers="d0e112 ">CHAR(*)</td>
|
||
|
|
<td valign="top" width="22.22222222222222%" headers="d0e114 ">Address</td>
|
||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e116 ">The actual SMTP address (no NULLS included). All SMTP addresses should
|
||
|
|
be in CCSID 500.</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzairsendrece.htm" title="Your iSeries server is a mail server and has e-mail users (SNADS, POP, or Lotus) enrolled on it. Using either a POP client or a SNADS client, your e-mail users can send, receive, and read e-mail.">Send and receive e-mail on iSeries server</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rzairrzairfixapi.htm" title="Use this troubleshooting process to resolve problems that you are having with the Send MIME Mail (QtmmSendMail) API.">Solve problems with the QtmmSendMail API</a></div>
|
||
|
|
<div><a href="rzairattchfl.htm" title="You can use Send Distribution command (SNDDST) to send e-mail with an attached file or document.">Attach files</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|