friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
master
ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/xpsf400email.htm

2072 lines
63 KiB
HTML
Raw Permalink Normal View History

Add readme and dist folders
2024-04-02 14:02:31 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>PSF/400 Mapping Exit Program</title>
<!-- 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. -->
<!-- Begin Header Records -->
<!-- Created by Rondi Herman for V5R1-->
<!-- End Header Records -->
<!--Edited by Kersten Nov 2001 -->
<!-- 030226 HTML cleanup by JET -->
<!-- 050621 d3602.3 Update JBK -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<a name="Top_Of_Page"></a>
<!--Java sync-link-->
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<h2>PSF/400 Mapping Exit Program</h2>
<div class="box" style="width: 70%;">
<br>
&nbsp;&nbsp;Required Parameter Group:<br>
<!-- iddvc RMBR -->
<br>
<table width="100%">
<tr>
<td align="center" valign="top" width="10%">1</td>
<td align="left" valign="top" width="50%">Mapping exit input information</td>
<td align="left" valign="top" width="20%">Input</td>
<td align="left" valign="top" width="20%">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="left" valign="top">Length of input information</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">BINARY(4)</td>
</tr>
<tr>
<td align="center" valign="top">3</td>
<td align="left" valign="top">Mapping exit output information</td>
<td align="left" valign="top">Output</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">Length of output information buffer</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">BINARY(4)</td>
</tr>
<tr>
<td align="center" valign="top">5</td>
<td align="left" valign="top">Length of output information available</td>
<td align="left" valign="top">Output</td>
<td align="left" valign="top">BINARY(4)</td>
</tr>
</table>
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: Yes<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The PSF/400 mapping exit program allows a customer to specify a routing tag
instead of a mail address in the USRDFNDTA parameter of the printer file,
using indices and Infoprint Server's CRTAFPDTA command, or the
DDS STRPAGGRP parameter. The PSF/400 mapping exit program also allows a customer
or vendor to provide a program to map a routing tag (such as a customer number) to
one or more distribution actions, and configure the details of the
distribution. The PDF file can be stored as a streamfile in the Integrated File
System, respooled as AFP or PDF on an output queue, e-mailed, or any combination of those
distributions. In addition, the mapping exit program allows configuration of
those distributions, including the ability to specify the name of the PDF
streamfile, the ability to specify the subject, encryption settings and additional attachments of
the e-mail, or the output queue to spool the PDF.</p>
<p>This exit program is called for each successfully generated PDF file
whenever a mapping exit program is speficied on the PDFMAPPGM parameter of the
PSFCFG, and the PDFGEN parameter does not have a value of *NONE. Once PSF/400
has received notification from the virtual printer that all pages have been
stacked, it calls the exit program for each PDF output file to resolve the routing
tag information to the proper distribution action.</p>
<br>
<h3>Authorities and Locks</h3>
<p>None.</p>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Mapping exit input information</strong></dt>
<dd>INPUT; CHAR(*)
<p>The mapping exit program information that is input to the mapping exit program
from the PSF/400 print writer. For the format and description of the
information see, <a href="#HDRTOPTINP">Mapping Exit Program Input
Information</a>.</p>
</dd>
<dt><strong>Length of input information</strong></dt>
<dd>INPUT; BINARY(4)
<p>The length of the input information specified in the mapping exit input
information to the mapping exit program parameter.</p>
</dd>
<dt><strong>Mapping exit output information</strong></dt>
<dd>OUTPUT; CHAR(*)
<p>The information that is output from the mapping exit program to the PSF/400
print writer. For the format and description of this information, see <a href=
"#HDRTOPTout">mapping Exit Program Output Information</a>.</p>
</dd>
<dt><strong>Length of output information buffer</strong></dt>
<dd>INPUT; BINARY(4)
<p>The size, in bytes, of the mapping exit program output information buffer.</p>
</dd>
<dt><strong>Length of output information available</strong></dt>
<dd>OUTPUT; BINARY(4)
<p>The length of the mapping exit program output information available. If this
length is less than or equal to the length of the routing tag output
information, all available information has been returned. If this length is
greater than the length of the mapping program output information, only data up to
the length provided is returned in the mapping exit program output information
buffer.</p>
</dd>
</dl>
<br>
<h3><a name="HDRTOPTINP">Mapping Exit Program Input Information</a></h3>
<p>The following table shows the structure for the input information that is
passed to the PSF/400 Mapping exit program.</p>
<h4>Printer File Parameter Table</h4>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(26)</td>
<td align="left" valign="top" width="60%">Qualified job name</td>
</tr>
<tr>
<td align="center" valign="top">26</td>
<td align="center" valign="top">1A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Spooled file name</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Spooled file number</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">CHAR(250)</td>
<td align="left" valign="top">Routing tag</td>
</tr>
<tr>
<td align="center" valign="top">290</td>
<td align="center" valign="top">122</td>
<td align="left" valign="top">CHAR(340)</td>
<td align="left" valign="top">Path and name of PDF file</td>
</tr>
<tr>
<td align="center" valign="top">630</td>
<td align="center" valign="top">276</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Mail server type</td>
</tr>
<tr>
<td align="center" valign="top">631</td>
<td align="center" valign="top">277</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="center" valign="top">632</td>
<td align="center" valign="top">278</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Path name CCSID</td>
</tr>
<tr>
<td align="center" valign="top">636</td>
<td align="center" valign="top">27C</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Mail sender</td>
</tr>
<tr>
<td align="center" valign="top">646</td>
<td align="center" valign="top">286</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User Data</td>
</tr>
<tr>
<td align="center" valign="top">656</td>
<td align="center" valign="top">290</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Job system name</td>
</tr>
<tr>
<td align="center" valign="top">664</td>
<td align="center" valign="top">298</td>
<td align="left" valign="top">CHAR(8)</td>
<td align="left" valign="top">Creation time stamp</td>
</tr>
<tr>
<td align="center" valign="top">672</td>
<td align="center" valign="top">2A0</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output queue on which the spooled file is
located</td>
</tr>
<tr>
<td align="center" valign="top">682</td>
<td align="center" valign="top">2AA</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output queue library</td>
</tr>
<tr>
<td align="center" valign="top">692</td>
<td align="center" valign="top">2B4</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">PDF mapping object name</td>
</tr>
<tr>
<td align="center" valign="top">702</td>
<td align="center" valign="top">2BE</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">PDF mapping object library</td>
</tr>
<tr>
<td align="center" valign="top">712</td>
<td align="center" valign="top">C8</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Formtype</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRTFIELDJ">Field Descriptions</a></h3>
<p><strong>Creation time stamp.</strong> The date and time the spooled file was
created.</p>
<p><strong>Formtype.</strong> The value from the Formtype parameter on the print
file.</p>
<p><strong>Job system name.</strong> The name of the system on which the
spooled file was created.</p>
<p><strong>Mail sender.</strong> The sender of the electronic mail. The value
is specified on the printer file USRDFNDTA parameter or on the PSF
configuration object PDFSENDER parameter. If no mail sender is identified on
USRDFNDTA, the value from the PDFSENDER parameter of the PSF configuration
object is used.</p>
<p><strong>Mail server type.</strong> The mail server in use. Valid values
are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">The SNDDST (Send Distribution) command is used to
send e-mail messages.</td>
</tr>
<tr>
<td align="left" valign="top"><em>2</em></td>
<td align="left" valign="top">The SMTP protocol is being used to send e-mail
messages.</td>
</tr>
</table>
<p><strong>Routing tag.</strong> The mail address or routing tag specified on the
printer file USRDFNDTA parameter or the DDS STRPAGGRP keyword. This is set to
blanks ('40'X) if no value was provided by either parameter. It is possible
that the mapping program could return mail addresses based on job, file, and
USRDTA information. If both provide tag or address information, the DDS
STRPAGGRP keyword takes precedence.</p>
<p><strong>Output queue on which the spooled file is located.</strong> The
outpue queue to which the writer was started.</p>
<p><strong>Output queue library.</strong> The library that contains the output
queue to which writer was started.</p>
<p><strong>Path and name of PDF file.</strong> The path and name of the PDF
file.</p>
<p><strong>Path name CCSID.</strong> The CCSID of the path and name of the PDF
file.</p>
<p><strong>PDF mapping object library.</strong> Name of the PDF mapping object library, if one was
specified on the PSFCFG object. This is set to blanks (X'40') if no value was
provided on the PDFMAPBOBJ parameter of the PSFCFG object.</p>
<p><strong>PDF mapping object name.</strong> Name of the PDF mapping object, if one was specified on
the PSFCFG object. This is set to blanks (X'40') if no value was provided on
the PDFMAPBOBJ parameter of the PSFCFG object.</p>
<p><strong>Qualified job name.</strong> The qualified job name of the job that
created the spool file that was converted to PDF. The data is comprised of the
following information:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>CHAR(10)</em></td>
<td align="left" valign="top">Job name</td>
</tr>
<tr>
<td align="left" valign="top"><em>CHAR(10)</em></td>
<td align="left" valign="top">User name</td>
</tr>
<tr>
<td align="left" valign="top"><em>CHAR(6)</em></td>
<td align="left" valign="top">Job number</td>
</tr>
</table>
<p><strong>Reserved.</strong> An unused field.</p>
<p><strong>Spooled file name.</strong> The name of the spooled file that was
converted to PDF.</p>
<p><strong>Spooled file number.</strong> The unique number of the spooled file
that was converted to PDF.</p>
<p><strong>User data.</strong> The value in the printer file USRDTA parameter.
It contains blanks if USRDTA contains blanks.</p>
<br>
<h3><a name="HDRTOPTOUT">Mapping Exit Program Output Information</a></h3>
<p>The following table shows the structure for the output information from the
Mapping exit program.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(1)</td>
<td align="left" valign="top" width="60%">Disposition of PDF e-mail</td>
</tr>
<tr>
<td align="center" valign="top">1</td>
<td align="center" valign="top">1</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">More processing</td>
</tr>
<tr>
<td align="center" valign="top">2</td>
<td align="center" valign="top">2</td>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Reserved - initialized to null</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of message text (0 to 255 bytes)</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of mail address data (0-16,000,000)</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">CHAR(255)</td>
<td align="left" valign="top">Message text data</td>
</tr>
<tr>
<td align="center" valign="top">267</td>
<td align="center" valign="top">10B</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Reserved - initialized to null</td>
</tr>
<tr>
<td align="center" valign="top">268</td>
<td align="center" valign="top">10C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to extension area</td>
</tr>
<tr>
<td align="center" valign="top">272</td>
<td align="center" valign="top">110</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">CCSID of message text data and subject</td>
</tr>
<tr>
<td align="center" valign="top">276</td>
<td align="center" valign="top">114</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Disposition of PDF streamfile</td>
</tr>
<tr>
<td align="center" valign="top">277</td>
<td align="center" valign="top">115</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Disposition of PDF spoolfile</td>
</tr>
<tr>
<td align="center" valign="top">278</td>
<td align="center" valign="top">116</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Disposition of PDF error</td>
</tr>
<tr>
<td align="center" valign="top">279</td>
<td align="center" valign="top">117</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Disposition of AFPDS spoolfile</td>
</tr>
<tr>
<td align="center" valign="top"><img src="v5r4adelta.gif" alt=
"Start of V5R4 change">280</td>
<td align="center" valign="top">118</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to message text data<img src=
"v5r4adeltaend.gif" alt="End of V5R4 change"></td>
</tr>
<tr>
<td align="center" valign="top"><img src="v5r4adelta.gif" alt=
"Start of V5R4 change">284</td>
<td align="center" valign="top">122</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved - initialized to null
<img src="v5r4adeltaend.gif" alt="End of V5R4 change"></td>
</tr>
<tr>
<td align="center" valign="top">287</td>
<td align="center" valign="top">11F</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">E-mail addresses</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRTFIELDJ2">Field Descriptions</a></h3>
<p><strong>CCSID of message text data and subject.</strong> The CCSID
associated with the message text data and subject, if specified.</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">A value from 1 to 65533.</td>
</tr>
<tr>
<td align="left" valign="top" nowrap><em>ccsid-value</em></td>
<td align="left" valign="top">A value from 1 to 65533.</td>
</tr>
</table>
<p>This field is used only when an SMTP mail server is specified in your PSF
configuration object and must be set to zero otherwise.</p>
<p>This CCSID will be used to convert the data to Unicode for inclusion within
the e-mail. The receiver of the e-mail may have to have the receiving e-mail
program configured for the appropriate character set to be able to view the
e-mail correctly.</p>
<p><strong>Disposition of AFPDS spoolfile.</strong> Specifies whether the PDF should be spooled. If file
is to be spooled as AFPDS, an output queue has to be defined on the PSFCFG or
in the <a href="#HDRAFPSPLF"> Spooled file AFPDS Distribution</a> in the Output
Queue Name field</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'0'</em></td>
<td align="left" valign="top">Do not spool AFPDSon an output queue.</td>
</tr>
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">Spool AFPDS on an output queue</td>
</tr>
</table>
<p><strong>Disposition of PDF e-mail.</strong> Specifies whether the PDF should
be e-mailed.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'0'</em></td>
<td align="left" valign="top">Do not e-mail</td>
</tr>
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">E-mail to specified addresses</td>
</tr>
</table>
<p><strong>Disposition of PDF error.</strong> This field can be used to signal to PSF/400 that an error
was detected in the Exit Program. If this flag is set, PSF/400 will e-mail the
PDF output to the e-mail address on the PSFCFG PDFADMIN, if one is
available.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'0'</em></td>
<td align="left" valign="top">No errors mapping input.</td>
</tr>
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">Errors were encountered.</td>
</tr>
</table>
<p><strong>Disposition of PDF spoolfile.</strong> Specifies whether the PDF should be spooled. If file is
to be spooled as PDF, an output queue has to be defined on the PSFCFG or in the
<a href="#HDRPDFSPLF"> Spooled file PDF Distribution</a> in the Output Queue
Name field</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'0'</em></td>
<td align="left" valign="top">Do not spool PDF file on an outq</td>
</tr>
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">Spool PDF file on an outq</td>
</tr>
</table>
<p><strong>Disposition of PDF streamfile.</strong> Specifies whether the PDF should be stored as a stream
file in the Integrated File System. If file is to be stored as a stream file,
user will have to have the path name defined in the PSFCFG or specified in the
PDF file name field of the <a href="#HDREXTAREA">Extension area format.</a></p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'0'</em></td>
<td align="left" valign="top">Do not store PDF as a stream file.</td>
</tr>
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">Store PDF as a stream file.</td>
</tr>
</table>
<p><strong>E-mail addresses.</strong> The e-mail addresses that should be used
for sending the PDF file. They must be in the following format: ('e-mail
address' 'e-mail address'..) Each address must be delimited by single
quotes.</p>
<p><strong>Length of e-mail address data.</strong> The length of the e-mail
address data to be used in sending the PDF file. The maximum length allowed is
16 MB, since this is the largest value that can be used allocate a user space.
If the PDF file should not be e-mailed, the length of the e-mail address data
should be set to 0.</p>
<p><strong>Length of message text data.</strong> The length of the message text
to be used in sending the PDF file. This must be a value ranging from 0 to 255.
If no message text is to be used in sending the PDF file, the length of the
message text data should be set to 0.</p>
<p><strong>Message text data.</strong> The message text data to be used in
sending the PDF file. This value should be blanks if the text length is 0.</p>
<p><strong>More processing.</strong> Whether the exit program should be called
again because it has more processing to do for the same spooled file.</p>
<dl>
<dt><em>'0'(X'F0')</em></dt>
<dd>Do not call exit program again. Since this field occupies the offset of a
field that was reserved in V5R1, a value of X'00' will be treated the same as 0
(X'F0') for compatability.</dd>
<dt><em>'1'(X'F1')</em></dt>
<dd>Call exit program again. The input information presented to the exit
program is not modified. If at any point an error occurs while processing an
e-mail:</dd>
<dd>
<ul>
<li>The exit program is not called again, irrespective of the setting for this
field.</li>
<li>The spooled file is held.</li>
</ul>
</dd>
</dl>
<p><strong>Offset to extension area.</strong> Offset from the beginning of this
structure. The value specified for this entry must be a 4-byte multiple. A
value of 0 indicates that the extension area is not being used. Refer to <a
href="#HDREXTAREA">Extension area format</a> for additional information.</p>
<p><strong><img src="v5r4adelta.gif" alt="Start of V5R4 change">Offset to message text
data.</strong> Offset from the beginning of this structure.
The value must be a 4-byte multiple Use this field if you specify more than
255 bytes of message text data. If you are using the Message text data field,
specify a value of 0 for Offset to message text data.
<img src="v5r4adeltaend.gif" alt="End of V5R4 change">
</p>
<p><strong>Reserved - initialized to null.</strong> A reserved field.</p>
<p><strong>Reserved (set to X'00').</strong> A reserved field.</p>
<br>
<h3><a name="hdrextarea">Extension area format</a></h3>
<p>This format is specified only when needed. If your application has no need
for it, specify a value of 0 for Offset to extension area in the e-mail exit
program output information.</p>
<p>This format must begin on a 4-byte multiple. All offsets are computed from
the beginning of the mapping exit program output information structure.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length of extension area format</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to subject</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of subject</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to ReplyTo e-mail address</td>
</tr>
<tr>
<td align="center" valign="top">16</td>
<td align="center" valign="top">10</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of ReplyTo e-mail address</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to CC e-mail addresses</td>
</tr>
<tr>
<td align="center" valign="top">24</td>
<td align="center" valign="top">18</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of CC e-mail addresses</td>
</tr>
<tr>
<td align="center" valign="top">28</td>
<td align="center" valign="top">1C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to BCC e-mail addresses</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of BCC e-mail addresses</td>
</tr>
<tr>
<td align="center" valign="top">36</td>
<td align="center" valign="top">24</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to list of path names for body of
e-mail</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to path name for directory for files </td>
</tr>
<tr>
<td align="center" valign="top">44</td>
<td align="center" valign="top">2C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of path name for directory for files </td>
</tr>
<tr>
<td align="center" valign="top">48</td>
<td align="center" valign="top">30</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to list of path names of attachments </td>
</tr>
<tr>
<td align="center" valign="top">52</td>
<td align="center" valign="top">34</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to PDF file name for storing as a file</td>
</tr>
<tr>
<td align="center" valign="top">56</td>
<td align="center" valign="top">38</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of PDF file name for storing as a file</td>
</tr>
<tr>
<td align="center" valign="top">60</td>
<td align="center" valign="top">3C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to file name for PDF attachment for e-mail</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of file name for PDF attachment for e-mail</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to PDF file public authority</td>
</tr>
<tr>
<td align="center" valign="top">72</td>
<td align="center" valign="top">48</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of PDF file public authority</td>
</tr>
<tr>
<td align="center" valign="top">76</td>
<td align="center" valign="top">4C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to spooled file PDF distribution</td>
</tr>
<tr>
<td align="center" valign="top">80</td>
<td align="center" valign="top">50</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of spooled file PDF distribution</td>
</tr>
<tr>
<td align="center" valign="top">84</td>
<td align="center" valign="top">54</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to spooled file AFP distribution</td>
</tr>
<tr>
<td align="center" valign="top">88</td>
<td align="center" valign="top">58</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of spooled file AFP distribution</td>
</tr>
<tr>
<td align="center" valign="top">92</td>
<td align="center" valign="top">5C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to PDF encryption information</td>
</tr>
<tr>
<td align="center" valign="top">96</td>
<td align="center" valign="top">60</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of PDF encryption information</td>
</tr>
<tr>
<td align="center" valign="top">100</td>
<td align="center" valign="top">64</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Mail sender</td>
</tr>
</table>
<br>
<br>
<h3><a name="HDRTFIELDJ3">Field Descriptions</a></h3>
<p><strong>Length of BCC e-mail addresses.</strong> The length of the BCC
e-mail address data to be used in sending the PDF file. This field is used only
when an SMTP mail server is specified in your PSF configuration object;
otherwise, it must be set to zero.</p>
<p><strong>Length of CC e-mail addresses.</strong> The length of the CC e-mail
address data to be used in sending the PDF file. This field is used only when
an SMTP mail server is specified in your PSF configuration object; otherwise,
it must be set to zero.</p>
<p><strong>Length of file name for PDF attachment for e-mail</STRONG>
Length of the file name used to rename the PDF attachment for
e-mail distribution. This field is only used when Disposition for
PDF e-mail is set to '1'; otherwise, it must be set to zero. </P>
<p><strong>Length of extension area format.</strong> The length of the
extension area format. Specify one of the following values:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>52</em></td>
<td align="left" valign="top">This length is used by the oldest mapping programs. Fields after Offset to list
of path names of attachments will not be recognized.</td>
</tr>
<tr>
<td align="left" valign="top"><em>100</em></td>
<td align="left" valign="top">This length is used by some mapping programs. Fields after Length of PDF
encrytpion information will not be recognized.</td>
</tr>
<tr>
<td align="left" valign="top"><em>110</em></td>
<td align="left" valign="top">This length allows full use of the Extension Area Format. All fields will
be recognized.</td>
</tr>
</table>
<p><strong>Length of path name for directory for files.</strong> The length of
the path name containing the directory for which files may be stored. This
field is used only when an SMTP mail server is specified in your PSF
configuration object; otherwise, it must be set to zero.</p>
<p><strong> Length of PDF encryption information .</strong> The length of the PDF file encryption
information. This field is used only when PDF encryption information is
specified; otherwise, it must be set to zero.</p>
<p><strong>Length of PDF file name for storing as a streamfile.</strong> The length of the PDF file name
used when Disposition of PDF streamfile
is set to 1. This field is used only when Disposition of PDF streamfile is set to '1';
otherwise, it must be set to zero.</p>
<p><strong>Length of PDF file public authority</strong> The length of public authority to the PDF file.
This field is used only when the PDF file is to be stored as a stream file and
the PDF Streamfile Disposition is equal to '1'; otherwise, it must be set to
zero. </p>
<p> <strong>Length of spooled file AFP distribution</strong> The length of the AFP spooled file
distribution information. This field is used only when a additional spooled
file information is specified; otherwise, it must be set to zero.</p>
<p> <strong>Length of spooled file PDF distribution</strong> The length of the PDF spooled file
distribution information. This field is used only when additional spooled
file information is specified; otherwise, it must be set to zero.</p>
<p><strong>Length of ReplyTo e-mail address.</strong> The length of the ReplyTo
e-mail address. This field is used only when an SMTP mail server is specified
in your PSF configuration object; otherwise, it must be set to zero.</p>
<p><strong>Length of subject</strong> The length of the character string to be
used as the subject text. Maximum length is 255. Data longer than the maximum
length will be truncated.</p>
<p><strong>Offset to BCC e-mail addresses.</strong> Offset to BCC e-mail
addresses. This area contains the BCC e-mail addresses that should be used for
sending the PDF file. These addresses must be in the following form: ('e-mail
address' 'e-mail address'...). Each e-mail address must be delimited by single
quotes.</p>
<p>A value of 0 indicates that BCC e-mail addresses are not specified. This
field is used only when an SMTP mail server is specified in your PSF
configuration object; otherwise, it must be set to zero.</p>
<p><strong>Mail sender.</strong> The name to be used for the sender of the electronic mail. Pad the field with blanks ('40'X), if necessary.</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>Blanks ('40'X) </em></td>
<td align="left" valign="top">The mail sender specified on the PSF configuration object is used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>mail-sender-name</em></td>
<td align="left" valign="top">The name of the mail sender. This name must be a valid user profile
enrolled in the System Distribution Directory. If your PSF
configuration object specifies PDFMAILSVR(mail-server-name) or
PDFMAILSVR(*LOCAL), the entry in the System Distribution Directory
must have an SMTP user ID and SMTP domain specified.</td>
</tr>
</table>
<p><strong>Offset to CC e-mail addresses.</strong> Offset to BCC e-mail
addresses. This area contains the CC e-mail addresses that should be used for
sending the PDF file. These addresses must be in the following form: ('e-mail
address' 'e-mail address'...). Each e-mail address must be delimited by single
quotes.</p>
<p>A value of 0 indicates that CC e-mail addresses are not specified. This
field is used only when an SMTP mail server is specified in your PSF
configuration object; otherwise, it must be set to zero.</p>
<p><strong>
Offset to file name for PDF attachment for e-mail</strong>
The offset to the file name that will be used for the PDF output that
is attached to the e-mail when Disposition of PDF e-mail is sequal to '1'.
If Disposition of PDF e-mail is set to one, and this field is set to '0',
PSF will determine a default file name to use. If Disposition of PDF
e-mail is set to 0, this field must be set to zero as well. </P>
<p><strong>Offset to list of path names of attachments.</strong> The offset to
the list of path names listing the attachments. One or more attachments may be
specified. The PDF file you are sending must not be listed here; otherwise, it
will be attached again. A value of 0 indicates that no attachments are
specified.</p>
<p>If you have specified a directory to be used for files (see Offset to path
name for directory for files), then the path name specified for this field will
be appended to the value specified for the directory. If you have not specified
a directory to be used for files, the path name specified for each attachment
must be fully resolved. These files must be in the Integrated File System.
Please note the following:</p>
<ul>
<li>PSF can only access file systems that are threadsafe; therefore, you must
specify a file system that is threadsafe. The following files systems are not
threadsafe:<br>
<br>
<ul>
<li>QNetware</li>
<li>QFileSvr.400</li>
<li>Network File System (NFS)</li>
<li>QDLS</li>
</ul>
<br>
</li>
<li>All files must be encoded in a CCSID that matches the CCSID/CodePage of the
target system.</li>
</ul>
<p>Refer to <a href="#HDRSTMF">Stream file format</a> for information on the
format to use when specifying this information. This field is used only when an
SMTP mail server is specified in your PSF configuration object; otherwise, it
must be set to zero.</p>
<p><strong>Offset to list of path names for body of e-mail.</strong> Offset to
list of path names listing the files to be used for the body of the e-mail. One
or more files may be specified. The PDF file you are sending must not be listed
here or it will be attached again. A value of 0 indicates that a stream file is
not specified.</p>
<p>The order in which you list these files determines the order in which they
are placed in the body (message portion) of the e-mail. Files are placed in the
body in the order in which they are specified. If you have specified Message
text data, this is placed in the body of the e-mail first. These files must be
in the Integrated File System. Please note the following:</p>
<ul>
<li>PSF can only access file systems that are threadsafe; therefore, you must
specify a file system that is threadsafe. The following files systems are not
threadsafe:<br>
<br>
<ul>
<li>QNetware</li>
<li>QFileSvr.400</li>
<li>Network File System (NFS)</li>
<li>QDLS</li>
</ul>
</li>
<li>All files must be encoded in a CCSID that matches the CCSID/CodePage of the
target system.</li>
</ul>
<p>Refer to <a href="#HDRSTMF">Stream file format</a> for information on the
format to use when specifying this information.</p>
<p>The CCSID of the file is used if a code page conversion is required.</p>
<p>If a file is not text, it will be placed as an attachment to the e-mail. For
example, if you specify a sound file to be part of the body of the e-mail, it
will actually be an attachment.</p>
<p>This field is used only when an SMTP mail server is specified in your PSF
configuration object; otherwise, it must be set to zero.</p>
<p><strong>Offset to path name for directory for files</strong> The offset to a
path name containing the directory for which files may be stored. This path
name must be fully resolved. If you use this field, then path names of
specified attachments and body files will be appended to the path name
specified at the offset for this field.</p>
<p>A value of 0 indicates that a path name is not specified. If a value of 0 is
specified, you must specify the complete path name for all listed files used
for the body of the e-mail and as attachments to the e-mail.</p>
<p>This directory is specified by using a value of 1 in the use-specified
directory field in the Base format. This format is used when specifying files
to be used as attachments or as part of the body of the e-mail. If you specify
0 for the Use specified directory field, then that particular file must have
its full path specified.</p>
<p>This field is used only when an SMTP mail server is specified in your PSF
configuration object; otherwise, it must be set to zero.</p>
<p> <strong> Offset PDF
encryption information.</strong> The offset to the PDF file encryption
information. Refer to <a href="#HDRPDFENC">PDF spool file distribution
format</a> for information on the format to use when specifying this
information. A value of 0 indicates that no encryption information is
specified.</p>
<p><strong>Offset to PDF
file name for storing as a file.</strong> The offset to the file name the PDF
will be stored as in the Integrated File System. Requires that the
Disposition of PDF streamfile be set to 1. If Disposition of PDF streamfile is
set to 1, a value of 0 in this field indicates that PSF/400 will determine a default file
name to be used. </p>
<p><strong>Offset to PDF
file public authority.</strong> The offset to the public authorities specified
for the PDF stream file.</p>
<p><i>Valid Authority Values</i></p>
<dl>
<dt>*ALL</dt>
<dd>PSF specifies *RWX for the Public data authority and *ALL for the Public
object authorities</dd>
<dt>*EXCLUDE</dt>
<dd>The users do not have any of the data authorities to the objects.</dd>
<dt>*RWX</dt>
<dd>The users are given *RWX authority to perform all operations on the object
except those limited to the owner or controlled by object existence, object
management, object alter, and object reference authority. The user can change
the object and perform basic functions on the object. *RWX authority provides
object operational authority and all the data authorities.</dd>
<dt>*RX</dt>
<dd>The users are given *RX authority to perform basic operations on the
object, such as run a program or display the contents of a file. The user is
prevented from changing the object. *RX authority provides object operational
authority and read and execute authorities.</dd>
<dt>*RW</dt>
<dd>The users are given *RW authority to view the contents of an object and
change the contents of an object. *RW authority provides object operational
authority and data read, add, update, and delete authorities.</dd>
<dt>*WX</dt>
<dd>The users are given *WX authority to change the contents of an object and
run a program or search a library or directory. *WX authority provides object
operational authority and data add, update, delete, and execute
authorities.</dd>
<dt>*R</dt>
<dd>The users are given *R authority to view the contents of an object. *R
authority provides object operational authority and data read authority.</dd>
<dt>*W</dt>
<dd>The users are given *W authority to change the contents of an object. *W
authority provides object operational authority and data add, update, and
delete authorities.</dd>
<dt>*X</dt>
<dd>The users are given *X authority to run a program or search a library or
directory. *X authority provides object operational authority and data execute
authority.</dd>
</dl>
<p></p>
<br>
<p><strong> Offset to
spooled file AFP distribution.</strong> The offset to the AFP spooled file
information. Refer to <a href="#HDRAFPSPLF">AFP spool file distribution
format</a> for information on the format to use when specifying this
information. A value of 0 indicates that no spooled file information is
specified. </p>
<p> <strong> Offset to
spooled file PDF distribution.</strong> The offset to the PDF spooled file
information. Refer to <a href="#HDRPDFSPLF">PDF spool file distribution
format</a> for information on the format to use when specifying this
information. A value of 0 indicates that no spooled file information is
specified. </p>
<p><strong>Offset to ReplyTo e-mail address.</strong> Offset to ReplyTo e-mail
address. Use this address if you wish to have replies to your e-mail be sent to
an e-mail address other than the one specified for the FROM e-mail address.</p>
<p>The address must be in the following form: ('e-mail address').</p>
<p>A value of 0 indicates that ReplyTo e-mail addresses are not specified.</p>
<p>This field is used only when an SMTP mail server is specified in your PSF
configuration object and must be set to zero otherwise.</p>
<p><strong>Offset to subject</strong> The offset to the character string to be
used as the subject text. A value of 0 indicates that a subject is not
specified here. If you do not specify a subject, then the default subject is
obtained from message PQT4133 in message file QPQMSGF.</p>
<p>If you have specified an SMTP mail server, the CCSID of message text data
and subject will be used to convert the data to Unicode for inclusion within
the e-mail. The receiver of the e-mail may have to have the receiving e-mail
program configured for the appropriate character set to be able to view the
e-mail correctly.</p>
<br>
<h3>Integrated File System Authorizations</h3>
<dl>
<dt><em>Authority to directories in the path where the stream file
resides</em></dt>
<dd>*X</dd>
<dt><em>Public authority to stream files</em></dt>
<dd>*R</dd>
</dl>
<br>
<h3><a name="HDRSTMF">Stream file format</a></h3>
<p>Use this format only when an SMTP mail server is specified in your PSF
configuration object, and you are specifying the use of stream files for either
the body of the e-mail or additional attachments.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Total length for stream file
information</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of stream files specified</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Stream file information</td>
</tr>
</table>
<br>
<br>
<h3>Field Descriptions</h3>
<p><strong>Number of stream files specified.</strong> The number of stream
files specified within this format.</p>
<p><strong>Stream file information.</strong> The initial offset at which
information for each stream file is positioned.</p>
<p>Refer to <a href="#HDRINDVSTMF">Individual Stream file information
format</a>. for information on the format to use when specifying this
information. Use one instance of the base format for each stream file. Each
instance of this format must be contiguous to the previous one.</p>
<p><strong>Total length for stream file information.</strong> The total length
for all data used with this structure. This field is included within the
length. The value specified for this entry must be a 4-byte multiple.</p>
<br>
<h3><a name="HDRINDVSTMF">Individual Stream file information format</a></h3>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Total length of individual stream
file format</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="center" valign="top">4</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of individual stream file format</td>
</tr>
<tr>
<td align="center" valign="top">8</td>
<td align="center" valign="top">8</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Offset to path name</td>
</tr>
<tr>
<td align="center" valign="top">12</td>
<td align="center" valign="top">C</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of path name</td>
</tr>
<tr>
<td align="center" valign="top">16</td>
<td align="center" valign="top">10</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Use-specified directory</td>
</tr>
<tr>
<td align="center" valign="top">17</td>
<td align="center" valign="top">11</td>
<td align="left" valign="top">CHAR(3)</td>
<td align="left" valign="top">Reserved (set to X'00')</td>
</tr>
</table>
<br>
<br>
<h3>Field Descriptions</h3>
<p><strong>Length of individual stream file format.</strong> The length of the
structure used for the individual stream file format. This value must be
20.</p>
<p><strong>Length of path name.</strong> The length of the path name that
specifies the stream file.</p>
<p><strong>Offset to path name.</strong> The offset to the path name that
specifies the stream file. The offset is from the beginning of the base format
in which this value is specified.</p>
<p><strong>Use-specified directory.</strong> Whether the directory specified
for stream files used as either attachments or in the body of the e-mail is to
be prefixed to the name of the stream file. For example, if you have specified
'/SpecialApp/customerOne/' for a directory of files in the extension area
format, this value will be prefixed to stream file names when specified using
this field. Valid values are:</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>0</em></td>
<td align="left" valign="top">Do not prefix directory to this path name.</td>
</tr>
<tr>
<td align="left" valign="top"><em>1</em></td>
<td align="left" valign="top">Prefix directory to this path name.</td>
</tr>
</table>
<p><strong>Total length of individual stream file format.</strong> The total
contiguous length used with this format, including this field. This value is
used to determine the location of the next stream file information format. The
value specified for this entry must be a 4-byte multiple.</p>
<br>
<br>
<h3><a name="HDRPDFSPLF">Spooled file PDF distribution</a></h3>
<p>Use this format when a PDF is to be spooled as a PDF Spoolfile.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Name of output queue to spool PDF</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output queue library</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Spooled File Name</td>
</tr>
<tr>
<td align="center" valign="top">30</td>
<td align="center" valign="top">1E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User Data</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">CHAR(255)</td>
<td align="left" valign="top">User Defined Data</td>
</tr>
<tr>
<td align="center" valign="top">295</td>
<td align="center" valign="top">127</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Formtype</td>
</tr>
</table>
<h3>Field Descriptions</h3>
<p><strong>Formtype</strong> The Form type to be used for the PDF spooled
file.</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SPLF</em></td>
<td align="left" valign="top">Specifies that the form type of the original
spoolfile will be used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Formtype</em></td>
<td align="left" valign="top">Specify the form type defined data.</td>
</tr>
</table>
<p><strong>Name of output queue to spool PDF.</strong> The name of the output
queue that the PDF will be spooled on.</p>
<p>The following special values are supported for the library name:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*PSFCFG</em></td>
<td align="left" valign="top">Use value specified in the PSF Configuration
object.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Output-queue</em></td>
<td align="left" valign="top">Specify the output queue name.</td>
</tr>
</table>
<br>
<p><strong>Output queue library</strong> The library in which the output queue
to spool PDF exists.</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>Output-queue-library</em></td>
<td align="left" valign="top">Specify the output queue library name.</td>
</tr>
</table>
<p><strong>Spooled File Name</strong> The name used for the new spooled file.</p>
<p>The following special values are supported for the spooled file name:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SPLF</em></td>
<td align="left" valign="top">Use the original spooled file name for the new spooled file.</td>
</tr>
</table>
<p><strong>User Data</strong> The user data for the PDF spooled file. The
possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SPLF</em></td>
<td align="left" valign="top">Specifies that the user data of the original
spoolfile will be used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>User-data</em></td>
<td align="left" valign="top">Specify the user data.</td>
</tr>
</table>
<p><strong>User Defined Data</strong> The user defined data for the PDF spooled
file. The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SPLF</em></td>
<td align="left" valign="top">Specifies that the user defined data of the
original spoolfile will be used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>User-data</em></td>
<td align="left" valign="top">Specify the user defined data.</td>
</tr>
</table>
<p></p>
<br>
<h3><a name="HDRAFPSPLF">Spooled file AFPDS distribution</a></h3>
<p>Use this format when a Spoolfile segment is to be spooled as a AFP
Spoolfile.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Name of output queue to spool AFPDS</td>
</tr>
<tr>
<td align="center" valign="top">10</td>
<td align="center" valign="top">A</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Output queue library</td>
</tr>
<tr>
<td align="center" valign="top">20</td>
<td align="center" valign="top">14</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Spooled File Name</td>
</tr>
<tr>
<td align="center" valign="top">30</td>
<td align="center" valign="top">1E</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">User Data</td>
</tr>
<tr>
<td align="center" valign="top">40</td>
<td align="center" valign="top">28</td>
<td align="left" valign="top">CHAR(255)</td>
<td align="left" valign="top">User Defined Data</td>
</tr>
<tr>
<td align="center" valign="top">295</td>
<td align="center" valign="top">127</td>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Formtype</td>
</tr>
</table>
<h3>Field Descriptions</h3>
<p><strong>Formtype</strong> The Form type to be used for the ADPDS spooled
file.</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SPLF</em></td>
<td align="left" valign="top">Specifies that the form type of the original
spoolfile will be used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Formtype</em></td>
<td align="left" valign="top">Specify the form type defined data.</td>
</tr>
</table>
<p><strong>Name of output queue to spool AFPDS</strong> The name of the output
queue that the AFPDS will be spooled on.</p>
<p>The following special values are supported for the library name:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*PSFCFG</em></td>
<td align="left" valign="top">Use value specified in the PSF Configuration
object.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Output-queue</em></td>
<td align="left" valign="top">Specify the output queue name.</td>
</tr>
</table>
<br>
<p><strong>Output queue library</strong> The library in which the output queue
to spool AFPDS exists.</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>Output-queue-library</em></td>
<td align="left" valign="top">Specify the output queue library name.</td>
</tr>
</table>
<p><strong>Spooled File Name</strong> The name used for the new spooled file.</p>
<p>The following special values are supported for the spooled file name:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SPLF</em></td>
<td align="left" valign="top">Use the original spooled file name for the new spooled file.</td>
</tr>
</table>
<p><strong>User Data</strong> The user data for the AFPDS spooled file. The
possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SPLF</em></td>
<td align="left" valign="top">Specifies that the user data of the original
spoolfile will be used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>User-data</em></td>
<td align="left" valign="top">Specify the user data.</td>
</tr>
</table>
<p><strong>User Defined Data</strong> The user defined data for the AFPDS
spooled file. The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*SPLF</em></td>
<td align="left" valign="top">Specifies that the user defined data of the
original spoolfile will be used.</td>
</tr>
<tr>
<td align="left" valign="top"><em>User-defined-data</em></td>
<td align="left" valign="top">Specify the user defined data.</td>
</tr>
</table>
<p></p><br>
<h3><a name="HDRPDFENC">PDF
Encryption Structure</a></h3>
<p>Use this format when a PDF is to be encrypted.</p>
<table border width="80%">
<tr>
<th align="center" valign="bottom" colspan="2">Offset</th>
<th align="left" valign="bottom" rowspan="2">Type</th>
<th align="left" valign="bottom" rowspan="2">Field</th>
</tr>
<tr>
<th align="center" valign="bottom">Dec</th>
<th align="center" valign="bottom">Hex</th>
</tr>
<tr>
<td align="center" valign="top" width="10%">0</td>
<td align="center" valign="top" width="10%">0</td>
<td align="left" valign="top" width="20%">CHAR(32)</td>
<td align="left" valign="top" width="60%">PDF Master Password</td>
</tr>
<tr>
<td align="center" valign="top">32</td>
<td align="center" valign="top">20</td>
<td align="left" valign="top">CHAR(32)</td>
<td align="left" valign="top">PDF User Password</td>
</tr>
<tr>
<td align="center" valign="top">64</td>
<td align="center" valign="top">40</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">PDF Printing</td>
</tr>
<tr>
<td align="center" valign="top">65</td>
<td align="center" valign="top">41</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">PDF Document Changing</td>
</tr>
<tr>
<td align="center" valign="top">66</td>
<td align="center" valign="top">42</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">PDF Copy Document</td>
</tr>
<tr>
<td align="center" valign="top">67</td>
<td align="center" valign="top">43</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">PDF Encryption Level</td>
</tr>
<tr>
<td align="center" valign="top">68</td>
<td align="center" valign="top">44</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">PDF Content Access Enablement</td>
</tr>
<tr>
<td align="center" valign="top">69</td>
<td align="center" valign="top">45</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">PDF Changing Comments</td>
</tr>
<tr>
<td align="center" valign="top">70</td>
<td align="center" valign="top">46</td>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">PDF Document Assembly</td>
</tr>
</table>
<br>
<br>
<h3>Field Descriptions</h3>
<p><strong>PDF Content Access Enablement.</strong> Specify the PDF viewer's
security settings for content access to the PDF document.<I>(Only configurable with 128-bit encryption.For 40-bit, set to '0'.)</I></p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'0'</em></td>
<td align="left" valign="top">Content Access not enabled. </td>
</tr>
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">Content Access enabled</td>
</tr>
</table>
<p><strong>PDF Changing Comments.</strong> Specify the PDF viewer's security settings for
adding or modifying text annotations in the PDF document. </p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'0'</em></td>
<td align="left" valign="top">Comments not allowed</td>
</tr>
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">Comments allowed</td>
</tr>
</table>
<p><strong>PDF Copy.</strong> Specify the PDF viewer's security settings for
copying from the PDF document.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'0'</em></td>
<td align="left" valign="top">Copy not allowed</td>
</tr>
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">Copy allowed</td>
</tr>
</table>
<p><strong>PDF Document Assembly.</strong> Specify the PDF viewer's security settings for
document assembly from the PDF document.<I>(Only configurable with 128-bit encryption. For 40-bit, set to '0'.)</I></p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'0'</em></td>
<td align="left" valign="top">Assembly not allowed</td>
</tr>
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">Assembly allowed</td>
</tr>
</table>
<p><strong>PDF Document Changing.</strong> Specify the PDF viewer's security
settings for changing the PDF document.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'0'</em></td>
<td align="left" valign="top">Changing not allowed</td>
</tr>
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">Changing allowed</td>
</tr>
</table>
<p><strong>PDF Encryption Level.</strong> Specify the encryption level the PDF
document using PDF Viewer security settings.</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">40-bit</td>
</tr>
<tr>
<td align="left" valign="top"><em>'2'</em></td>
<td align="left" valign="top">128-bit</td>
</tr>
</table>
<p> <strong>PDF Master Password.</strong> A string of up to 32 alphanumeric
letters and/or numbers. Acceptable characters are A-Z, a-z and 0-9.
X'00' will indicate that there is no password on this
document.</p>
<table cellpadding="5">
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">No master password specified.</td>
</tr>
</table>
<p> <strong>PDF Printing.</strong> Specify the PDF viewer's security settings
for printing the PDF document</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td align="left" valign="top"><em>'0'</em></td>
<td align="left" valign="top">Not Allowed</td>
</tr>
<tr>
<td align="left" valign="top"><em>'1'</em></td>
<td align="left" valign="top">Allowed</td>
</tr>
<tr>
<td align="left" valign="top"><em>'2'</em></td>
<td align="left" valign="top">Low Resolution Printing.<I>(Only configurable with 128-bit encryption.)</I>.</td>
</tr>
</table>
<p> <strong>PDF User Password.</strong> A string of up to 32 alphanumeric
letters and/or numbers. Acceptable characters are A-Z, a-z and 0-9.
X'00' will indicate that there is no password on this
document.</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td align="left" valign="top"><em>*NONE</em></td>
<td align="left" valign="top">No user password specified.</td>
</tr>
</table>
<p></p>
<hr>
Exit program introduced: V5R1
<hr>
<table align="center" cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"print1.htm">Print APIs</a> | <a href="aplist.htm">APIs by category</a></td>
</tr>
</table>
</body>
</html>
Reference in New Issue Copy Permalink