2250 lines
75 KiB
HTML
2250 lines
75 KiB
HTML
<!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>Add PDF Map Entry (QPQAPME) API</title>
|
|
<!-- Begin Header Records -->
|
|
<!-- 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. -->
|
|
<!-- Created by Tim Aden for V5R3-->
|
|
<!-- Change History: -->
|
|
<!-- YYMMDD USERID Change description -->
|
|
<!-- 0300508 JETAYLOR html cleanup -->
|
|
<!-- End Header Records -->
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body>
|
|
<a name="Top_Of_Page"></a>
|
|
<!--Java sync-link-->
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
|
|
</script>
|
|
|
|
<h2>Add PDF Map Entry (QPQAPME) API</h2>
|
|
|
|
<div class="box" style="width: 80%;">
|
|
<br>
|
|
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%">Returned library name</td>
|
|
<td align="left" valign="top" width="20%">Output</td>
|
|
<td align="left" valign="top" width="20%">Char(10)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">2</td>
|
|
<td align="left" valign="top">Qualified PDF map object name</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(20)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">3</td>
|
|
<td align="left" valign="top">PDF map entry spooled file attributes</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(*)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">Length of PDF map entry spooled file attributes</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">Format of PDF map entry spooled file attributes</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(8)</td>
|
|
</tr>
|
|
|
|
|
|
<tr>
|
|
<td align="center" valign="top">6</td>
|
|
<td align="left" valign="top">PDF mapping action</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(*)</td>
|
|
</tr>
|
|
|
|
|
|
<tr>
|
|
<td align="center" valign="top">7</td>
|
|
<td align="left" valign="top">Length of PDF mapping action</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Binary(4)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">Format of PDF mapping action</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(8)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">9</td>
|
|
<td align="left" valign="top">Add type</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Binary(4)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="left" valign="top">Error code</td>
|
|
<td align="left" valign="top">I/O</td>
|
|
<td align="left" valign="top">Char(*)</td>
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
<br>
|
|
Default Public Authority: *Use<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Threadsafe: Yes<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
<p>The Add PDF Map Entry (QPQAPME) API inserts an entry into the specified
|
|
PDF Map object. You can retrieve the current entries by using the Open List of PDF Map Information (QPQOLPM) API.</p>
|
|
|
|
<p>This API allows you to set up PDF mapping entries for spooled files you want processed after they have been converted to PDF.</p>
|
|
|
|
<p>There are two types of entries. Segmented and non-segmented. Segmented entries are for spooled files that are divided into multiple PDF files. The division is be based upon the use of the STRPAGGRP DDS keyword and other products such as the AFP Toolbox or the Infoprint Server. For all segmented entries of a spooled file, the input spooled file criteria(format APME0100), all the selection parameters should be the same except the mail tag information. Non-segmented entries are for spooled files that will be converted to one PDF file.</p>
|
|
|
|
<p>The entry consists of two parts:</p>
|
|
<ul>
|
|
<li>Selection for the input spooled file. You can specify which spooled file attributes should be used to match a spooled file being converted to PDF. This information is used by products , such as Infoprint Server to determine what additional processing needs to be done with the PDF file.
|
|
<p> The selection for the input spooled file includes such spool attributes as output queue name and library, spooled file name, job name,user name, user data, form type, mail tag, and also a sequence number. To allow for the input selection criteria of multiple entries in the PDF map which can match a particular spooled file, the entries are sorted in the order of the sequence number specified. Multiple entries can be a match for a spooled file because generic and *ALL are supported as part of input selection criteria, for example output queue, file, job name, user name, user data, and form type.</p></li>
|
|
<li>PDF map actions for the spooled file. For each spooled file or segmented entry of a spooled file, you may define one or more map actions and their associated parameters. The supported actions are e-mail, stream file, PDF respool, and AFPDS respool.</li>
|
|
</ul>
|
|
|
|
<p>For e-mail, you can enter the following additional information:</p>
|
|
<ul>
|
|
<li>Tolist, Copy Control, and Blind Copy Control</li>
|
|
<li>Subject of email</li>
|
|
<li>Body of e-mail</li>
|
|
<li>Attachments (in addition to PDF spool file)</li>
|
|
<li>Reply to address</li>
|
|
<li>Mail sender</li>
|
|
</ul>
|
|
|
|
<p>For stream file, you can enter the following additional information:</p>
|
|
<ul>
|
|
<li>Full path name where stream file will be stored in Integrated File System</li>
|
|
<li>Authority for PDF stream file</li>
|
|
</ul>
|
|
|
|
<p>For re-spooling PDF file, you can enter the following additional information:</p>
|
|
<ul>
|
|
<li>Output queue name</li>
|
|
<li>File name</li>
|
|
<li>User data</li>
|
|
<li>User defined data</li>
|
|
<li>Form type</li>
|
|
</ul>
|
|
|
|
<p>For re-spooling AFPDS file, you can enter the following additional information:</p>
|
|
<ul>
|
|
<li>Output queue name</li>
|
|
<li>File name</li>
|
|
<li>User data</li>
|
|
<li>User defined data</li>
|
|
<li>Form type</li>
|
|
</ul>
|
|
|
|
<p>When you request to add an entry to a PDF Map object, the request may not be
|
|
successful in the following situations:</p>
|
|
|
|
<ul>
|
|
<li>The entry you requested to add already exists in the PDF Map. For non-segmented entries, the sequence number must be unique. For segmented entries (which all have the same sequence number), the mail tag must be unique.</li>
|
|
|
|
<li>The user profile storage limit is exceeded when an entry is added.</li>
|
|
|
|
</ul>
|
|
|
|
|
|
<br>
|
|
<h3>Authorities and Locks</h3>
|
|
|
|
<dl>
|
|
<dt><em>Library authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
|
|
<dt><em>PDF Map object authority</em></dt>
|
|
|
|
<dd>*CHANGE</dd>
|
|
|
|
<dt><em>PDF Map object lock</em></dt>
|
|
|
|
<dd>*EXCL</dd>
|
|
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
<h3>Required Parameter Group</h3>
|
|
|
|
<dl>
|
|
|
|
<dt><strong>Returned library name</strong></dt>
|
|
|
|
<dd>OUTPUT; CHAR(10)
|
|
|
|
<p>The name of the library that contains the PDF map object to which the entry
|
|
was added if it was added successfully. This parameter is not set if the
|
|
entry was not successfully added. This information helps you identify the
|
|
specific library used when *LIBL or *CURLIB is specified in the qualified PDF
|
|
map object name parameter.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Qualified Map object name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(20)
|
|
|
|
<p>The Map object for which you would like to add information. The
|
|
qualified object name has two parts. The first 10 characters contain the object
|
|
name.</p>
|
|
|
|
<p>The second 10 characters contain the name of the library in which the object
|
|
is located.</p>
|
|
|
|
<p>The following special values are allowed:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
|
<td align="left" valign="top">The job's current library is used to locate the
|
|
object. If no library is specified as the current library for the job, the QGPL
|
|
library is used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
|
<td align="left" valign="top">The library list is used to locate the object.</td>
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<p>The actual library that is used is returned in the Returned library name parameter.</p>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>PDF map entry spooled file attributes</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(*)
|
|
|
|
<p>The PDF map entry spooled file attributes for the entry to be added to the PDF map object. The parameter uniquely identifies the entry in the PDF map object.</p>
|
|
|
|
<p>Specify which spooled file attributes should be used to match a spooled file being converted to PDF.</p>
|
|
<br><br>
|
|
</dd>
|
|
|
|
<dt><strong>Length of PDF map entry spooled file attributes</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)
|
|
|
|
<p>The length of the PDF map entry spooled file attributes parameter. This value must be greater than or equal to 4.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Format of PDF map entry spooled file attributes</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(8)
|
|
|
|
<p>The format of the PDF map for the entry to be added to the PDF map object.</p>
|
|
|
|
<p>The valid format names are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="25 75" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em><a href="#HDRMAP100">APME0100</a></em></td>
|
|
<td align="left" valign="top">Contains the input selection criteria for the entry. This
|
|
includes a sequence number for the entry and spooled file information, such as output queue, spooled file name, job name,
|
|
user name, user data, form type, and mail tag.</td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
</dd>
|
|
|
|
|
|
<dt><strong>PDF mapping action</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(*)
|
|
|
|
<p>The PDF mapping action for the entry to be added to the PDF map object.</p>
|
|
|
|
<p>See <a href="#HDRMAP200">Format for PDF mapping action</a> for
|
|
details on the data structure.</p>
|
|
|
|
</dd>
|
|
|
|
<dt><strong>Length of PDF mapping action</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)
|
|
|
|
|
|
<p>The length of the PDF mapping action parameter. This value must be greater than or equal to 8.</p>
|
|
</dd>
|
|
|
|
|
|
<dt><strong>Format of PDF mapping action</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(8)
|
|
|
|
<p>The format of the PDF mapping action to be added to the PDF map object.</p>
|
|
|
|
<p>The valid format names are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="25 75" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em><a href="#HDRMAP100">PMAP0100</a></em></td>
|
|
<td align="left" valign="top">Contains the mapping action for the entry. This can include
|
|
mail information, PDF stream file information, PDF and AFPDS spooled file information, and a spooled file segmentation indicator.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
</dd>
|
|
|
|
|
|
<dt><strong>Add type</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)
|
|
|
|
<p>The type of add to be performed.</p>
|
|
|
|
<p>Valid values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td valign="top"><em>1</em></td>
|
|
<td valign="top">Insert with replacement
|
|
|
|
<p>This value requests to replace the PDF map portion of the entry if the
|
|
PDF map entry spooled file attributes is already in the PDF map object. If
|
|
the entry does not exist, it will be added into the PDF map object.</p>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top"><em>2</em></td>
|
|
<td valign="top">Add without replacement
|
|
|
|
<p>This value requests to add the entry only if the PDF map entry spooled file attributes portion of the entry is not already in PDF map object. If the entry does not
|
|
exist, it will be added into the PDF map object. If the entry is already in the
|
|
PDF map object, an error is returned.</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
|
|
|
|
<dt><strong>Error code</strong></dt>
|
|
|
|
<dd>I/O; CHAR(*)
|
|
|
|
<p>The structure in which to return error information. For the format of the
|
|
structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRMAP100">APME0100 Format</a></h3>
|
|
|
|
<p>For more details about the fields in the following table, see <a href=
|
|
"#APMEFIELDD">APME0100 Format Field Descriptions</a>.</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%">Sequence number of entry</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Output queue name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="center" valign="top">E</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Output queue library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">24</td>
|
|
<td align="center" valign="top">18</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">34</td>
|
|
<td align="center" valign="top">18</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Job name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">44</td>
|
|
<td align="center" valign="top">2C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">User name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">54</td>
|
|
<td align="center" valign="top">36</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">User data</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">64</td>
|
|
<td align="center" valign="top">40</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Form type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">74</td>
|
|
<td align="center" valign="top">4A</td>
|
|
<td align="left" valign="top">CHAR(250)</td>
|
|
<td align="left" valign="top">Mail tag</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">324</td>
|
|
<td align="center" valign="top">144</td>
|
|
<td align="left" valign="top">CHAR(2)</td>
|
|
<td align="left" valign="top">Reserved - initalized to null</td>
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
<h3><a name="APMEFIELDD">APME0100 Format Field Descriptions</a></h3>
|
|
|
|
<p><strong>Form type.</strong> The type of forms that should
|
|
be loaded on the printer before this spooled file is printed.
|
|
A least one form type or special value must be specified.
|
|
This field can be
|
|
used in conjunction with the output queue name, spooled file name, user,
|
|
user data, and mail tag to select a spooled file to be processed.</p>
|
|
|
|
<p>The following special values can be used for the form type:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Specifies that all form types will be considered a match regardless
|
|
of the value for form type.</td>
|
|
</tr>
|
|
</table>
|
|
<p>A default of *ALL is assumed if the form type is not specified.</p>
|
|
|
|
<p><strong>Job name.</strong> The name of the job for the spooled file. At
|
|
least one job name or special value must be specified. This field can be
|
|
used in conjunction with the output queue name, spooled file name,
|
|
form type, and mail tag to to select a spooled file to be processed.</p>
|
|
|
|
<p>The following special value is used for the job name:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">
|
|
Specifies that all job names will be considered a match for input selection regardless of the job name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*Generic*-job</em></td>
|
|
<td align="left" valign="top">Specify the generic name of a job. A generic name is a character
|
|
string followed by an askerisk(*). If you specify a generic name, all user names that begin
|
|
with the generic name are considered a match in the input selection
|
|
</td>
|
|
</tr>
|
|
|
|
</table>
|
|
<p>A default of *ALL is assumed if the job name is not specified.</p>
|
|
|
|
|
|
<p><strong>Mail tag.</strong> Specifies the mail tag for the spooled file. For non-segmented spooled files, the mail tag is specified on the CRTPRTF, CHGPRTF, or OVRPRTF commands using the USRDFNDTA parameter. For segmented spooled files, the mail tag is specified on the STRPAGGRP DDS keyword. This field can be used in conjunction with the output queue name,
|
|
spooled file name, user,
|
|
user data, and form type to select a spooled file to be processed.</p>
|
|
|
|
<p>Here is information on specifying a mail tag:</p>
|
|
|
|
<ul>
|
|
<li>Embedded blanks will be used as part of the mail tag.</li>
|
|
<li>Do not use single quotes around the text string, as they will be interpreted as part
|
|
of the text string.</li>
|
|
<li>Case is preserved.</li>
|
|
</ul>
|
|
|
|
<p>The following special values can be used for the mail tag:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">
|
|
Specifies that all mail tags will be considered a match in the input selection regardless of the value for mail tag.</td>
|
|
</tr>
|
|
</table>
|
|
<p>A default of *ALL is assumed if the mail tag is not specified.</p>
|
|
|
|
|
|
<p><strong>Output queue library name.</strong> The name of the library where
|
|
the output queue resides.</p>
|
|
|
|
<p><strong>Output queue name.</strong> The name of the output queue in which the spooled file is located. At
|
|
least one output queue or special value must be specified.
|
|
This field can be
|
|
used in conjunction with the spooled file name, user,
|
|
form type, and
|
|
mail tag to select to select a spooled file to be processed.</p>
|
|
|
|
<p>The following special value is used for the output queue name:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">
|
|
Specifies that all ouput queues will be considered a match in the input selection regardless of the output queue name. When
|
|
this value is specified, the output queue library name must be blanks.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*Generic*-output-queue</em></td>
|
|
<td align="left" valign="top">
|
|
Specify the generic name of an output queue. A generic name is a character string of one or more
|
|
characters followed by an askerisk(*). If you specify a generic value, all output queues
|
|
with the names that begin with the generic name are considered a match in the input selection
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Reserved - initalized to null.</strong> A reserved field.</p>
|
|
|
|
<p><strong>Sequence number of entry.</strong> The user-defined sequence number for an entry
|
|
in a PDF Map object. To allow for the input selection criteria of multiple entries in the PDF map that can match a particular spooled file, the entries are sorted in the order of the sequence numbers. Multiple entries can be a match for a spooled file because generic and *ALL are supported as part of input selection criteria, for example output queue, file, user name, user data, and form type.</p>
|
|
|
|
<p><strong>Spooled file name.</strong> The name of the spooled file. At
|
|
least one spooled file name or special value must be specified. This field can be
|
|
used in conjunction with the output queue name, user,
|
|
form type, and
|
|
mail tag to to select a spooled file to be processed.</p>
|
|
|
|
<p>The following special value is used for the output queue name:</p>
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">
|
|
Specifies that all spooled file names will be considered a match in the input selection regardless of the spooled file name.</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><em>*Generic*-spooled-file</em></td>
|
|
<td align="left" valign="top">Specify the generic name of a spooled file. A generic name is
|
|
a character string followed by an askerisk(*). If you specify a generic name, all spooled
|
|
files with the names that begin with the generic name are considered a match in the input
|
|
selection
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>A default of *ALL is assumed if the spooled file name is not specified.</p>
|
|
|
|
|
|
<p><strong>User data.</strong> The value of the user data.
|
|
You must specify user data or a special value.
|
|
This field can be
|
|
used in conjunction with the output queue name, spooled file name, user,
|
|
form type, and mail tag to selectto select a spooled file to be processed.</p>
|
|
|
|
<p>The following special value is used for the user data:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">
|
|
Specifies that all user data will be considered a match in the input selection regardless of the user data.</td>
|
|
</tr>
|
|
</table>
|
|
<p>A default of *ALL is assumed if the user data is not specified.</p>
|
|
|
|
|
|
<p><strong>User name.</strong> The name of the user that created the spooled file. At
|
|
least one user name or special value must be specified. This field can be
|
|
used in conjunction with the output queue name, spooled file name,
|
|
form type, and mail tag to to select a spooled file to be processed.</p>
|
|
|
|
<p>The following special value is used for the output queue name:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">
|
|
Specifies that all user names will be considered a match for input selection regardless of the user name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*Generic*-user-name</em></td>
|
|
<td align="left" valign="top">Specify the generic name of a user. A generic name is a
|
|
character string followed by an askerisk(*). If you specify a generic name, all user names
|
|
that begin with the generic name are considered a match in the input selection
|
|
</td>
|
|
</tr>
|
|
|
|
|
|
</table>
|
|
<p>A default of *ALL is assumed if the user name is not specified.</p>
|
|
<br>
|
|
|
|
<h3><a name="HDRMAP200">PMAP0100 Format</a></h3>
|
|
|
|
<p>For more details about the fields in the following table, see <a href=
|
|
"#PMAPFIELDD">PMAP0100 Field Descriptions</a>.</p>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="top" 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%">Offset to mail information entry</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 to mail information entry</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 PDF stream file information</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 to PDF stream file information</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">Offset to PDF spooled file information</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">Length of PDF spooled file information</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">Offset to AFPDS spooled file information</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">Length of AFPDS spooled file information</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">32</td>
|
|
<td align="center" valign="top">20</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Segmented entry</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">33</td>
|
|
<td align="center" valign="top">21</td>
|
|
<td align="left" valign="top">CHAR(50)</td>
|
|
<td align="left" valign="top">Text description</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">83</td>
|
|
<td align="center" valign="top">53</td>
|
|
<td align="left" valign="top">CHAR(49)</td>
|
|
<td align="left" valign="top">Reserved - initalized to null</td>
|
|
</tr>
|
|
</table>
|
|
<br><br>
|
|
<h3><a name="PMAPFIELDD">PMAP0100 Field Descriptions</a></h3>
|
|
|
|
<p><strong>Length of AFPDS spooled file information.</strong> The size, in bytes, of the AFPDS
|
|
Spooled file information entry.
|
|
For information on the format of a Spooled file information entry, see
|
|
<a href= "#HDRAFPSPLFI">AFPDS Spooled File Information Entry</a>.</p>
|
|
|
|
<p><strong>Length of mail information entry.</strong> The size, in bytes, of the mail
|
|
information entry.
|
|
For information on the format of a mail information entry, see
|
|
<a href= "#HDROMAIL">Mail information Entry</a>.</p>
|
|
|
|
<p><strong>Length of PDF spooled file information.</strong> The size, in bytes, of the PDF spooled file information entry.
|
|
For information on the format of a spooled file information entry, see
|
|
<a href= "#HDRPDFSPLFI">PDF Spooled File Information Entry</a>.</p>
|
|
|
|
<p><strong>Length of PDF stream file information.</strong> The size, in bytes, of the PDF stream
|
|
file information entry. This identifies the path where PSF/400 has written the PDF stream file.
|
|
For information on the format of a stream file entry, see
|
|
<a href= "#HDRPDFSTMF">PDF Stream File Information Entry</a>.</p>
|
|
|
|
<p><strong>Offset to AFPDS spooled file information.</strong> The offset, in bytes,
|
|
from the beginning of the PMAP0100 format structure, to an AFPDS Spooled File Information
|
|
entry. If this value is 0, an AFPDS Spooled File Information entry is not specified.</p>
|
|
|
|
<p><strong>Offset to mail information entry.</strong> The offset, in bytes, from
|
|
the beginning of the PMAP0100 format, to a Mail information entry.</p>
|
|
|
|
<p><strong>Offset to PDF spooled file information.</strong> The offset, in bytes, from
|
|
the beginning of the PMAP0100 format, to a Spooled File Information entry. </p>
|
|
|
|
<p><strong>Offset to PDF stream file information.</strong> The offset, in bytes, from
|
|
the beginning of the PMAP0100 format, to a PDF Stream File Information entry.</p>
|
|
|
|
<p><strong>Reserved - initalized to null.</strong> A reserved field.</p>
|
|
|
|
<p><strong>Segmented entry.</strong> Indicates whether an entry is a segment.
|
|
Segmented entries are for AFPDS spooled file that is divided into multiple PDF files. The division would be based upon the use of the STRPAGGRP DDS keyword, the Toolbox APIs, or sucs products as as Infoprint Server.</p>
|
|
|
|
<p>The following values are used:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The entry is not a segment.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The entry is a segment.</td>
|
|
</tr>
|
|
</table>
|
|
<p>If the segmented entry indicator is not specified, then 0 is assumed
|
|
(entry is not segmented). </p>
|
|
|
|
<p><strong>Text description.</strong> A brief description of the PDF Map entry.</p>
|
|
<br>
|
|
|
|
<h3><a name="HDROMAIL">Mail Information Entry</a></h3>
|
|
|
|
<p>Information in this table should be filled in when e-mail is being requested for a PDF map. If e-mail is not being requested, the length of mail information and offset to mail information fields above should be set to 0. For more details about the fields in the following table, see
|
|
<a href=
|
|
"#MAILINFOFIELDD">Mail Information Entry Field Descriptions</a>.</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%">Offset to message text</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</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 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">Length of subject</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">CCSID of message text and subject</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 ReplyTo e-mail address</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 ReplyTo e-mail address</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 TO e-mail address entries</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">Number of TO e-mail address entries</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">Length of TO e-mail address entry</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 CC e-mail address entries</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">Number of CC e-mail address entries</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">Length of CC e-mail address entry</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 BCC e-mail address entries</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">Number of BCC e-mail address entries</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">Length of BCC e-mail address entry</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">Offset to Body of e-mail entries</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">Number of Body of e-mail entries</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 Body of e-mail entry</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 attachment e-mail entries</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">Number of attachment e-mail entries</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">Length of attachment e-mail entry</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">Offset to TO e-mail stream file</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">Length of TO e-mail stream file</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">Offset to CC e-mail stream file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">100</td>
|
|
<td align="center" valign="top">64</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Length of CC e-mail stream file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">104</td>
|
|
<td align="center" valign="top">68</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Offset to BCC e-mail stream file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">108</td>
|
|
<td align="center" valign="top">6C</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Length of BCC e-mail stream file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">112</td>
|
|
<td align="center" valign="top">70</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Offset to PDF file for e-mail</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">116</td>
|
|
<td align="center" valign="top">74</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Length of PDF file for e-mail</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">120</td>
|
|
<td align="center" valign="top">78</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Mail Sender</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">130</td>
|
|
<td align="center" valign="top">82</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">User password</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">140</td>
|
|
<td align="center" valign="top">8C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Owner password</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">150</td>
|
|
<td align="center" valign="top">96</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Encryption level</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">160</td>
|
|
<td align="center" valign="top">A0</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Print PDF file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">170</td>
|
|
<td align="center" valign="top">AA</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Copy PDF file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">180</td>
|
|
<td align="center" valign="top">B4</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Change PDF file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">190</td>
|
|
<td align="center" valign="top">BE</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Change Comments in PDF file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">200</td>
|
|
<td align="center" valign="top">C8</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Content Access to PDF file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">210</td>
|
|
<td align="center" valign="top">D2</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Use stream file for TO e-mail address entries</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">211</td>
|
|
<td align="center" valign="top">D3</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Use stream file for CC e-mail address entries</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">212</td>
|
|
<td align="center" valign="top">D6</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Use stream file for BCC e-mail address entries</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">213</td>
|
|
<td align="center" valign="top">D5</td>
|
|
<td align="left" valign="top">CHAR(43)</td>
|
|
<td align="left" valign="top">Reserved - initialized to null</td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
<h3><a name="MAILINFOFIELDD">Mail Information Entry Field Descriptions</a></h3>
|
|
|
|
<p><strong>CCSID of message text
|
|
and subject.</strong> The CCSID associated with the message text 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">Use the job's default CCSID.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" nowrap><em>ccsid-value</em></td>
|
|
<td align="left" valign="top">Specifies the CCSID. Values are in the range 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>Change Comments in PDF file.</strong> This field is applicable only for
|
|
an Encryption Level of *40RC4. Specifies whether users are
|
|
allowed to add or change comments (annotations) or form fields in the PDF file.</p>
|
|
|
|
<p>The following special values are used:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*YES</em></td>
|
|
<td align="left" valign="top">The user is allowed to change the PDF file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NO</em></td>
|
|
<td align="left" valign="top">The user is not allowed to change the PDF file.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
|
|
<p><strong>Change PDF file.</strong> This field is applicable for Encryption levels *40RC4
|
|
and *128RC4. The definition is different for the type of Encryption level.</p>
|
|
|
|
<p> For an Encryption level of *40RC4, Change PDF file specifies whether users are allowed
|
|
to change the document, or to prevent them from creating form fields, as well as making any
|
|
other changes.</p>
|
|
|
|
<p>When the Encryption level is *40RC4, the following special values are used:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*YES</em></td>
|
|
<td align="left" valign="top">The user is allowed to change the PDF file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NO</em></td>
|
|
<td align="left" valign="top">The user is not allowed to change the PDF file.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p> For an Encryption level of *128RCR, Change PDF file specifies the types of changes
|
|
which are allowed for the PDF file.</p>
|
|
|
|
<p>When the Encryption level is *128RCR, the following special values are used:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">The user is not allowed to change the PDF file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ASSEMBLY</em></td>
|
|
<td align="left" valign="top">The user is allowed document assemply to let user's insert
|
|
delete, rotate pages, and create bookmarks and thumbnails.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Content Access to PDF file.</strong> Specifies whether content accessibility for
|
|
the visually impaired is enabled for the PDF file.</p>
|
|
|
|
<p>This field is applicable only for an Encryption Level of *128RCR.</p>
|
|
|
|
<p>When the Encryption level is *128RCR, the following special values are used:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*YES</em></td>
|
|
<td align="left" valign="top">content accessibility for the visually impaired is enabled
|
|
in the PDF file..</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NO</em></td>
|
|
<td align="left" valign="top">Content accessibility for the visually impaired is disabled
|
|
in the PDF file. .</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Copy PDF file.</strong> Specifies whether users are allowed to copy or extract text
|
|
and graphics. Also specifies whether the accessibility interface is disabled. </p>
|
|
|
|
<p>This field is applicable for Encryption levels *40RC4 and *128RCR. </p>
|
|
|
|
<p>The following special values are used for Copy PDF file:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*YES</em></td>
|
|
<td align="left" valign="top">The user is allowed to copy and extract text and graphics
|
|
in the PDF file. The accessibility interface is enabled.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NO</em></td>
|
|
<td align="left" valign="top">The user is not allowed to copy and extract text and graphics
|
|
in the PDF file. The accessibility interface is disabled.</td>
|
|
</tr> </table>
|
|
|
|
<p><strong>Encryption level.</strong> The encryption level for the PDF file.</p>
|
|
|
|
<p>The following special values are used for the encryption level:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">The file is not encrypted.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*40RCR</em></td>
|
|
<td align="left" valign="top">The PDF file is created with the 40-bit RC4 encryption level.
|
|
This level of encryption has a lower level of security that is compatible
|
|
with Adobe Acrobat Reader 3.X, 4.X, and 5.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*128RCR</em></td>
|
|
<td align="left" valign="top"> The PDF file is created with the 128-bit RC4 encryption level.
|
|
This level of encryption is has a higher level of security but is only compatible with
|
|
Adobe Acrobat 5.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Length of attachment e-mail entry.</strong> The size, in bytes, of each entry used for
|
|
naming an e-mail attachment. Use one entry for each stream file. The entries must be concatenated,
|
|
as in an array. For information on the format of a stream file entry, see
|
|
<a href= "#HDRSTMF">Stream File Entry</a>.</p>
|
|
|
|
<p>This field is used only when an SMTP mail server is specified in your PSF
|
|
configuration object.</p>
|
|
|
|
<p><strong>Length of BCC e-mail address entry.</strong> The size, in bytes, of each E-mail Address entry used for the BCC of an e-mail. For information on the format of an
|
|
e-mail addresses entry, see <a href= "#HDREMAIL">E-mail Address Entry</a>.</p>
|
|
|
|
<p>Use stream file for BCC e-mail address entries should be set to 0.</p>
|
|
|
|
<p>This field is used only when an SMTP mail server is specified in your PSF
|
|
configuration object.</p>
|
|
|
|
<p><strong>Length of BCC e-mail stream file.</strong> The size, in bytes, of the Stream
|
|
File entry which lists the BCCs used for an e-mail.
|
|
For information on the format of an
|
|
e-mail addresses entry, see <a href= "#HDRSTMF">Stream File Entry</a>.</p>
|
|
|
|
<p>Use stream file for BCC e-mail address entries should be set to 1.</p>
|
|
|
|
<p>This field is used only when an SMTP mail server is specified in your PSF
|
|
configuration object.</p>
|
|
|
|
<p><strong>Length of Body of e-mail entry.</strong> The size, in bytes, of each entry used for
|
|
naming a stream file placed into the body of the e-mail. Use one entry for each stream file.
|
|
The entries must be concatenated, as in an array.
|
|
For information on the format of a stream file entry,
|
|
see <a href= "#HDRSTMF">Stream File Entry</a>.</p>
|
|
|
|
<p>This field is used only when an SMTP mail server is specified in your PSF
|
|
configuration object.</p>
|
|
|
|
<p><strong>Length of CC e-mail address entry.</strong> The size, in bytes, of each E-mail
|
|
Address entry used for the CC of an e-mail. For information on the format of an
|
|
e-mail addresses entry, see <a href= "#HDREMAIL">E-mail Address Entry</a>.</p>
|
|
|
|
<p>Use stream file for CC e-mail address entries should be set to 0.</p>
|
|
|
|
<p>This field is used only when an SMTP mail server is specified in your PSF
|
|
configuration object.</p>
|
|
|
|
<p><strong>Length of CC e-mail stream file.</strong> The size, in bytes, of the Stream
|
|
File entry containing the stream file which lists the CCs used for an e-mail. For information on the format of a stream file
|
|
entry, see <a href= "#HDRSTMF">Stream File Entry</a>.</p>
|
|
|
|
<p>Use stream file for CC e-mail address entries should be set to 1.</p>
|
|
|
|
<p>This field is used only when an SMTP mail server is specified in your PSF
|
|
configuration object.</p>
|
|
|
|
<!--<p><strong>Length of Error information.</strong> The size, in bytes,-->
|
|
|
|
<p><strong>Length of message text.</strong> The size, in bytes,
|
|
of the message text that getsplaced into the body of the e-mail.</p>
|
|
|
|
<p>The following special values can be used for the message text:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">No message text will be included in the body of the e-mail.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>If the length of the message text is 0, then
|
|
the default message text is obtained from message PQT4133 in
|
|
message file QPQMSGF.</p>
|
|
|
|
<p><strong>Length of PDF file for e-mail</strong> The size, in bytes, of a File Name
|
|
Entry. This identifies the name to be used for the PDF file produced from
|
|
a spooled file, that is attached to an e-mail.
|
|
For information on the format of a file name entry, see
|
|
<a href= "#HDRFILENAME">File Name Entry</a>.</p>
|
|
|
|
<p><strong>Length of ReplyTo to e-mail address.</strong> The size, in bytes, of an E-mail
|
|
Address entry used for the ReplyTo of an e-mail. For information on the format of an
|
|
e-mail addresses entry, see <a href= "#HDREMAIL">E-mail Address Entry</a>.</p>
|
|
|
|
<p>This field is used only when an SMTP mail server is specified in your PSF
|
|
configuration object.</p>
|
|
|
|
<p>The following special values can be used for the ReplyTo e-mail address:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*MAILSENDER</em></td>
|
|
<td align="left" valign="top">Replies will be sent to the FROM e-mail address.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Length of subject.</strong> The size, in bytes,
|
|
of the text that is used for the subject of the e-mail.</p>
|
|
|
|
<p>The following special values can be used for the subject:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">No subject will be used in the body of the e-mail.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>If the length of the subject is 0, then
|
|
the default subject is obtained from message PQT4133 in
|
|
message file QPQMSGF.</p>
|
|
|
|
<p><strong>Length of TO e-mail address entry.</strong> The size, in bytes, of each E-mail
|
|
Address entry used for the TO of an e-mail. For information on the format of an
|
|
e-mail addresses entry, see <a href= "#HDREMAIL">E-mail Address Entry</a>.</p>
|
|
|
|
<p>Use stream file for TO e-mail address entries should be set to 0.</p>
|
|
|
|
<p>The following special values can be used for the TO e-mail address entry:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SPLF</em></td>
|
|
<td align="left" valign="top">The e-mail address to be used is specified as an attribute of
|
|
the spooled file (USRDFNDTA('MAILTAG(e-mail-address)').
|
|
You can only specify one e-mail address on the USRDFNDTA parameter. The e-mail address can also be specified on the STRPAGGRP DDS keyword (group name).</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Length of TO e-mail stream file.</strong> The size, in bytes, of the Stream
|
|
File entry containing the stream file which lists the TOs used for an e-mail.
|
|
If the stream file name is surrounded by quotes, use all characters within the quotes as
|
|
the stream file name.
|
|
For information on the format of an
|
|
e-mail addresses entry, see <a href= "#HDRSTMF">Stream File Entry</a>.</p>
|
|
|
|
<p>Use stream file for TO e-mail address entries should be set to X'F1'.</p>
|
|
|
|
|
|
<p><strong>Mail Sender.</strong> The user profile from whom the e-mail is being sent.</p>
|
|
|
|
<p>The following special values can be used for the mail sender:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*PSFCFG</em></td>
|
|
<td align="left" valign="top">The mail sender specified on the PSF configuration object
|
|
will be used for the mail sender.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Number of attachment e-mail entries.</strong> The number of stream files to be
|
|
attached to the e-mail. This value does not include the spooled file converted to PDF.</p>
|
|
|
|
<p>This field is used only when an SMTP mail server is specified in your PSF
|
|
configuration object.</p>
|
|
|
|
<p><strong>Number of BCC e-mail address entries.</strong> The number of BCC e-mail addresses to
|
|
be used for sending an e-mail.</p>
|
|
|
|
<p>Use stream file for BCC e-mail address entries should be set to 0.</p>
|
|
|
|
<p>This field is used only when an SMTP mail server is specified in your PSF
|
|
configuration object.</p>
|
|
|
|
<p><strong>Number of Body of e-mail entries.</strong> The number of stream files to be
|
|
placed into the body of the e-mail.</p>
|
|
|
|
<p>This field is used only when an SMTP mail server is specified in your PSF
|
|
configuration object.</p>
|
|
|
|
<p><strong>Number of CC e-mail address entries.</strong> The number of CC e-mail addresses to
|
|
be used for sending an e-mail.</p>
|
|
|
|
<p>Use stream file for CC e-mail address entries should be set to 0.</p>
|
|
|
|
<p>This field is used only when an SMTP mail server is specified in your PSF
|
|
configuration object.</p>
|
|
|
|
<p><strong>Number of TO e-mail address entries.</strong> The number of TO e-mail addresses to
|
|
be used for sending an e-mail.</p>
|
|
|
|
<p>Use stream file for TO e-mail address entries should be set to 0.</p>
|
|
|
|
<p>This field is used only when an SMTP mail server is specified in your PSF
|
|
configuration object.</p>
|
|
|
|
<p><strong>Offset to attachment e-mail entries.</strong> The offset, in bytes, from
|
|
the beginning of the PMAP0100 format structure, to a list of attachment entries.</p>
|
|
If this value is 0, a list of attachment entries is not specified.
|
|
|
|
<p><strong>Offset to BCC e-mail address entries.</strong> The offset, in bytes, from
|
|
the beginning of the PMAP0100 format structure, to a list of BCC e-mail address entries.
|
|
This area contains the BCC e-mail addresses to which the PDF file is sent.</p>
|
|
|
|
<p>If Use stream file for BCC e-mail address entries is set to X'F1', then this value will be 0.</p>
|
|
|
|
<p><strong>Offset to BCC e-mail stream file.</strong> The offset, in bytes, from
|
|
the beginning of the PMAP0100 format structure, to a file name which contains a list of BCC e-mail
|
|
address entries.</p>
|
|
|
|
<p>If Use stream file for BCC e-mail address entries is set to 0, then this value will be 0.</p>
|
|
|
|
<p><strong>Offset to Body of e-mail entries.</strong> The offset, in bytes, from
|
|
the beginning of the PMAP0100 format structure, to a list of Stream file entries.</p>
|
|
If this value is 0, a list of Stream file entries is not specified.
|
|
|
|
<p><strong>Offset to CC e-mail address entries.</strong> The offset, in bytes, from
|
|
the beginning of the PMAP0100 format structure, to a list of CC e-mail address entries.
|
|
This area contains the CC e-mail addresses to which the PDF file is sent.</p>
|
|
|
|
<p>If Use stream file for CC e-mail address entries is set to 1, then this value will be 0.</p>
|
|
|
|
<p><strong>Offset to CC e-mail stream file.</strong> The offset, in bytes, from
|
|
the beginning of the PMAP0100 format structure, to a file name which contains a list of CC
|
|
e-mail address entries.</p>
|
|
|
|
<p>If Use stream file for CC e-mail address entries is set to 0, then this value will be 0.</p>
|
|
|
|
<!--<p><strong>Offset to Error information.</strong> The offset, in bytes, from
|
|
the beginning of the structure, to -->
|
|
|
|
<p><strong>Offset to message text.</strong> The offset, in bytes, from the beginning of
|
|
the PMAP0100 format, to the message text which gets placed in to the body of the e-mail.</p>
|
|
If this value is 0, message text is not specified.
|
|
|
|
<p><strong>Offset to subject.</strong> The offset, in bytes, to the subject of the e-mail.
|
|
If this value is 0, a subject is not specified.</p>
|
|
|
|
<p><strong>Offset to PDF file for e-mail</strong> The offset, in bytes, from
|
|
the beginning of the PMAP0100 format, to the PDF File For E-mail Entry.</p>
|
|
|
|
<p><strong>Offset to ReplyTo e-mail address.</strong> The offset, in bytes, from
|
|
the beginning of the PMAP0100 format, to the E-mail ddress Entry for a ReplyTo e-mail address.
|
|
If this value is 0, a ReplyTo e-mail address is not specified.</p>
|
|
|
|
<p><strong>Offset to TO e-mail address entries.</strong> The offset, in bytes, from
|
|
the beginning of the PMAP0100 format, to to a list of TO e-mail address entries.
|
|
This area contains the TO e-mail addresses to which the PDF file is sent.</p>
|
|
|
|
<p><strong>Offset to TO e-mail stream file.</strong> The offset, in bytes, from the beginning
|
|
of the PMAP0100 format, to a file name which contains a list of TO e-mail address entries.</p>
|
|
|
|
<p>If Use stream file for TO e-mail address entries is set to 0, then this value will be 0.</p>
|
|
|
|
<p><strong>Owner password.</strong> The owner password associated with the PDF file to be
|
|
created.</p>
|
|
|
|
<p>This field is applicable for Encryption levels *40RC4 and *128RC4.</p>
|
|
|
|
<p>The following can be used for the owner password:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">No owner password is specified for the PDF file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>owner-password</em></td>
|
|
<td align="left" valign="top">A owner password is specified for the PDF file.
|
|
The password is encrypted.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
|
|
<p><strong>Print PDF file.</strong> This field is applicable for Encryption levels *40RC4
|
|
and *128RCR. The definition is different for the type of Encryption level.</p>
|
|
|
|
<p> For an Encryption level of *40RC4, Print PDF file specifies whether users are allowed
|
|
to print the PDF file. </p>
|
|
|
|
<p>When the Encryption level is *40RC4, the following special values are used:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*YES</em></td>
|
|
<td align="left" valign="top">The user is allowed to print the PDF file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NO</em></td>
|
|
<td align="left" valign="top">The user is not allowed to print the PDF file.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p> For an Encryption level of *128RC4, Print PDF file specifies print options for the
|
|
PDF file.</p>
|
|
|
|
<p>When the Encryption level is *128RC4, the following special values are used:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*YES</em></td>
|
|
<td align="left" valign="top">The user is not allowed to print the PDF file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NO</em></td>
|
|
<td align="left" valign="top">The user is not allowed to print the PDF file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*IMAGE</em></td>
|
|
<td align="left" valign="top">The user is only allowed to print at a low resolution (image).
|
|
This prevents the user from recreating the PDF file with different security settings. Printing
|
|
may be slower because each page will be printed as a bit-mapped image.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
|
|
<p><strong>Use stream file for BCC e-mail address entries.</strong> Indicates if a stream file
|
|
containing BCC e-mail addresses is being used.</p>
|
|
|
|
<p>The following values are used:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>X'F1'</em></td>
|
|
<td align="left" valign="top">A stream file for BCC e-mail address entries is being used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">A stream file for BCC e-mail address entries is not being used.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Use stream file for CC e-mail address entries.</strong> Indicates if a stream file
|
|
containing CC e-mail addresses is being used.</p>
|
|
|
|
<p>The following values are used:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">A stream file for CC e-mail address entries is not being used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">A stream file for CC e-mail address entries is being used.</td>
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
<p><strong>Use stream file for TO e-mail address entries.</strong> Indicates if a stream file
|
|
containing TO e-mail addresses is being used.</p>
|
|
|
|
<p>The following values are used:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">A stream file for TO e-mail address entries is not being used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">A stream file for TO e-mail address entries is being used.</td>
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
<p><strong>User password.</strong> The user password associated with the PDF file to be
|
|
created.</p>
|
|
|
|
<p>This field is applicable for Encryption levels *40RC4 and *128RC4.</p>
|
|
|
|
<p>The following can be used for the user password:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">No user password is specified for the PDF file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>user-password</em></td>
|
|
<td align="left" valign="top">An user password is specified for the PDF file.
|
|
The password is encrypted.</td>
|
|
</tr>
|
|
|
|
|
|
</table>
|
|
<br><br>
|
|
<h3><a name="HDREMAIL">E-mail Address Entry</a></h3>
|
|
|
|
<p>This table is used for mapping the TO, CC, BCC and ReplyTo e-mail addresses.
|
|
For more details about the fields that can be used with the following table, see <a href=
|
|
"#EMAILFIELDD">E-mail Address Entry Field Description</a>.</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(80)</td>
|
|
<td align="left" valign="top" width="60%">E-mail address</td>
|
|
</tr>
|
|
</table>
|
|
<br><br>
|
|
<h3><a name="EMAILFIELDD">E-mail Address Entry Field Description</a></h3>
|
|
|
|
<p><strong>E-mail address. </strong>An e-mail address.</p>
|
|
|
|
<p>For the TO e-mail address, the following special value can be specified:</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 e-mail address is specified as an attribute of the spooled file on the USRDFNDTA parameter in the format USRDFNDTA('MAILTAG(e-mail address)'). You can only specify one e-mail address on the USRDFNDTA parameter. The e-mail address can also be specified in the spooled file with the STRPAGGRP DDS keyword (group name).</td>
|
|
</tr>
|
|
</table>
|
|
<br><br>
|
|
<h3><a name="HDRSTMF">Stream File Entry</a></h3>
|
|
|
|
<p>This table is used for mapping the stream files that can be used for the Body, Attachment, TO,
|
|
CC, and BCC stream files. Use one entry for each stream file.
|
|
If you are specifying a stream file for the Body, the file extension (for example, txt or htm)
|
|
must be specified in lower case. Otherwise, the file will be sent as an attachment.
|
|
If necessary, the field is padded with blanks (X'40').
|
|
For more details about the fields that can be used with the following table,
|
|
see <a href="#STMFFIELDD">Stream File Entry Field Description</a>.</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(255)</td>
|
|
<td align="left" valign="top" width="60%">Stream file name</td>
|
|
</tr>
|
|
</table>
|
|
<br><br>
|
|
<h3><a name="STMFFIELDD">Stream File Entry Field Description</a></h3>
|
|
|
|
<p><strong>Stream file name. </strong>A path-qualified stream file name.</p>
|
|
|
|
|
|
<br>
|
|
|
|
<h3><a name="HDRFILENAME">File Name Entry</a></h3>
|
|
|
|
<p>This table is used for specifying a file name that is not path-qualifed.
|
|
Use this entry for specifying a PDF file for e-mail entry. This will be the name of the
|
|
attachment for the PDF file (original spooled file) that is included in the e-mail.
|
|
For more details about the field that can be used with the following table,
|
|
see <a href="#HDRFILENAMEDD">File Name Entry Field Description</a>.</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(80)</td>
|
|
<td align="left" valign="top" width="60%">File name</td>
|
|
</tr>
|
|
</table>
|
|
<br><br>
|
|
<h3><a name="HDRFILENAMEDD">File Name Entry Field Description</a></h3>
|
|
|
|
<p><strong>File name. </strong>A file name which does not contain path information.</p>
|
|
<br>
|
|
<h3><a name="HDRPDFSTMF">PDF Stream File Information Entry</a></h3>
|
|
<p>For more details about the fields in the following table, see <a href=
|
|
"#PSFSTMFFIELDD">PDF Stream File Information Entry Field Descriptions</a>.</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%">Offset to PDF file name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">4</td>
|
|
<td align="center" valign="top" width="10%">4</td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Length of PDF file name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">8</td>
|
|
<td align="center" valign="top" width="10%">8</td>
|
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
|
<td align="left" valign="top" width="60%">Public Authority</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">18</td>
|
|
<td align="center" valign="top" width="10%">11</td>
|
|
<td align="left" valign="top" width="20%">CHAR(2)</td>
|
|
<td align="left" valign="top" width="60%">Reserved</td>
|
|
</tr>
|
|
|
|
</table>
|
|
<br><br>
|
|
<h3><a name="PSFSTMFFIELDD">PDF Stream File Information Entry Field Descriptions</a></h3>
|
|
|
|
<p><strong>Length of PDF file name.</strong> The size, in bytes, of the Stream File entry
|
|
which contains the PDF file name. For information on the format of a Stream File entry, see
|
|
<a href= "#HDRSTMF">Stream File Entry</a>.</p>
|
|
|
|
<p><strong>Offset to PDF file name.</strong> The offset, in bytes, from the beginning of
|
|
the PMAP0100 format, to the Stream File entry for a PDF file. </p>
|
|
|
|
<p><strong>Public Authority.</strong> The public authority for the PDF stream file. The default
|
|
is *EXCLUDE.</p>
|
|
|
|
<p>The following special values may be specified:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*EXCLUDE</em></td>
|
|
<td align="left" valign="top">Users are excluded from accessing the object.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">Users do not have any of the data authorities to the objects.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*RWX</em></td>
|
|
<td align="left" valign="top">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. Users can change the object and
|
|
perform basic functions on the object. *RWX authority provides object operational authority
|
|
and all the data authorities.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*RX</em></td>
|
|
<td align="left" valign="top">The users are given *RX authority to perform basic operations on
|
|
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.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*RW</em></td>
|
|
<td align="left" valign="top">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.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*WX</em></td>
|
|
<td align="left" valign="top">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.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*R</em></td>
|
|
<td align="left" valign="top">Users are given *R authority to view the contents of an object.
|
|
*R authority provides object operational authority and data read authority.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*W</em></td>
|
|
<td align="left" valign="top">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.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*X</em></td>
|
|
<td align="left" valign="top">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.</td>
|
|
</tr>
|
|
|
|
</table>
|
|
<br><br>
|
|
<h3><a name="HDRPDFSPLFI">PDF Spooled File Information Entry</a></h3>
|
|
|
|
<p>These fields are used for mapping the PDF spooled file information.
|
|
If necessary, text fields are padded with blanks (X'40').
|
|
For more details about the fields in the following table, see <a href=
|
|
"#SPLFFIELDD">PDF and AFPDS Spooled File Information Entry Field Descriptions</a>.</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%">Output queue name for output spooled file</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 name for output spooled file</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 for output spooled file</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 for output spooled file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">40</td>
|
|
<td align="center" valign="top">28</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Form type for output spooled file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">50</td>
|
|
<td align="center" valign="top">32</td>
|
|
<td align="left" valign="top">CHAR(255)</td>
|
|
<td align="left" valign="top">User defined data for output spooled file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">305</td>
|
|
<td align="center" valign="top">13B</td>
|
|
<td align="left" valign="top">CHAR(3)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
|
|
</table>
|
|
<br><br>
|
|
<h3><a name="HDRAFPSPLFI">AFPDS Spooled File Information Entry</a></h3>
|
|
|
|
<p>These fields are used for mapping the AFPDS spooled file information.
|
|
If necessary, text fields are padded with blanks (X'40').
|
|
For more details about the fields in the following table, see <a href=
|
|
"#SPLFFIELDD">PDF and AFPDS Spooled File Information Entry Field Descriptions</a>.</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%">Output queue name for output spooled file</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 name for output spooled file</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 for output spooled file</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 for output spooled file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">40</td>
|
|
<td align="center" valign="top">28</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Form type for output spooled file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">50</td>
|
|
<td align="center" valign="top">32</td>
|
|
<td align="left" valign="top">CHAR(255)</td>
|
|
<td align="left" valign="top">User defined data for output spooled file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">305</td>
|
|
<td align="center" valign="top">13B</td>
|
|
<td align="left" valign="top">CHAR(3)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
|
|
</table>
|
|
<br><br>
|
|
<h3><a name="SPLFFIELDD">PDF and AFPDS Spooled File Information Entry Field Descriptions</a></h3>
|
|
|
|
<p><strong>Form type for output spooled file.</strong> The type of forms that should
|
|
be loaded on the printer before this spooled file is printed. This is the value which will be
|
|
used when a file is spooled.</p>
|
|
|
|
<p>The following special values can be used for the form type for output spooled file:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SPLF</em></td>
|
|
<td align="left" valign="top">The form type of the original spooled file will be used.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Output queue library name for output spooled file.</strong> The name of the library
|
|
where the output queue for the file which will be spooled resides.</p>
|
|
|
|
<p><strong>Output queue name for output spooled file.</strong> The name of the output queue
|
|
to which the file to be spooled will be written.</p>
|
|
|
|
<p>The following special values can be used for the form type for output queue name
|
|
for output spooled file:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*PSFCFG</em></td>
|
|
<td align="left" valign="top">The output queue specified in the PSF configuration object
|
|
will be used when writing the PDF file to spool.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Spooled file name for output spooled file.</strong> The name which will be used
|
|
for the file that gets spooled.</p>
|
|
|
|
<p>The following special values can be used for the spooled file name for output spooled file:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SPLF</em></td>
|
|
<td align="left" valign="top">The name of the original spooled file will be used.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>User data for output spooled file.</strong> The user-specified data which will
|
|
describe the file to be spooled.</p>
|
|
|
|
<p>The following special values can be used for the user data for output spooled file:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SPLF</em></td>
|
|
<td align="left" valign="top">The user data of the original spooled file will be used.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>User defined data for output spooled file.</strong> The user-defined data that will
|
|
be used for the file to be spooled.</p>
|
|
|
|
<p>The following special values can be used for the user defined data for output spooled file:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SPLF</em></td>
|
|
<td align="left" valign="top">The user defined data of the original spooled file will be used.</td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
<br>
|
|
<h3>Error Messages</h3>
|
|
|
|
<table width="100%" cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<th align="left" valign="top">Message ID</th>
|
|
<th align="left" valign="top">Error Message Text</th>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top">CPD0172 D</td>
|
|
<td align="left" valign="top">Parameters passed on CALL do not match those required.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF5F00 E</td>
|
|
<td valign="top">Add type &1 is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF5F01 E</td>
|
|
<td valign="top">Length of PDF map entry spooled file attributes is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF5F02 E</td>
|
|
<td valign="top">Length of PDF mapping action is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF5F03 E</td>
|
|
<td valign="top">Value of length, offset, or number in parameter list is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF5F04 E</td>
|
|
<td valign="top">Entry is already in the PDF Map object.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF5F05 E</td>
|
|
<td valign="top">No e-mail address specified with mail information.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF5F06 E</td>
|
|
<td valign="top">No PDF mapping action was specified for entry.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF5F07 E</td>
|
|
<td valign="top">Invalid value &2 specified in PDF map action.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF8100 E</td>
|
|
<td align="left" valign="top">All CPF81xx messages could be returned. xx is from 01 to
|
|
FF.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9801 E</td>
|
|
<td align="left" valign="top">Object &2 in library &3 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9802 E</td>
|
|
<td align="left" valign="top">Not authorized to object &2 in &3.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9803 E</td>
|
|
<td align="left" valign="top">Cannot allocate object &2 in library &3.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9808 E</td>
|
|
<td align="left" valign="top">Cannot allocate one or more libraries on library list.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9810 E</td>
|
|
<td align="left" valign="top">Library &1 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9820 E</td>
|
|
<td align="left" valign="top">Not authorized to use library &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td valign="top">CPF9838 E</td>
|
|
<td valign="top">User profile storage limit exceeded.</td>
|
|
</tr>
|
|
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9872 E</td>
|
|
<td align="left" valign="top">Program or service program &1 in library &2 ended.
|
|
Reason code &3.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9999 E</td>
|
|
<td align="left" valign="top">Function check. &1 unmonitored by &2 at statement
|
|
&5, instruction &3.</td>
|
|
</tr>
|
|
|
|
</table>
|
|
<br>
|
|
<hr>
|
|
API introduced: V5R3
|
|
|
|
<hr>
|
|
<table cellpadding="2" cellspacing="2" align="center">
|
|
<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>
|
|
|