ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/crtpdfmap.htm

213 lines
7.4 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">
<title>Create PDF Map (CRTPDFMAP)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="CRTPDFMAP.Top_Of_Page"></a>
<h2>Create PDF Map (CRTPDFMAP)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#CRTPDFMAP.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTPDFMAP.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTPDFMAP.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTPDFMAP"></a>
<p>The Create PDF Map (CRTPDFMAP) command creates a PDF map.
</p>
<p>This PDF map can be used by Infoprint Server and PSF/400 when converting spooled files to PDF. Each PDF map can be made up of several PDF map entries. The PDF map entries allow you to specify how spooled files should be processed after they have been converted.
</p>
<p>These functions for processing are available:
</p>
<ul>
<li>Storing the PDF file in the integrated file system.
</li>
<li>E-mailing the PDF file as an attachment.
</li>
<li>Spooling the PDF file to an output queue.
</li>
<li>Spooling the output AFP file to an output queue.
</li>
</ul>
<p>Add an entry to the PDF map using the WRKPDFMAPE command for each type of processing you want. For example, if you want to e-mail some spooled files, respool some as AFP files, and do both actions on some spooled files, you will need at least three PDF map entries.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>Infoprint Server for iSeries is required to use this command.
</li>
<li>*IOSYSCFG authority is required to use this command.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPDFMAP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTPDFMAP.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTPDFMAP.PDFMAP"><b>PDFMAP</b></a></td>
<td valign="top">PDF Map</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: PDF Map</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*CURLIB</u></b>, *LIBL</td>
</tr><tr>
<td valign="top"><a href="#CRTPDFMAP.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPDFMAP.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *CHANGE, *ALL, *USE, *EXCLUDE</td>
<td valign="top">Optional, Positional 2</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTPDFMAP.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTPDFMAP.PDFMAP"></a>
<h3>PDF Map (PDFMAP)</h3>
<p>Specifies the name of the PDF map.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: PDF Map</b>
</p>
<dl>
<dt><b><i>pdf-map-name</i></b></dt>
<dd>Specifies the name of the PDF map.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*CURLIB</u></b></dt>
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
</dl>
<dl>
<dt><b>*LIBL</b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
</dl>
<dl>
<dt><b><i>library-name</i></b></dt>
<dd>Specifies the name of the library to be searched.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPDFMAP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPDFMAP.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the PDF map.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>No text is specified.
</dd>
<dt><b><i>'text description'</i></b></dt>
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPDFMAP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPDFMAP.AUT"></a>
<h3>Authority (AUT)</h3>
<p>Specifies the authority you are giving to users who do not have specific authority to the PDF map, who are not on an authorization list, and whose group profile has no specific authority to the PDF map.
</p>
<dl>
<dt><b><u>*LIBCRTAUT</u></b></dt>
<dd>The system determines the authority for the PDF map by using the value specified on the Create authority prompt (CRTAUT parameter) on the Create Library command (CRTLIB) for the library containing the PDF map to be created. If the value specified on the Create authority prompt (CRTAUT parameter) is changed, the new value will not affect any existing PDF maps.
</dd>
<dt><b>*CHANGE</b></dt>
<dd>Change authority allows the user to change and perform basic functions on the PDF map. Change authority provides PDF map operational authority and all data authorities.
</dd>
<dt><b>*ALL</b></dt>
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the PDF map's existence, specify the security for the PDF map, change the PDF map, and perform basic functions on the PDF map. The user can change ownership of the PDF map.
</dd>
<dt><b>*USE</b></dt>
<dd>Use authority provides PDF map operational authority, read authority, and execute authority.
</dd>
<dt><b>*EXCLUDE</b></dt>
<dd>The user cannot access the PDF map.
</dd>
<dt><b><i>authorization-list-name</i></b></dt>
<dd>Specify the name of an authorization list to be used for authority to the PDF map. Users included in the authorization list are granted authority to the PDF map as specified in the list. The authorization list must exist when the PDF map is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPDFMAP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTPDFMAP.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTPDFMAP PDFMAP(QGPL/BIGSALES)
TEXT('High-end sales letters')
</pre>
</p>
<p>This example shows how to create a PDF map.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPDFMAP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTPDFMAP.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2283</b></dt>
<dd>Authorization list &amp;1 does not exist.
</dd>
<dt><b>CPF88C1</b></dt>
<dd>Printer resource type &amp;1 &amp;2 was not created in library &amp;3.
</dd>
<dt><b>CPF9810</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF9820</b></dt>
<dd>Not authorized to use library &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPDFMAP.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>