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

1585 lines
70 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Create PSF Configuration (CRTPSFCFG)</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="CRTPSFCFG.Top_Of_Page"></a>
<h2>Create PSF Configuration (CRTPSFCFG)</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="#CRTPSFCFG.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTPSFCFG.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTPSFCFG.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTPSFCFG"></a>
<p>Use the Create PSF Configuration (CRTPSFCFG) command to create a Print Services Facility (PSF) configuration object from the information specified on this command.
</p>
<p>A PSF configuration object allows you to specify additional parameters for an AFP printer that are not supported on the Create Device Description (Printer) CRTDEVPRT command, such as setting the device release timer. The object type for a PSF configuration object is *PSFCFG.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>The PSF feature is required to use this command.
</li>
<li>You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTPSFCFG.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="#CRTPSFCFG.PSFCFG"><b>PSFCFG</b></a></td>
<td valign="top">PSF configuration</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: PSF configuration</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></td>
</tr><tr>
<td valign="top"><a href="#CRTPSFCFG.USRRSCLIBL"><b>USRRSCLIBL</b></a></td>
<td valign="top">User resource library list</td>
<td valign="top"><b><u>*JOBLIBL</u></b>, *CURLIB, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.DEVRSCLIBL"><b>DEVRSCLIBL</b></a></td>
<td valign="top">Device resource library list</td>
<td valign="top">Single values: <b><u>*DFT</u></b><br>Other values (up to 30 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.IPDSPASTHR"><b>IPDSPASTHR</b></a></td>
<td valign="top">IPDS pass through</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.ACTRLSTMR"><b>ACTRLSTMR</b></a></td>
<td valign="top">Activate release timer</td>
<td valign="top"><b><u>*NORDYF</u></b>, *IMMED, *PRTNORDYF, *PRTIMMED</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.RLSTMR"><b>RLSTMR</b></a></td>
<td valign="top">Release timer</td>
<td valign="top">1-1440, <b><u>*NOMAX</u></b>, *SEC15, *SEC30</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.RESTRTMR"><b>RESTRTMR</b></a></td>
<td valign="top">Restart timer</td>
<td valign="top">1-1440, <b><u>*IMMED</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.RETRY"><b>RETRY</b></a></td>
<td valign="top">APPC and TCP/IP retry count</td>
<td valign="top">1-99, <b><u>15</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.RETRYDLY"><b>RETRYDLY</b></a></td>
<td valign="top">Delay between APPC retries</td>
<td valign="top">0-999, <b><u>90</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.ACKFRQ"><b>ACKFRQ</b></a></td>
<td valign="top">Acknowledgment frequency</td>
<td valign="top">1-32767, <b><u>100</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.PRTRSPTMR"><b>PRTRSPTMR</b></a></td>
<td valign="top">Printer response timer</td>
<td valign="top">5-3600, <b><u>*NOMAX</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.PDFGEN"><b>PDFGEN</b></a></td>
<td valign="top">Generate PDF output</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 3 repetitions): *SPLF, *STMF, *MAIL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.PDFDEVTYPE"><b>PDFDEVTYPE</b></a></td>
<td valign="top">PDF device emulation type</td>
<td valign="top"><b><u>*IP40240</u></b>, *IP40300, *P4028, *P3812</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.PDFPPRDWR1"><b>PDFPPRDWR1</b></a></td>
<td valign="top">PDF paper size drawer 1</td>
<td valign="top"><b><u>*LETTER</u></b>, *LEGAL, *STATEMENT, *EXECUTIVE, *LEDGER, *A5, *A4, *A3, *B5, *B4</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.PDFPPRDWR2"><b>PDFPPRDWR2</b></a></td>
<td valign="top">PDF paper size drawer 2</td>
<td valign="top"><b><u>*LETTER</u></b>, *LEGAL, *STATEMENT, *EXECUTIVE, *LEDGER, *A5, *A4, *A3, *B5, *B4</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTPSFCFG.PDFMULT"><b>PDFMULT</b></a></td>
<td valign="top">Multiple PDF files</td>
<td valign="top">Single values: <b><u>*NO</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Acknowledge multiple groups</td>
<td valign="top">
<b><u>*YES</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Process option</td>
<td valign="top">
<b><u>*SPLIT</u></b>, *INDEX</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.PDFINCFNT"><b>PDFINCFNT</b></a></td>
<td valign="top">PDF fonts inline</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTPSFCFG.PDFDTAQ"><b>PDFDTAQ</b></a></td>
<td valign="top">PDF data queue</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: PDF data queue</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top"><a href="#CRTPSFCFG.PDFMAILSVR"><b>PDFMAILSVR</b></a></td>
<td valign="top">PDF mail server name</td>
<td valign="top">Single values: <b><u>*SNDDST</u></b><br>Other values (up to 4 repetitions): <i>Character value</i>, *LOCAL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.PDFSENDER"><b>PDFSENDER</b></a></td>
<td valign="top">Sender of electronic mail</td>
<td valign="top"><i>Name</i>, <b><u>*SPLFOWN</u></b>, QSPLJOB</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.PDFADMIN"><b>PDFADMIN</b></a></td>
<td valign="top">PDF administrator</td>
<td valign="top"><i>Character value</i>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTPSFCFG.PDFMAPPGM"><b>PDFMAPPGM</b></a></td>
<td valign="top">PDF user program</td>
<td valign="top">Single values: <b><u>*NONE</u></b>, *IBMPGM<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: PDF user program</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top" rowspan="3"><a href="#CRTPSFCFG.PDFMAP"><b>PDFMAP</b></a></td>
<td valign="top">PDF mapping object</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: PDF mapping object</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top" rowspan="3"><a href="#CRTPSFCFG.PDFOUTQ"><b>PDFOUTQ</b></a></td>
<td valign="top">PDF output queue</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: PDF output queue</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top"><a href="#CRTPSFCFG.PDFDIR"><b>PDFDIR</b></a></td>
<td valign="top">PDF directory</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.AFPSAVE"><b>AFPSAVE</b></a></td>
<td valign="top">Save AFP data</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTPSFCFG.AFPOUTQ"><b>AFPOUTQ</b></a></td>
<td valign="top">AFP output queue</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: AFP output queue</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top"><a href="#CRTPSFCFG.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</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTPSFCFG.AUTOSSNRCY"><b>AUTOSSNRCY</b></a></td>
<td valign="top">Automatic session recovery</td>
<td valign="top">Single values: <b><u>*NO</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Enabled</td>
<td valign="top">
<b><u>*YES</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Message option</td>
<td valign="top">
<b><u>*INFO</u></b>, *INQ</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.BLANKPAGE"><b>BLANKPAGE</b></a></td>
<td valign="top">Blank page</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.PAGSIZCTL"><b>PAGSIZCTL</b></a></td>
<td valign="top">Page size control</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.RESFONT"><b>RESFONT</b></a></td>
<td valign="top">Resident fonts</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.RSCRET"><b>RSCRET</b></a></td>
<td valign="top">Resource retention</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.EDGEORIENT"><b>EDGEORIENT</b></a></td>
<td valign="top">Edge orient</td>
<td valign="top">*YES, <b><u>*NO</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.USEOUTLFNT"><b>USEOUTLFNT</b></a></td>
<td valign="top">Use outline fonts</td>
<td valign="top">*YES, <b><u>*NO</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.PSFDFNOPT"><b>PSFDFNOPT</b></a></td>
<td valign="top">PSF defined option</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 6 repetitions): <i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.FNTSUBMSG"><b>FNTSUBMSG</b></a></td>
<td valign="top">Font substitution messages</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.FNTCAPTURE"><b>FNTCAPTURE</b></a></td>
<td valign="top">Capture host fonts at printer</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.FNTRSL"><b>FNTRSL</b></a></td>
<td valign="top">Font resolution for formatting</td>
<td valign="top"><b><u>*SEARCH</u></b>, 240, 300</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTPSFCFG.FNTTBL"><b>FNTTBL</b></a></td>
<td valign="top">Font mapping table</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Font mapping table</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top"><a href="#CRTPSFCFG.CSEMODE"><b>CSEMODE</b></a></td>
<td valign="top">Cut sheet emulation mode</td>
<td valign="top"><b><u>*NONE</u></b>, *CHKFIRST, *CHKALL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.MAPIGCFNT"><b>MAPIGCFNT</b></a></td>
<td valign="top">Use DBCS simulation fonts</td>
<td valign="top">*YES, <b><u>*NO</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.REPLACE"><b>REPLACE</b></a></td>
<td valign="top">Replace</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTPSFCFG.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</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTPSFCFG.PSFCFG"></a>
<h3>PSF configuration (PSFCFG)</h3>
<p>Specifies the Print Services Facility (PSF) configuration object to be created.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: PSF configuration</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the PSF configuration object to be created.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*CURLIB</u></b></dt>
<dd>Store the PSF configuration object in the current library. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where you want to store the PSF configuration object.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.USRRSCLIBL"></a>
<h3>User resource library list (USRRSCLIBL)</h3>
<p>Specifies the user resource library list to use when searching for AFP resources. When searching for an AFP resource specified with a spooled file, Print Services Facility (PSF) first searches the libraries in the user resource library list and then those in the device resource library list.
</p>
<p>*PRTF has been removed as a valid value for the USRRSCLIBL parameter. PSF configuration objects migrated from other releases that were created with USRRSCLIBL(*PRTF) will be supported exactly as in prior releases as long as the new USRRSCLIBL parameter on the printer file has the a value of *DEVD. When a CHGPSFCFG command is run in this environment, a value of *SAME will be displayed where a value of *PRTF would have been displayed on a prior release.
</p>
<dl>
<dt><b><u>*JOBLIBL</u></b></dt>
<dd>Use the library list for the job that created the spooled file when searching for AFP resources. Each time the user creates a new spooled file, the job library list at that point in time is saved.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>Use the current library for the job that created the spooled file when searching for AFP resources. If no library is specified as the current library for the job, then the QGPL library is used.
</dd>
<dt><b>*NONE</b></dt>
<dd>No user resource library list is used for searching for AFP resources. Only the device resource library list is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.DEVRSCLIBL"></a>
<h3>Device resource library list (DEVRSCLIBL)</h3>
<p>Specifies the device resource library list to use when searching for AFP resources. When searching for an AFP resource specified with a spooled file, Print Services Facility (PSF) first searches the libraries in the user resource library list and then the libraries in the device resource library list.
</p>
<p><b>Single value</b>
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>PSF searches these libraries, if they exist, when searching for AFP resources:
<ul>
<li>QFNTCPL
</li>
<li>QFNT01 - QFNT19
</li>
<li>QFNT61 - QFNT69
</li>
</ul>
<p>
<b>Note: </b>If not all the system libraries in the above list have been created, a user can create libraries using the names of the missing system libraries. If this occurs and you specify *DFT on the DEVRSCLIBL parameter, the resources in those user-created libraries could be mistakenly found by other users. To prevent this, the system administrator should create all of the missing system libraries with PUBLIC *USE authority.
</p>
</dd>
</dl>
<p><b>Other values</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify up to 30 names of libraries PSF will use to search for AFP resources.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.IPDSPASTHR"></a>
<h3>IPDS pass through (IPDSPASTHR)</h3>
<p>Specifies whether IPDS pass-through is done for the device. IPDS pass-through is a mechanism by which unnecessary datastream conversions can be eliminated, thus improving throughput and decreasing CPU utilitization. Full page-level error recovery is supported.
</p>
<p>IPDS pass-through can be used for SCS and IPDS files which do not specify any AFP processing features, such as a front or back overlay on the printer file. SCS data is transformed to a generic IPDS. Specifying IPDS pass-through on the device configuration or printer file allows only those spooled files eligible for IPDS pass-through to bypass the extra transforms. Those spooled files not eligible for IPDS pass-through will still undergo the transforms to AFPDS and back to IPDS.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>No IPDS pass-through is done.
</dd>
<dt><b>*YES</b></dt>
<dd>IPDS pass-through is performed for the device for all spooled files that are eligible for IPDS pass-through.
<p>IPDS pass-through is not valid for all Print Services Facility (PSF) supported printers. Only printers that support resident fonts can be used with IDPS pass-through. If a printer does not support resident fonts, font references in the data stream must be mapped to host fonts, which are then downloaded to the printer. This requires the transform to AFPDS and back to IPDS.
</p>
<p>The following IPDS printers cannot support IPDS pass-through:
</p>
<ul>
<li>3820, 3825, 3827, 3828, 3829, 3831, 3835, 3900-001
</li>
<li>Any Distributed Print Function (DPF)-attached printer. DPF is a function supported by Infoprint Manager for Windows NT and Windows 2000, which blocks the use of printer-resident fonts.
</li>
</ul>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.ACTRLSTMR"></a>
<h3>Activate release timer (ACTRLSTMR)</h3>
<p>Specifies the point at which the release timer is activated. The value specified for <b>Release timer (RLSTMR)</b> determines the length of time the writer will "keep" the printer before releasing the session.
</p>
<dl>
<dt><b><u>*NORDYF</u></b></dt>
<dd>The release timer is activated when there are no ready (RDY) spooled files in the printer's output queue and the last page of the last spooled file processed has printed. If the release timer expires, the session to the printer is released but the writer does not end. When the session is released, another Print Services Facility (PSF) can start a session to the printer.
<p>Use this value when you want the writer to print all ready spooled files before releasing the session.
</p>
<p>*NORDYF is supported only for printers and devices attached to the system using APPC or TCP/IP. For an APPC connection, use this value only with the PSF Direct support provided by Infoprint Manager for AIX or Infoprint Manager for Windows NT and Windows 2000. For a TCP/IP connection, this value can be used for any printer. This value is not supported for twinaxial-attached printers.
</p>
</dd>
<dt><b>*IMMED</b></dt>
<dd>The release timer is activated immediately after PSF has successfully linked to the printer. If the release timer expires, the session to the printer is released but the writer does not end. If a file is being printed when the release timer expires, the writer releases the session after all pages of the spooled file have printed. When the session is released, another PSF can start a session to the printer.
<p>Use this value when you want the writer to share the printer with another print writer.
</p>
<p>*IMMED is supported only for printers and devices attached to the system using APPC or TCP/IP. For an APPC connection, use this value only with the PSF Direct support provided by Infoprint Manager for AIX or Infoprint Manager for Windows NT and Windows 2000. For a TCP/IP connection, this value can be used for any printer. This value is not supported for twinaxial-attached printers.
</p>
</dd>
<dt><b>*PRTNORDYF</b></dt>
<dd>This value can be specified if you are using a printer that allows control over the exchange of IPDS data (the IPDS dialog). Refer to Printer Information, S544-5750 to determine if your printer supports this feature.
<p>This value specifies that the release timer is to be activated after all of these conditions are met:
</p>
<ul>
<li>The writer receives an indication from the printer to release the IPDS dialog.
</li>
<li>There are no ready spooled files in the printer's output queue.
</li>
<li>The last page of the last spooled file processed has printed.
</li>
</ul>
<p>If the release timer expires, the writer releases the IPDS dialog with the printer. The session is not released and the port in use by the writer is not available to another PSF. Another printer driver can start a dialog with the printer on a different printer port.
</p>
<p>If the writer detects that the printer is not capable of controlling the IPDS dialog, then the value is ignored and PSF behaves as if RLSTMR(*NOMAX) was specified.
</p>
<p>Use this value when you want the writer to print all ready spooled files with before releasing the IPDS dialog.
</p>
<p>*PRTNORDYF is supported on a twinaxial, TCP/IP or APPC connection.
</p>
</dd>
<dt><b>*PRTIMMED</b></dt>
<dd>This value can be specified if you are using a printer that allows control over the exchange of IPDS data (the IPDS dialog). Refer to Printer Information, S544-5750 to determine if your printer supports this feature.
<p>This value specifies that the release timer is to be activated immediately after the writer receives an indication from the printer to release the IPDS dialog. If the release timer expires, the writer releases the IPDS dialog with the printer, but the session is not released. The port in use by the writer is not available for use by another PSF, however another printer driver can start a dialog with the printer on a different printer port. If a file is being printed when the release timer expires, the writer releases the dialog after all pages of the spooled file have printed.
</p>
<p>Use this value when you want to specify the length of time the writer controls the printer after the printer has indicated that it is needed by a printer driver at another printer port.
</p>
<p>If the writer detects that the printer is not capable of telling the writer to stop the flow of data, then this value is ignored, and PSF behaves as if RLSTMR(*NOMAX) was specified.
</p>
<p>*PRTIMMED is supported on a twinaxial, TCP/IP or APPC connection.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.RLSTMR"></a>
<h3>Release timer (RLSTMR)</h3>
<p>Specifies the amount of time to wait after the release timer has been activated and the last page of the last ready spooled file has printed before releasing the printer. Print Services Facility (PSF) does not end, but releases the connection or IPDS dialog with the printer. See the <b>Activate release timer (ACTRLSTMR)</b> parameter description for additional information on the release timer.
</p>
<p>When a spooled file becomes ready, PSF attempts to establish a session with the printer. See the <b>Restart timer (RESTRTMR)</b> parameter description for additional information.
</p>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>The printer is not released unless the End Writer (ENDWTR) command is run.
</dd>
<dt><b>*SEC15</b></dt>
<dd>PSF waits 15 seconds before releasing the printer.
</dd>
<dt><b>*SEC30</b></dt>
<dd>PSF waits 30 seconds before releasing the printer.
</dd>
<dt><b><i>1-1440</i></b></dt>
<dd>Specify the number of minutes the printer writer waits before releasing the printer or IPDS dialog.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.RESTRTMR"></a>
<h3>Restart timer (RESTRTMR)</h3>
<p>Specifies the amount of time to wait before the printer writer attempts to re-establish either a session or dialog. To determine whether a session or dialog is to be re-established, the printer writer considers the following:
</p>
<ul>
<li>The value specified for ACTRLSTMR.
</li>
<li>Whether the printer supports IPDS dialog management.
</li>
<li>The type of link: twinaxial, APPC or TCP/IP.
</li>
</ul>
<p>If ACTRLSTMR(*NORDYF) or ACTRLSTMR(*IMMED) are specified, the session is restarted if the printer is attached using APPC or TCP/IP.
</p>
<p>If ACTRLSTMR(*PRTNORDYF) or ACTRLSTMR(*PRTIMMED) are specified, the dialog is restarted if the printer supports dialog management.
</p>
<p>See the <b>Activate release timer (ACTRLSTMR)</b> parameter description for additional information about session and dialog management control.
</p>
<dl>
<dt><b><u>*IMMED</u></b></dt>
<dd>The printer writer attempts to re-establish the session or dialog as soon as a spooled file has a status of RDY.
</dd>
<dt><b><i>1-1440</i></b></dt>
<dd>Specify the number of minutes the printer writer waits, after a session or dialog have been released and a spooled file has a status of RDY, before attempting to connect.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.RETRY"></a>
<h3>APPC and TCP/IP retry count (RETRY)</h3>
<p>Specifies the number of times to retry a session start request when attempting to establish a session with a printer. This parameter applies to printers and devices configured for either TCP/IP or APPC.
</p>
<dl>
<dt><b><u>15</u></b></dt>
<dd>Fifteen retry attempts are made to establish a session. If after fifteen retries Print Services Facility (PSF) still cannot establish a session, the printer writer ends.
</dd>
<dt><b>*NOMAX</b></dt>
<dd>No limit is put on the number of retries. PSF continues issuing session start requests until the session is established or the printer writer is ended using ENDWTR OPTION(*IMMED).
</dd>
<dt><b><i>1-99</i></b></dt>
<dd>Specify the number of retry attempts to establish a session.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.RETRYDLY"></a>
<h3>Delay between APPC retries (RETRYDLY)</h3>
<p>Specifies the number of seconds Print Services Facility (PSF) pauses after it receives notification that a session start request has failed. After the specified time has elapsed, another session start request is issued. The number of retries performed by PSF is controlled by parameter RETRY. This parameter applies to printers and devices configured for APPC.
</p>
<dl>
<dt><b><u>90</u></b></dt>
<dd>A 90-second delay will be used between retry attempts.
</dd>
<dt><b><i>0-999</i></b></dt>
<dd>Specify the number of seconds to pause between retry attempts to establish a session.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.ACKFRQ"></a>
<h3>Acknowledgment frequency (ACKFRQ)</h3>
<p>Specifies the frequency, in pages, with which Print Services Facility (PSF) sends IPDS acknowledgment requests to a printer. The acknowledgment request responses from the printer contain information about the status of pages sent to the printer.
</p>
<p>If a spooled file contains fewer pages than specified for ACKFRQ, an acknowledgment is requested after the last page of the spooled file is sent.
</p>
<p>Consider adjusting this value when specifying AUTOSSNRCY(*YES). When a connection with a printer is abnormally ended, PSF may reprint pages because the printer was unable to return the status of pages printed. By increasing the frequency with which acknowledgments are sent, the number of pages which might be reprinted is decreased when a severed connection is restored. However, if acknowledgments are requested with great frequency, such as once per page, you may notice a performance degradation.
</p>
<p>Acknowledgment frequency is supported on all attachments: twinaxial, APPC and TCP/IP. Note that AUTOSSNRCY is supported on APPC and TCP/IP attachments only.
</p>
<dl>
<dt><b><u>100</u></b></dt>
<dd>Specifies that an acknowledgment request is sent to the printer after every 100 pages.
</dd>
<dt><b><i>1-32767</i></b></dt>
<dd>Specifies the number of pages after which PSF sends an acknowledgment request to the printer.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PRTRSPTMR"></a>
<h3>Printer response timer (PRTRSPTMR)</h3>
<p>Specifies the time, in seconds, to wait for a response from a TCP/IP attached printer.
</p>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>The printer writer will wait for a response from the printer until one is received. If the writer does not receive a message, it is never ended.
</dd>
<dt><b><i>5-3600</i></b></dt>
<dd>Specifies the time, in seconds, the printer writer should wait for a response from the printer. The writer is ended if the printer does not respond within the specified amount of time. If this happens, the writer ends and a message is sent to the message queue.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFGEN"></a>
<h3>Generate PDF output (PDFGEN)</h3>
<p>Specifies whether to generate a PDF output file through an IPDS to PDF transform when processing the spooled file. You can spool the generated PDF file, store it as a stream file, send it as electronic mail, or any combination of those. You must have Infoprint Server installed to support this feature.
</p>
<p>In order to generate PDF, the remote location name for the printer device description must either be a valid loopback address or a name associated with a valid loopback address. An Internet address representing a valid loopback address must have 127 as the first octet of the Internet address.
</p>
<p><b>Single value</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>Do not generate a PDF output file.
</dd>
</dl>
<p><b>Other values (up to 3 repetitions)</b>
</p>
<dl>
<dt><b>*SPLF</b></dt>
<dd>Place the generated PDF output file in a spooled file. The value specified for the <b>PDF output queue (PDFOUTQ)</b> parameter identifies the output queue to be used.
</dd>
<dt><b>*STMF</b></dt>
<dd>Place the generated PDF output file in a stream file. The value specified for the <b>PDF directory (PDFDIR)</b> parameter identifies the integrated file system (IFS) directory to be used.
</dd>
<dt><b>*MAIL</b></dt>
<dd>Electronically mail the PDF output file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFDEVTYPE"></a>
<h3>PDF device emulation type (PDFDEVTYPE)</h3>
<p>Specifies the type of device that the IPDS to PDF transform's virtual printer should emulate.
</p>
<dl>
<dt><b><u>*IP40240</u></b></dt>
<dd>Emulate an IP40 printer device configured at 240 pel resolution.
</dd>
<dt><b>*IP40300</b></dt>
<dd>Emulate an IP40 printer device configured at 300 pel resolution.
</dd>
<dt><b>*4028</b></dt>
<dd>Emulate a 4028 printer device.
</dd>
<dt><b>*3812</b></dt>
<dd>Emulate a 3812 printer device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFPPRDWR1"></a>
<h3>PDF paper size drawer 1 (PDFPPRDWR1)</h3>
<p>Specifies the size of paper in drawer one of the device associated with the IPDS to PDF transform. This information is used to determine the generated PDF page size.
</p>
<dl>
<dt><b><u>*LETTER</u></b></dt>
<dd>North American letter size media (8.5 x 11 inches).
</dd>
<dt><b>*LEGAL</b></dt>
<dd>North American legal size media, (8.5 x 14 inches).
</dd>
<dt><b>*STATEMENT</b></dt>
<dd>North American statement size media (5.5 x 8.5 inches).
</dd>
<dt><b>*EXECUTIVE</b></dt>
<dd>North American executive size media (7.5 x 10.5 inches).
</dd>
<dt><b>*LEDGER</b></dt>
<dd>North American ledger size media (11 x 17 inches).
</dd>
<dt><b>*A5</b></dt>
<dd>ISO A5 size media (148.5 x 210 mm).
</dd>
<dt><b>*A4</b></dt>
<dd>ISO A4 size media (210 x 297 mm).
</dd>
<dt><b>*A3</b></dt>
<dd>ISO A3 size media (297 x 420 mm).
</dd>
<dt><b>*B5</b></dt>
<dd>ISO B5 size media (176 x 250 mm).
</dd>
<dt><b>*B4</b></dt>
<dd>ISO B4 size media (257 x 364 mm).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFPPRDWR2"></a>
<h3>PDF paper size drawer 2 (PDFPPRDWR2)</h3>
<p>Specifies the size of paper in drawer two of the device associated with the IPDS to PDF transform. This information is used to determine the generated PDF page size.
</p>
<dl>
<dt><b><u>*LETTER</u></b></dt>
<dd>North American letter size media (8.5 x 11 inches).
</dd>
<dt><b>*LEGAL</b></dt>
<dd>North American legal size media, (8.5 x 14 inches).
</dd>
<dt><b>*STATEMENT</b></dt>
<dd>North American statement size media (5.5 x 8.5 inches).
</dd>
<dt><b>*EXECUTIVE</b></dt>
<dd>North American executive size media (7.5 x 10.5 inches).
</dd>
<dt><b>*LEDGER</b></dt>
<dd>North American ledger size media (11 x 17 inches).
</dd>
<dt><b>*A5</b></dt>
<dd>ISO A5 size media (148.5 x 210 mm).
</dd>
<dt><b>*A4</b></dt>
<dd>ISO A4 size media (210 x 297 mm).
</dd>
<dt><b>*A3</b></dt>
<dd>ISO A3 size media (297 x 420 mm).
</dd>
<dt><b>*B5</b></dt>
<dd>ISO B5 size media (176 x 250 mm).
</dd>
<dt><b>*B4</b></dt>
<dd>ISO B4 size media (257 x 364 mm).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFMULT"></a>
<h3>Multiple PDF files (PDFMULT)</h3>
<p>Specifies the action the IPDS to PDF transform should take when encountering multiple groups within the input data.
</p>
<p><b>Single value</b>
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Ignore group boundaries and create a single output file.
</dd>
</dl>
<p><b>Element 1: Acknowledge multiple groups</b>
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Process multiple groups with the IPDS to PDF transform based on the value specified for element 2 of this parameter.
</dd>
</dl>
<p><b>Element 2: Process option</b>
</p>
<dl>
<dt><b><u>*SPLIT</u></b></dt>
<dd>Multiple PDF output files will be generated. The file will be split at group boundaries.
</dd>
<dt><b>*INDEX</b></dt>
<dd>An index tag or bookmark will be placed at the group boundaries in a single output file.
<p>If *INDEX is requested, bookmarks will be labeled according to:
</p>
<ul>
<li>the group name on the DDS STRPAGGRP keyword or
</li>
<li>index entries generated by CRTAFPDTA or
</li>
<li>BNG tags inserted by Toolbox
</li>
</ul>
<p>If characters in the group name are not available in the standard PDF encoding they will be presented as a space.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFINCFNT"></a>
<h3>PDF fonts inline (PDFINCFNT)</h3>
<p>Specifies whether the PDF output generated by the IPDS to PDF transform carries the necessary fonts inline. Including the fonts inline guarantees font fidelity but increases the PDF file size.
</p>
<p>If the user chooses not to have the fonts embedded, the IPDS Type 1 font name character string is moved to the PDF font controls. When the document is viewed the Acrobat Reader will map IBM's core font names to the equivalent Adobe or client environment set of core fonts. For any font name character strings that Adobe Acrobat does not have an equivalent for, Adobe Acrobat will use the Adobe multi-master font substitution program to select the available font that will constitute the "best fit".
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The fonts should be carried inline with the PDF output.
</dd>
<dt><b>*NO</b></dt>
<dd>The fonts should not be carried inline with the PDF output.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFDTAQ"></a>
<h3>PDF data queue (PDFDTAQ)</h3>
<p>Specifies the name of the data queue where Print Services Facility (PSF) will log the IPDS to PDF transformation completion notifications.
</p>
<p>This parameter is optional, but if a data queue is specified, the data queue must exist when this command is run.
</p>
<p><b>Single value</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>IPDS to PDF transformation completion notifications will not be logged to any data queue.
</dd>
</dl>
<p><b>Qualifier 1: PDF data queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the data queue to be used.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the data queue is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFMAILSVR"></a>
<h3>PDF mail server name (PDFMAILSVR)</h3>
<p>Specifies which mail server to use for electronically mailing the resulting PDF file from the IPDS to PDF transform. This parameter is only valid if PDFGEN(*MAIL) is specified.
</p>
<p><b>Single value</b>
</p>
<dl>
<dt><b><u>*SNDDST</u></b></dt>
<dd>Use the Send Distribution (SNDDST) command to e-mail the PDF output.
</dd>
</dl>
<p><b>Other values (up to 4 repetitions)</b>
</p>
<dl>
<dt><b>*LOCAL</b></dt>
<dd>Use the local machine as the mail server. The SMTP protocol is used for sending the e-mail. You can specify *LOCAL in any position in the list of mail servers.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the domain name or Internet address of the mail server to use to electronically mail the PDF output.
<p>You can specify up to 4 mail servers. The writer uses the mail servers in the order in which they are listed. If the writer detects that the first mail server cannot be used, the writer will attempt to use the additional servers that have been specified in the list. Print Services Facility (PSF) internally reorganizes the list of servers, making certain to always first attempt to use the last server that was working.
</p>
<p>If no usable server can be found in the list, the action taken is determined by the value specified for the PRTERRMSG parameter of the printer device description. If PRTERRMSG(*INFO) is specified, the writer is ended. If PRTERRMSG(*INQ) is specified, then an inquiry message is issued.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFSENDER"></a>
<h3>Sender of electronic mail (PDFSENDER)</h3>
<p>Specifies the name to use as the sender for a PDF file sent by electronic mail.
</p>
<dl>
<dt><b><u>*SPLFOWN</u></b></dt>
<dd>Print Services Facility (PSF) uses the user profile for the spooled file's owner to obtain the sender of the electronic mail.
</dd>
<dt><b>QSPLJOB</b></dt>
<dd>The electronic mail is being sent from PSF.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify a valid user profile. PSF uses this user profile to obtain the sender of the electronic mail.
</dd>
</dl>
<p>When PSF uses a user profile to determine the electronic mail sender, the user profile must exist on the system and must have an entry in the System Distribution Directory with a user ID specified. If you are using an SMTP mail server to send the mail, the directory entry must also have an SMTP user ID. If the profile has an SMTP User ID, that User ID is used as the sender, even if you use SNDDST to send the mail. Otherwise, if you use SNDDST to send the mail and there is no SMTP User ID, the profile's User ID is used.
</p>
<p>For example, if user profile MY_PROFILE has a User ID of JIM and an SMTP User ID of JIMJ, the electronic mail sender is JIMJ, regardless of the mail server used. If the user profile had no SMTP User ID and you use SNDDST to send the mail, the electronic mail sender is JIM.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFADMIN"></a>
<h3>PDF administrator (PDFADMIN)</h3>
<p>Specifies the e-mail address for the designated PDF administrator. The administrator will be notified when files cannot be delivered to the designated destination. Not all failures will be recoverable, as some errors occur after control of the delivery has passed to other components of the system. For example, the PDF administrator is not notified of undeliverable e-mails.
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No PDF administrator is specified. If e-mail notification was to be sent to a PDF administrator, the notification will not be sent.
</dd>
<dt><b><i>'character-value'</i></b></dt>
<dd>Specify no more than 80 characters of text that constitutes a valid e-mail address, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFMAPPGM"></a>
<h3>PDF user program (PDFMAPPGM)</h3>
<p>Specifies the name of a mapping program that Print Services Facility (PSF) will call to customize the PDF transform, such as specifying encryption or, when the PDF is being sent as e-mail, resolving one or more mail tags in the spooled file. If a mapping program is not specified, PSF assumes that the mail tag is a valid electronic mail address and will attempt to send the file using the information in the mail tag.
</p>
<p>The PSF configuration object will not be created if the mapping program specified does not exist. If the mapping program is deleted before the spooled file is processed, the PDF output file will be deleted, an error message will be issued to the message queue associated with the printer writer, and the original spooled file will be held.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No mapping program will be used to customize the PDF transform.
</dd>
<dt><b>*IBMPGM</b></dt>
<dd>The default IBM-supplied mapping program will be used to customize the PDF transform. If the value *IBMPGM is specified, you must also specify a value for the PDFMAP parameter.
</dd>
</dl>
<p><b>Qualifier 1: PDF user program</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user mapping program to be used.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the user mapping program is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFMAP"></a>
<h3>PDF mapping object (PDFMAP)</h3>
<p>Specifies the name of a mapping object that Print Services Facility (PSF) will pass to the PDF mapping program. If no mapping object is specified, PSF assumes that the mapping program does not require one. A mapping object is required if *IBMPGM is specified as the mapping program on the PDFMAPPGM parameter. Also, if you specify a mapping object, you must specify *IBMPGM on the PDFMAPPGM parameter.
</p>
<p>The PSF configuration object will not be created if the mapping object specified does not exist. If the mapping object is deleted before the spooled file is processed, the PDF output file will be deleted, an error message will be issued to the message queue associated with the printer writer, and the original spooled file will be held.
</p>
<p><b>Single value</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No mapping object will be passed to the specified mapping program to resolve file destination.
</dd>
</dl>
<p><b>Qualifier 1: PDF mapping object</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user mapping object.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the user mapping object is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFOUTQ"></a>
<h3>PDF output queue (PDFOUTQ)</h3>
<p>Specifies the output queue to be used when *SPLF is specified for the <b>Generate PDF output (PDFGEN)</b> parameter. A value is required for this parameter when *SPLF is specified for the PDFGEN parameter.
</p>
<p><b>Qualifier 1: PDF output queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the output queue to be used.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the output queue is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PDFDIR"></a>
<h3>PDF directory (PDFDIR)</h3>
<p>Specifies the path where the PDF file should be stored. An integrated file system directory must be specified when *STMF is specified for the PDFGEN parameter. The name must begin with a /. The directory name in the path cannot contain any of the following characters: \ &lt; &gt; " ? : * |
</p>
<p>The subdirectories and files created by the transform will be owned by the original spooled file owner and will have public authority of *EXCLUDE.
</p>
<p>If you want to e-mail this file later, specify <b>QDLS/directory-name</b> for the PDF directory. This will cause your file to be stored in the following location:
</p>
<p><b>/QDLS/directory-name/job-name/job-number/job-user-name/file-number/date/sequence-number/</b>
</p>
<p>For storage in the root file system, simply specify the subdirectory where the file should be stored (directory-name). This will cause your file to be stored in the following location:
</p>
<p><b>/directory-name/job-name/job-number/job-user-name/job-number_file-number_date_sequence-number/</b>
</p>
<p>
<b>Note: </b>The last subdirectory is a concatenation of a number of values to guarantee a unique file name.
</p>
<p>The file name components are explained below:
</p>
<ul>
<li><b>job-name</b> The ten character job name of the original spooled file
</li>
<li><b>job-number</b> The job number assigned to the original spooled file, prefixed by the last two characters of the job name
</li>
<li><b>job-user-name</b> The ten character name of the original spooled file owner
</li>
<li><b>file-number</b> The file number of the original spooled file, prefixed by the last two characters of the job-user-name
</li>
<li><b>date</b> The two digit month appended to the two digit day appended to the four digit year when the PDF transform completed
</li>
<li><b>sequence-number</b> A six character sequence number. It will be set to 000001 if PDFMULT is *NO. If PDFMULT is *YES, the sequence number is incremented to uniquely identify each PDF file generated for the job.
</li>
</ul>
<dl>
<dt><b><i>'character-value'</i></b></dt>
<dd>Specify the name of the integrated file system (IFS) directory to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.AFPSAVE"></a>
<h3>Save AFP data (AFPSAVE)</h3>
<p>Specifies whether the Print Services Facility (PSF) product should activate the capability to retain the generated AFPDS file on an output queue upon completion of processing. This parameter specifies that PSF should generate an AFPDS file from an SCS, AFPDS, IPDS, PostScript, PCL, or PDF input data stream and place the AFPDS on an output queue. The output queue will be determined by a user exit program in the case of segmented print requests, or by the value provided by the AFPOUTQ parameter in the PSF configuration object. The AFPOUTQ parameter is required if AFPSAVE is set to *YES.
</p>
<p>This setting will be ignored for input data streams of line and mixed mode data and when IPDS passthrough is active. You must have Infoprint Server installed to support PostScript, PCL, and PDF input data streams.
</p>
<p>
<b>Note: </b>If you are not processing segmented print requests using a PDF mapping program, you must also specify a value for the AFPRESPOOL argument to the USRDFNDTA parameter when submitting your print request for this function to be performed. Refer to Printer Device Programming, SC41-5713 for more information on using the USRDFNDTA parameter.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The file should not be saved after processing has been completed.
</dd>
<dt><b>*YES</b></dt>
<dd>The generated AFPDS file may be saved after processing has been completed. For the AFPDS file to be saved, the input data stream must support the saving of AFPDS data and must meet one of these conditions:
<ul>
<li>The print request is segmented and the PDF mapping program requests that the segment be respooled.
</li>
<li>The print request is not segmented and the user has specified the AFPRESPOOL argument in the USRDFNDTA parameter on the print request.
</li>
</ul>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.AFPOUTQ"></a>
<h3>AFP output queue (AFPOUTQ)</h3>
<p>Specifies the output queue to use when *YES is specified for the <b>Save AFP data (AFPSAVE)</b> parameter. A value is required for this parameter when *YES is specified for the AFPSAVE parameter. Segmented print requests using a PDF mapping program can override this value.
</p>
<p><b>Qualifier 1: PDF output queue</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the output queue to use.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the output queue is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the Print Services Facility (PSF) configuration object.
</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="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.AUTOSSNRCY"></a>
<h3>Automatic session recovery (AUTOSSNRCY)</h3>
<p>Specifies whether Print Services Facility (PSF) will automatically attempt to resume printing when a session has been unexpectedly ended by a device. This parameter applies to devices configured in a printer device description for an APPC or TCP/IP attachment.
</p>
<p><b>Single value</b>
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Specifies that PSF ends when a session has been unexpectedly ended by a device.
</dd>
</dl>
<p><b>Element 1: Enabled</b>
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>Specifies that PSF attempts to re-establish a session which has been unexpectedly ended by a device.
</dd>
</dl>
<p>If you are using a printer device description which specifies an APPC attachment, note the following:
</p>
<ul>
<li>PSF configuration object parameters RETRY and RETRYDLY are used when PSF is attempting to re-establish a session.
</li>
<li>You must use an APPC controller description and an APPC device description that specifies APPN(*YES). Additionally, the APPC controller description must have MINSWTSTS(*VRYONPND) specified.
</li>
</ul>
<p>If you are using a printer device description which specifies a TCP/IP connection, then PSF configuration object parameter RETRY is used when PSF is attempting to re-establish a session.
</p>
<p>To avoid reprinting pages, you may want to specify *INQ for this parameter's second element or decrease the value specified for the <b>Acknowledgment frequency (ACKFRQ)</b> parameter.
</p>
<p>If you decrease the Acknowledgment frequency, PSF will be able to track printed pages more closely. However, there could be some degradation in performance. This depends on your network and your perception of the performance.
</p>
<p>If you select inquiry message notification (*INQ), then you can be very specific about the page at which printing should resume.
</p>
<p><b>Element 2: Message option</b>
</p>
<dl>
<dt><b>*INFO</b></dt>
<dd>An informational message is sent to the message queue associated with the writer when PSF is performing automatic session recovery.
</dd>
<dt><b>*INQ</b></dt>
<dd>An inquiry message is sent to the message queue associated with the writer when PSF is performing automatic session recovery. This message lets you specify the page number from which a writer should begin printing the last spooled file being processed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.BLANKPAGE"></a>
<h3>Blank page (BLANKPAGE)</h3>
<p>Specifies whether Print Services Facility (PSF) issues a blank page after every separator page and spooled file copy that contains an odd number of pages. The blank pages assure that the printer output is placed into the output stacker in a manner suitable for bursting. This parameter only applies to the following continuous forms printers:
</p>
<ul>
<li>3831
</li>
<li>3835
</li>
<li>3900-001
</li>
<li>All AFCCU continuous forms printers.
</li>
</ul>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>PSF issues a blank page after every separator page and spooled file copy that contains an odd number of pages.
</dd>
<dt><b>*NO</b></dt>
<dd>PSF does not issue a blank page after every separator page and spooled file copy that contains an odd number of pages.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PAGSIZCTL"></a>
<h3>Page size control (PAGSIZCTL)</h3>
<p>Specifies whether the page size (forms) in the printer is set by Print Services Facility (PSF). This parameter only applies to IPDS printers which support the Set Media Size (SMS) operation. Refer to Printer Information, S544-5750 for new device support, but the list includes:
</p>
<ul>
<li>Impact printers: 4224, 4230, 4234, 4247, 6400, 6408, 6412
</li>
<li>Workgroup printers: 3112, 3116, 3812, 3816, 3912, 3916, 3930, 4028, Network printer 12/17/24, Infoprint 20/21/32/40/70/70+/2085/2105
</li>
<li>Lexmark printers: Infoprint 1120/1125/1130/1140/1145/1226, Infoprint Color 1220/1228 4224, 4230, 4234, 4247, 4028, 6404, 6408, 6412 and IBM Network Printers.
</li>
<li>Thermal printer: 4400
</li>
</ul>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The page size (forms) in the printer is not set by PSF.
</dd>
<dt><b>*YES</b></dt>
<dd>The page size (forms) in the printer is set by PSF.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.RESFONT"></a>
<h3>Resident fonts (RESFONT)</h3>
<p>Specifies whether Print Services Facility (PSF) supports resident fonts on a printer that has resident fonts. Not supporting resident fonts causes PSF to map the resident font reference to its equivalent host font and then download the host font to the printer.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Resident fonts for the printer are supported by PSF.
</dd>
<dt><b>*NO</b></dt>
<dd>Resident fonts for the printer are not supported by PSF. PSF maps the resident font referenced in the spooled file to its equivalent host font and then downloads the host font to the printer.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.RSCRET"></a>
<h3>Resource retention (RSCRET)</h3>
<p>Specifies whether resource retention across spooled files is supported by Print Services Facility (PSF).
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>PSF stores page segments and overlays in the printer across spooled file boundaries. This minimizes data transfers, especially when printing multiple spooled files that reference the same resources.
</dd>
<dt><b>*NO</b></dt>
<dd>PSF does not store page segments and overlays in the printer across spooled file boundaries. They are deleted after each spooled file.
<p>
<b>Note: </b>The page segments and overlays are deleted in the printer when the printer writer is ended.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.EDGEORIENT"></a>
<h3>Edge orient (EDGEORIENT)</h3>
<p>Specifies whether additional page rotation should be performed. When the page rotation value of a spooled file is *COR or *AUTO and the system rotates the output, 90 degree rotation is normally used.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The output remains at its original orientation.
</dd>
<dt><b>*YES</b></dt>
<dd>*COR and *AUTO output of 90 degrees is rotated an additional 180 degrees before printing.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.USEOUTLFNT"></a>
<h3>Use outline fonts (USEOUTLFNT)</h3>
<p>Specifies whether the requested downloadable AFP raster fonts should be replaced with the equivalent downloadable outline fonts.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The raster fonts will be used.
</dd>
<dt><b>*YES</b></dt>
<dd>If the equivalent downloadable outline font exists, it will be used in place of the raster font.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.PSFDFNOPT"></a>
<h3>PSF defined option (PSFDFNOPT)</h3>
<p>Specifies a value as defined by IBM.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No Print Services Facility (PSF) defined options are specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify a value as defined by IBM. One or more values may be made available between releases of OS/400. If a value is made available, a PTF cover letter will contain the required syntax.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.FNTSUBMSG"></a>
<h3>Font substitution messages (FNTSUBMSG)</h3>
<p>Specifies whether Print Services Facility (PSF) will issue messages indicating that a successful font substitution was performed.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Messages indicating that a successful font substitution was performed are issued.
</dd>
<dt><b>*NO</b></dt>
<dd>Messages indicating that a successful font substitution was performed are not issued. Messages indicating that a font substitution attempt failed will still be issued.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.FNTCAPTURE"></a>
<h3>Capture host fonts at printer (FNTCAPTURE)</h3>
<p>Specifies whether the printer should capture host downloaded fonts.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The printer should not capture host fonts.
</dd>
<dt><b>*YES</b></dt>
<dd>The font character set or code page is eligible to be captured after downloading to the printer. If the printer does not support font capturing, this information is ignored and the font is downloaded.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.FNTRSL"></a>
<h3>Font resolution for formatting (FNTRSL)</h3>
<p>Specifies the resolution Print Services Facility (PSF) should use under these conditions:
</p>
<ul>
<li>you are printing to a multiple-resolution printer
</li>
<li>the printer is configured to report support of multiple resolutions
</li>
<li>the spooled file does not specify the font metrics and resolution with which to print the spooled file or the font is not available at that resolution
</li>
</ul>
<p>If the printer is configured to report support of either 240 pels per inch or 300 pels per inch only, then PSF will produce the same results as if going to a single resolution printer.
</p>
<p>Refer to Printer Device Programming, SC41-5713 for more information regarding the algorithm used for searching a library list for a font resource.
</p>
<dl>
<dt><b><u>*SEARCH</u></b></dt>
<dd>Search the library list for the first occurrence of a host font with a name match. The resolution of that font will be used to print the spooled file. Message PQT3546 will be issued when this value is selected to indicate to the user the resolution of the font that was finally selected.
</dd>
<dt><b>240</b></dt>
<dd>The font resolution used to print the spooled file should be 240 pels per inch.
</dd>
<dt><b>300</b></dt>
<dd>The font resolution used to print the spooled file should be 300 pels per inch.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.FNTTBL"></a>
<h3>Font mapping table (FNTTBL)</h3>
<p>Specifies the name of a printer-resident to printer-resident font mapping table. Print Services Facility (PSF) uses this font mapping table when printing to a printer which supports printer-resident fonts but the spooled file specifies a printer-resident font that the printer does not support.
</p>
<p>For the printer-resident to printer-resident font substitution table, the following processing is done by the system:
</p>
<ul>
<li>If the printer-resident font specified in the print job is supported by the printer, then it is used. The printer-resident to printer-resident font substitution table is not searched.
</li>
<li>If the printer-resident font specified in the print job is not supported by the printer, then the printer-resident to printer-resident font substitution table is searched.
<ul>
<li>If a matching entry is found in the printer-resident font substitution table and the entry is supported by the printer, then the specified substitute font in the printer-resident font substitution table is used.
</li>
<li>If a matching entry is not found in the printer-resident font substitution table or if the specified substitute font is not supported by the printer, then the system will use its internal font substitution tables to perform the font substitution.
</li>
</ul>
</li>
</ul>
<p>Refer to Printer Device Programming, SC41-5713 for more information on supported printer-resident fonts. See the CRTFNTTBL, DSPFNTTBL, ADDFNTTBLE, CHGFNTTBLE, and RMVFNTTBLE commands for more information on user font tables.
</p>
<p><b>Single value</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No printer-resident to printer-resident font table is specified. For a print job that references a printer-resident font, if the font is not supported by the printer, the system will substitute another resident font.
</dd>
</dl>
<p><b>Qualifier 1: Font mapping table</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the printer-resident to printer-resident font table.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the font table is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.CSEMODE"></a>
<h3>Cut sheet emulation mode (CSEMODE)</h3>
<p>Specifies to what degree Print Services Facility (PSF) will do size checking of the document when using Cut Sheet Emulation.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No checking will be done to verify that the document page will fit on half the continuous forms physical page.
</dd>
<dt><b>*CHKFIRST</b></dt>
<dd>The first page of each copy group will be checked to determine if the page will fit on half the continuous forms page.
</dd>
<dt><b>*CHKALL</b></dt>
<dd>The front side page will be checked to determine if the page will fit on half the continuous forms page.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.MAPIGCFNT"></a>
<h3>Use DBCS simulation fonts (MAPIGCFNT)</h3>
<p>Specifies to use DBCS simulation fonts instead of the DBCS raster fonts specified in the data stream when printing the spooled file.
</p>
<p>DBCS simulation fonts are outline fonts that are positioned like raster fonts. This allows the use of outline fonts to print applications that use DBCS raster fonts without changing the application or the appearance of the printed output. Outline fonts are scalable, so it is not necessary to store font character sets for each point size on your system, and neither is it necessary to download a different font to the printer for every change in point size. This increases your system storage space and enhances printing performance.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Do not substitute DBCS simulation fonts for DBCS raster fonts.
</dd>
<dt><b>*YES</b></dt>
<dd>Substitute DBCS simulation fonts for DBCS raster fonts.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.REPLACE"></a>
<h3>Replace (REPLACE)</h3>
<p>Specifies whether an existing Print Services Facility (PSF) configuration object with the same name as the one being created, is replaced.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The existing PSF configuration object is replaced.
</dd>
<dt><b>*NO</b></dt>
<dd>If a PSF configuration object with same name exists in the library specified, the create operation fails. The existing PSF configuration object is not replaced.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTPSFCFG.AUT"></a>
<h3>Authority (AUT)</h3>
<p>Specifies the authority you are giving to users who do not have specific authority to the object, who are not on an authorization list, and whose group profile has no specific authority to the object.
</p>
<dl>
<dt><b><u>*LIBCRTAUT</u></b></dt>
<dd>The system determines the authority for the object by using the value specified for the <b>Create authority (CRTAUT)</b> parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the CRTAUT value for a library is changed by running the Change Library (CHGLIB) command, the new CRTAUT value will not affect any existing objects.
</dd>
<dt><b>*CHANGE</b></dt>
<dd>Change authority allows the user to change and perform basic functions on the object. Change authority provides object 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 object's existence, specify the security for the object, change the object, perform basic functions on the object, and change ownership of the object.
</dd>
<dt><b>*USE</b></dt>
<dd>Use authority provides object operational authority, read authority, and execute authority.
</dd>
<dt><b>*EXCLUDE</b></dt>
<dd>The user cannot access the object.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTPSFCFG.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTPSFCFG PSFCFG(QGPL/P5001) PDFGEN(*MAIL)
PDFDEVTYPE(*4028) PDFPPRDWR1(*LETTER)
PDFPPRDWR2(*LEGAL) PDFMULT(*YES *INDEX)
PDFDTAQ(*NONE) PDFINCFNT(*YES)
PDFMAILSVR(*SNDDST)
PDFSENDER(QSPLJOB) PDFMAPPGM(*NONE)
</pre>
</p>
<p>This command creates a Print Services Facility (PSF) configuration object named P5001 in the QGPL library. The PDFGEN parameter specifies that the spooled file is to be transformed to PDF and e-mailed by the SNDDST command. The transform is told to emulate a 4028 printer with paper sizes in drawers 1 and 2 to be letter and legal, respectively.
</p>
<p>The requested output will have PDF index tags at the group boundaries, the necessary fonts will be placed inline with the output file, the sender is PSF. Since there is no mapping program, the mail tag information associated with the file is assumed to be valid e-mail addresses.
</p>
<p>There will be no completion message logged to a data queue because this parameter has a value of *NONE.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTPSFCFG.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>
<dt><b>CPF9845</b></dt>
<dd>Error occurred while opening file &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTPSFCFG.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>