341 lines
12 KiB
HTML
341 lines
12 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>Display PDF Map Entries (DSPPDFMAPE)</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="DSPPDFMAPE.Top_Of_Page"></a>
|
|
<h2>Display PDF Map Entries (DSPPDFMAPE)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>
|
|
<ul><li>Interactive job (*INTERACT)</li>
|
|
</ul><b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#DSPPDFMAPE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPPDFMAPE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPPDFMAPE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPPDFMAPE"></a>
|
|
<p>The Display PDF Map Entries (DSPPDFMAPE) command displays entries in the specified PDF map.
|
|
</p>
|
|
<p>A filter can be specified to control which entries are displayed. Each map entry has critera to specify which spooled files it applies to. The filter you create for the Display PDF map entries command searches those criteria to determine which entries to display.
|
|
</p>
|
|
<p>All the fields for the filter are used when scanning each entry in the PDF map for a match.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPDFMAPE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPPDFMAPE.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="#DSPPDFMAPE.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>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="10"><a href="#DSPPDFMAPE.FILTER"><b>FILTER</b></a></td>
|
|
<td valign="top">Filter</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="10">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Output queue</td>
|
|
<td valign="top">
|
|
<i>Qualified object name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Output queue</td>
|
|
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Generic name, name</i>, *LIBL, *CURLIB, *ALL</td>
|
|
</tr><tr>
|
|
<td valign="top">Element 2: Spooled file</td>
|
|
<td valign="top">
|
|
<i>Generic name, name</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Job name</td>
|
|
<td valign="top">
|
|
<i>Generic name, name</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: User</td>
|
|
<td valign="top">
|
|
<i>Generic name, name</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 5: User data</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 6: Form type</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 7: Routing tag</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPDFMAPE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPPDFMAPE.PDFMAP"></a>
|
|
<h3>PDF Map (PDFMAP)</h3>
|
|
<p>Specifies the name of the PDF map to be displayed.
|
|
</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>*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>*CURLIB</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><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="#DSPPDFMAPE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPDFMAPE.FILTER"></a>
|
|
<h3>Filter (FILTER)</h3>
|
|
<p>Specifies which entries in the PDF map to display. If you want to see all entries, specify *ALL for each filter entry. This is the default. If you want to see only certain types of entries, for example, all entries for spooled files on a specific output queue, enter values for any of the filter entries.
|
|
</p>
|
|
<p><b>Element 1: Output queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>Qualifier 1: Output queue</b></dt>
|
|
<dd>
|
|
</dd>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Specifies that any value for the output queue field in the PDF map entry satisfies this field in the filter. Do not specify a value for the library.
|
|
</dd>
|
|
<dt><b><i>output-queue-name</i></b></dt>
|
|
<dd>Specifies the output queue name used as a search argument when scanning PDF map entries.
|
|
</dd>
|
|
<dt><b>generic-name</b></dt>
|
|
<dd>Specify the generic name of the object to be considered a match. A generic name is a character string that contains one or more characters followed by an asterisk (*). All objects that have names with the same prefix as the generic name are considered a match for this field.
|
|
</dd>
|
|
<dt><b><i>output-queue-name</i></b></dt>
|
|
<dd>Specifies that only a specific value in the Output queue name field in a PDF map entry satisfies this field in the filter. You must specify a value for the library.
|
|
</dd>
|
|
</dl>
|
|
<p>Specify a library name only if you have specified a value other than *ALL for the output queue name. Otherwise, the library value is ignored.
|
|
</p>
|
|
<dl>
|
|
<dt><b>Qualifier 2: Library</b></dt>
|
|
<dd>
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specifies a specific value for the output queue library name argument. Only an exact match in the Library field in a PDF map entry satisfies this field in the filter.
|
|
</dd>
|
|
<dt><b>generic-name</b></dt>
|
|
<dd>Specify the generic name of the output queue's library on the PDF map entry. A generic name is a character string that contains one or more characters followed by an asterisk (*). All objects that have names with the same prefix as the generic name are considered a match.
|
|
</dd>
|
|
<dt><b>*LIBL</b></dt>
|
|
<dd>Specifies that only a value of *LIBL in the output queue's Library field in a PDF map entry satisfies this field in the filter.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>Specifies that only a value of *CURLIB in the output queue's Library field in a PDF map entry satisfies this field in the filter.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>Specifies that any value for the output queue's Library field in a PDF map entry satisfies this field in the filter.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Spooled file</b>
|
|
</p>
|
|
<p>Specifies the spooled file name to be used as a search argument when scanning PDF map entries.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Specifies that any value for the PDF map entry's Spooled file field satisfies this field in the filter.
|
|
</dd>
|
|
<dt><b><i>spooled-file-name</i></b></dt>
|
|
<dd>Specifies a specific value for the PDF map entry's Spooled file argument. Only an exact match in the Spooled file field satisfies this field in the filter.
|
|
</dd>
|
|
<dt><b>generic-name</b></dt>
|
|
<dd>Specify the generic name of the object to be considered a match. A generic name is a character string that contains one or more characters followed by an asterisk (*). All objects that have names with the same prefix as the generic name are considered a match for this field.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 3: Job name</b>
|
|
</p>
|
|
<p>Specifies the job name to be used as a search argument when scanning PDF map entries.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Specifies that any value for the PDF map entry's Job name field satisfies this field in the filter.
|
|
</dd>
|
|
<dt><b><i>job-name</i></b></dt>
|
|
<dd>Specifies a specific value for the PDF map entry's Job name argument. Only an exact match in the Job name field satisfies this field in the filter.
|
|
</dd>
|
|
<dt><b>generic-name</b></dt>
|
|
<dd>Specify the generic name of the object to be considered a match. A generic name is a character string that contains one or more characters followed by an asterisk (*). All objects that have names with the same prefix as the generic name are considered a match for this field.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 4: User</b>
|
|
</p>
|
|
<p>Specifies the user name to be used as a search argument when scanning PDF map entries.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Specifies that any value for the PDF map entry's User field in the PDF map entry satisfies this field in the filter.
|
|
</dd>
|
|
<dt><b><i>user-name</i></b></dt>
|
|
<dd>Specifies a specific value for the PDF map entry's user name argument. Only an exact match in the User field satisfies this field in the filter.
|
|
</dd>
|
|
<dt><b>generic-name</b></dt>
|
|
<dd>Specify the generic name of the object to be considered a match. A generic name is a character string that contains one or more characters followed by an asterisk (*). All objects that have names with the same prefix as the generic name are considered a match for this field.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 5: User data</b>
|
|
</p>
|
|
<p>Specifies the user data used as a search argument when scanning PDF map entries.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Specifies that any value for the User data field in the PDF map entry satisfies this field in the filter.
|
|
</dd>
|
|
<dt><b><i>user-data</i></b></dt>
|
|
<dd>Specifies a specific value for the user data argument. Only an exact match in the User data field in a PDF map entry satisfies this field in the filter.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 6: Form type</b>
|
|
</p>
|
|
<p>Specifies the form type to be used as a search argument when scanning PDF map entries.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Specifies that any value for the PDF map entry's Form type field in the PDF map entry satisfies this field in the filter.
|
|
</dd>
|
|
<dt><b><i>form-type</i></b></dt>
|
|
<dd>Specifies a specific value for the PDF map entry's Form type argument. Only an exact match in the Form type field satisfies this field in the filter.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 7: Routing tag</b>
|
|
</p>
|
|
<p>Specifies the routing tag used as a search argument when scanning PDF map entries.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Specifies that any value for the PDF map entry's Routing tag field in the PDF map entry satisfies this field in the filter.
|
|
</dd>
|
|
<dt><b><i>routing-tag</i></b></dt>
|
|
<dd>Specifies a specific value for the PDF map entry's Routing tag argument. Only an exact match in the routing tag field satisfies this field in the filter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPDFMAPE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPPDFMAPE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1:</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPDFMAPE PDFMAP(QGPL/BIGSALES)
|
|
FILTER(*ALL *ALL *ALL *ALL *ALL *ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays all map entries in the PDF map object.
|
|
</p>
|
|
<p><b>Example 2:</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPDFMAPE PDFMAP(QGPL/BIGSALES)
|
|
FILTER(QGPL/SPECIAL *ALL *ALL *ALL *ALL *ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays all map entries in BIGSALES that specify an output queue of QGPL/SPECIAL.
|
|
</p>
|
|
<p><b>Example 3:</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPDFMAPE PDFMAP(QGPL/BIGSALES)
|
|
FILTER(*LIBL/SPECIAL *ALL BIGTICKET *ALL *ALL *ALL)
|
|
OUTPUT(*PRINT)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays all map entries in BIGSALES that specify an output queue of *LIBL/SPECIAL and have a value for User data of 'BIGTICKET'.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPDFMAPE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPPDFMAPE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF9801</b></dt>
|
|
<dd>Object &2 in library &3 not found.
|
|
</dd>
|
|
<dt><b>CPF9802</b></dt>
|
|
<dd>Not authorized to object &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF9803</b></dt>
|
|
<dd>Cannot allocate object &2 in library &3.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPDFMAPE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|