634 lines
26 KiB
HTML
634 lines
26 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>Send TCP/IP Spooled File (LPR)</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="LPR.Top_Of_Page"></a>
|
|
<h2>Send TCP/IP Spooled File (LPR)</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="#LPR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#LPR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#SNDTCPSPLF.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="SNDTCPSPLF"></a>
|
|
<p>The Send TCP/IP Spooled File (SNDTCPSPLF) command sends a spooled file to be printed on a remote system. The remote system must be running TCP/IP. The SNDTCPSPLF command is the iSeries version of the TCP/IP LPR (Line Printer Requester) command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="LPR.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"><a href="#SNDTCPSPLF.RMTSYS"><b>RMTSYS</b></a></td>
|
|
<td valign="top">Remote system</td>
|
|
<td valign="top"><i>Character value</i>, *INTNETADR</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDTCPSPLF.PRTQ"><b>PRTQ</b></a></td>
|
|
<td valign="top">Printer queue</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDTCPSPLF.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">Spooled file</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#SNDTCPSPLF.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top">Single values: <b><u>*</u></b><br>Other values: <i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job name</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#SNDTCPSPLF.SPLNBR"><b>SPLNBR</b></a></td>
|
|
<td valign="top">Spooled file number</td>
|
|
<td valign="top">0-999999, <b><u>*ONLY</u></b>, *LAST, *ANY</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDTCPSPLF.JOBSYSNAME"><b>JOBSYSNAME</b></a></td>
|
|
<td valign="top">Job system name</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ONLY</u></b>, *CURRENT, *ANY</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#SNDTCPSPLF.CRTDATE"><b>CRTDATE</b></a></td>
|
|
<td valign="top">Spooled file created</td>
|
|
<td valign="top">Single values: <b><u>*ONLY</u></b>, *LAST<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Creation date</td>
|
|
<td valign="top">
|
|
<i>Date</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Creation time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*ONLY</u></b>, *LAST</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDTCPSPLF.DESTTYP"><b>DESTTYP</b></a></td>
|
|
<td valign="top">Destination type</td>
|
|
<td valign="top">*AS400, *PSF2, <b><u>*OTHER</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDTCPSPLF.TRANSFORM"><b>TRANSFORM</b></a></td>
|
|
<td valign="top">Transform SCS to ASCII</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="#SNDTCPSPLF.USRDTATFM"><b>USRDTATFM</b></a></td>
|
|
<td valign="top">User data transform</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: User data transform</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"><a href="#SNDTCPSPLF.MFRTYPMDL"><b>MFRTYPMDL</b></a></td>
|
|
<td valign="top">Manufacturer type and model</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDTCPSPLF.INTNETADR"><b>INTNETADR</b></a></td>
|
|
<td valign="top">Internet address</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#SNDTCPSPLF.WSCST"><b>WSCST</b></a></td>
|
|
<td valign="top">Workstation customizing 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: Workstation customizing object</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"><a href="#SNDTCPSPLF.DLTSPLF"><b>DLTSPLF</b></a></td>
|
|
<td valign="top">Delete file after sending</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDTCPSPLF.DESTOPT"><b>DESTOPT</b></a></td>
|
|
<td valign="top">Destination-dependent options</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SNDTCPSPLF.SEPPAGE"><b>SEPPAGE</b></a></td>
|
|
<td valign="top">Print separator page</td>
|
|
<td valign="top">*NO, <b><u>*YES</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="SNDTCPSPLF.RMTSYS"></a>
|
|
<h3>Remote system (RMTSYS)</h3>
|
|
<p>Specifies the remote system name to which the print request is sent.
|
|
</p>
|
|
<p>To be successful, the name must be valid, and the system must be able to communicate with the local system. You can assign names to an internet address. Use the <b>Work with TCP/IP host table entries</b> option on the Configure TCP/IP menu (CFGTCP command). A remote name server also maps remote system names to internet addresses. You can use the <b>Change remote name server</b> option on the CFGTCP menu to specify a remote name server.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*INTNETADR</b></dt>
|
|
<dd>The value of the INTNETADR parameter is used.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the remote system name to which the print request is sent.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.PRTQ"></a>
|
|
<h3>Printer queue (PRTQ)</h3>
|
|
<p>Specifies the destination printer queue to be used.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of the destination printer queue to be used. For destination systems that are iSeries systems, this is the name of an output queue to which the spooled file is sent.
|
|
<p>If a library name qualifier is not specified, the library list of the sending user ID on the destination system is searched. If not found or not authorized, QGPL/QPRINT is used as the default. The output queue is usually specified as library name/output queue name (for example, QGPL/OUTQ1). For destination systems that are not iSeries systems, this name is system-dependent. This name can be either the actual name of the device or the name of a printer queue for the device. The name used for the OS/2 operating system is the actual name of the device. Often, the name used for the UNIX operating system is the name of the printer queue for the device. This parameter is limited to 128 characters.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>On some systems, the printer queue name may be case sensitive. To preserve the lowercase letters in a printer queue name, enclose the printer queue name in apostrophes 'MyPrtQ'.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.FILE"></a>
|
|
<h3>Spooled file (FILE)</h3>
|
|
<p>Specifies the spooled file that is sent to the specified system and printer. The file name is the same file name that is displayed with the Work with Spooled File (WRKSPLF) command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the spooled file to be sent.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the job that created the spooled file to be sent.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The job that issued this command is the job that created the spooled file.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Job name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the job that created the spooled file.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: User</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the user name of the job that created the spooled file.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 3: Number</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>000000-999999</i></b></dt>
|
|
<dd>Specify the job number of the job that created the spooled file.
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>If no job number or user name is given, all jobs currently running on the system are searched for a match against the job name.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.SPLNBR"></a>
|
|
<h3>Spooled file number (SPLNBR)</h3>
|
|
<p>Specifies the number of the spooled file from the job whose data records are to be sent.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>One spooled file from the job has the specified file name. The number of the spooled file is not necessary. If *ONLY is specified and more than one spooled file has the specified file name, an error message is sent.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The spooled file with the highest number and the specified file name is used.
|
|
</dd>
|
|
<dt><b><i>0-999999</i></b></dt>
|
|
<dd>Specify the number of the spooled file having the specified file name whose data records are to be sent.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.JOBSYSNAME"></a>
|
|
<h3>Job system name (JOBSYSNAME)</h3>
|
|
<p>Specifies the system from which the job that created the spooled file was ran on.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>One spooled file from the job with the specified job name, user name, job number, spooled file create date and spooled file create time. If *ONLY is specified and more than one spooled file has the specified information listed above, an error message is sent.
|
|
</dd>
|
|
<dt><b>*CURRENT</b></dt>
|
|
<dd>The job on the current system with the specified job name, user name, job number, spooled file create date and spooled file create time.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the system where the job ran that created the spooled file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.CRTDATE"></a>
|
|
<h3>Spooled file created (CRTDATE)</h3>
|
|
<p>Specifies the date the spooled file was created on the system. This parameter is considered after the job name, user name, job number, spooled file name, spooled file number, and job system name parameter requirements have been met.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>There is only one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and job system name.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The spooled file with the latest date and time which also has the specified job name, user name, job number, spooled file name, spooled file number, and job system name is used.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Creation date</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>date</i></b></dt>
|
|
<dd>Specify the date the spooled file was created.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Creation time</b>
|
|
</p>
|
|
<p>The spooled file create time is the time the spooled file was created on the system. This parameter must have a value set if a date is specified for the first element of this parameter. This create time is considered after the job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file create date requirements have been met.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>There is only one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, job system name, and create date.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The spooled file with the latest time which also has the specified job name, user name, job number, spooled file name, spooled file number, job system name, and create date is used.
|
|
</dd>
|
|
<dt><b><i>time</i></b></dt>
|
|
<dd>Specify the time the spooled file was created.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.DESTTYP"></a>
|
|
<h3>Destination type (DESTTYP)</h3>
|
|
<p>Specifies the type of destination system to which the spooled file is being sent. This information allows the SNDTCPSPLF command to send the file in a format that is most likely to be received and processed correctly on the destination system. When sending to another iSeries system, this parameter should be *AS400.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*OTHER</u></b></dt>
|
|
<dd>The destination system is not an iSeries system and is not using Print Services Facility/2.
|
|
</dd>
|
|
<dt><b>*AS400</b></dt>
|
|
<dd>The destination system is an iSeries system. If TRANSFORM(*NO) is specified, a duplicate of the spooled file is created on the destination system. If the spooled file is *SCS or *AFPDS and TRANSFORM(*YES) is specified, the spooled file is transformed to ASCII and spooled as *USERASCII on the destination iSeries system.
|
|
</dd>
|
|
<dt><b>*PSF2</b></dt>
|
|
<dd>The destination system is using Print Services Facility/2. This destination system can receive both ASCII data and Advanced Function Printer data stream (AFPDS) data. This means that in addition to sending ASCII data to a PSF/2, you can also send a spooled file of device type *AFPDS. When sending *AFPDS files, you must consider any external resources of the file. These resources, such as fonts and overlays, must also reside on the destination system to allow the file to print correctly.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.TRANSFORM"></a>
|
|
<h3>Transform SCS to ASCII (TRANSFORM)</h3>
|
|
<p>Specifies whether or not to make use of the host print transform function to transform a SNA character string (SCS) or Advanced Function Printing data stream (AFPDS) into ASCII data.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If you specify TRANSFORM(*YES), you cannot use the USRDTATFM parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Use the host print transform.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Do not use the host print transform.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.USRDTATFM"></a>
|
|
<h3>User data transform (USRDTATFM)</h3>
|
|
<p>Specifies the program that is used to transform the spooled file data. User data transform programs must be written to the Writer Transform Exit Program interface. For information on this interface, see the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No data transform program is specified.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: User data transform</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the data transform program.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
|
</dd>
|
|
<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>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.MFRTYPMDL"></a>
|
|
<h3>Manufacturer type and model (MFRTYPMDL)</h3>
|
|
<p>Specifies the manufacturer, type, and model for a printer using the host print transform function.
|
|
</p>
|
|
<p>If the <b>Workstation customizing object (WSCST)</b> parameter is used in conjunction with the MFRTYPMDL parameter, information that is specified in the workstation customization object takes precedence over the MFRTYPMDL parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*IBM42011</u></b></dt>
|
|
<dd>The IBM 4201-1 Proprinter is used.
|
|
</dd>
|
|
<dt><b><i>manufacturer-type-model</i></b></dt>
|
|
<dd>Specify the manufacturer, type, and model for a printer using the host print transform function. Specify one of the values that matches the device. Refer to the MFRTYPMDL parameter documentation for the Create Device Description (Printer) (CRTDEVPRT) command for a description of possible values.
|
|
</dd>
|
|
<dt><b>*WSCST</b></dt>
|
|
<dd>The value of the WSCST parameter is used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.INTNETADR"></a>
|
|
<h3>Internet address (INTNETADR)</h3>
|
|
<p>Specifies the internet address of the remote system to which the print request is sent.
|
|
</p>
|
|
<p>This parameter is accessed by entering *INTNETADR for the RMTSYS parameter or by leaving the RMTSYS parameter blank and pressing the Enter key.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the internet address of the remote system. The internet address is specified in the form, <i>nnn.nnn.nnn.nnn</i>, where <i>nnn</i> is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.WSCST"></a>
|
|
<h3>Workstation customizing object (WSCST)</h3>
|
|
<p>Specifies an object that consists of a table of attributes used to customize a given ASCII device, such as a workstation or printer. Character presentation, font specifications, and control key sequences are examples of characteristics that can be customized.
|
|
</p>
|
|
<p>If the <b>Manufacturer type and model (MFRTYPMDL)</b> parameter is used in conjunction with the WSCST parameter, information that is specified in the workstation customization object takes precedence over the MFRTYPMDL parameter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>Do not specify a workstation customizing object.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Workstation customizing object</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of a workstation customizing object that was created with the Create Work Station Customizing Object (CRTWSCST) command.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the user and system portions of the job's library list are searched until the first match is found.
|
|
</dd>
|
|
<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>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.DLTSPLF"></a>
|
|
<h3>Delete file after sending (DLTSPLF)</h3>
|
|
<p>Specifies whether or not to delete the specified spooled file after it has been successfully sent. No guarantee can be made as to the correct printing of the sent file. Only correct transmission can be verified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Do not delete the spooled file after it has been successfully sent.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Delete the spooled file after it has been successfully sent.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.DESTOPT"></a>
|
|
<h3>Destination-dependent options (DESTOPT)</h3>
|
|
<p>Specifies the destination-dependent options. These options may be specific to a particular implementation of an LPD print server. When this parameter is not specified, the SNDTCPSPLF command sends default options that are common to all LPD print servers. The options specified by this parameter are inserted into the control file generated by the SNDTCPSPLF command, one option per line, and sent to the specified LPD print server. The options specified by this parameter must have the following format:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
"option1 option2 option3...optionN"
|
|
</pre>
|
|
</p>
|
|
<p>where each option is separated from the next by one or more blanks.
|
|
</p>
|
|
<p>Options typically have a format of <control characters><value>. An example is
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
"-oTITLE=LPR"
|
|
</pre>
|
|
</p>
|
|
<p>where "-o" are the control characters and "TITLE=LPR" is the value. SNDTCPSPLF examines the first character of each option to determine if it is a reserved control character. The following control characters cannot be specified as their values are determined by SNDTCPSPLF. If any of the following control characters are specified, the option is ignored and a warning message is generated.
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
C T
|
|
H U
|
|
I W
|
|
L 1
|
|
M 2
|
|
N 3
|
|
P 4
|
|
S k
|
|
</pre>
|
|
</p>
|
|
<p>For example, "Class=ASCII" is not allowed because the "C" control character is reserved for use by the SNDTCPSPLF command. However, "-Class=ASCII" is permitted.
|
|
</p>
|
|
<p>The control character "X" is allowed, but the value of "AS/400" used with it is not permitted. For example, "XMyLPD" can be specified, but "XAS/400" cannot be. The option "XAS/400" is reserved for use by the SNDTCPSPLF command. It is used to indicate to another iSeries system that the request is coming from an iSeries system.
|
|
</p>
|
|
<p>The option "XAIX" controls how multiple copies are sent to the printer. This option specifies that the data and control files are to be sent multiple times, once for each copy. The default is to send the data and control files once, with multiple print commands in the control file.
|
|
</p>
|
|
<p>The following print "filters" are supported by SNDTCPSPLF (see section 7 of RFC 1179):
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
c n
|
|
d p
|
|
f r
|
|
g t
|
|
l v
|
|
</pre>
|
|
</p>
|
|
<p>If one of these characters is specified as the first character in a destination option, the character is used on the "print file" command in the control file. Only the first occurrence of one of these characters in this position is used in the control file. Subsequent use of these characters in this position is ignored. If none of these options is specified, the default character "l" is used on the "print file" command, which prints the file "as is" without filtering out any control characters.
|
|
</p>
|
|
<p>If "J" is specified as the first character of a destination option, the remaining characters in the option are used to override the default job name for the banner page (see RFC 1179, section 7.4). For instance, to specify a job name of /nff, specify:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DESTOPT('J/nff')
|
|
</pre>
|
|
</p>
|
|
<p>Only the first occurrence of this option is used to override the job name. If this option is not specified, the spooled file name is used as the job name (the default).
|
|
</p>
|
|
<p>You can enable an auto-queue option by using the destination dependent option XAUTOQ on the SNDTCPSPLF command (or on the CRTOUTQ or CHGOUTQ commands). When you use the auto-queue option, files are sent as before unless the remote system times out during the transform. If this happens, the transformed spool files are sent back to the same output queue using the iSeries LPD server. When a remote writer is running, it will then send the transformed spooled file to the remote system.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the destination-dependent options.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDTCPSPLF.SEPPAGE"></a>
|
|
<h3>Print separator page (SEPPAGE)</h3>
|
|
<p>Specifies whether or not a separator page is requested when the spooled file is printed on the remote system.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>A separator page may not be printed in all cases. Printing of separator pages depends on whether the LPD implementation on the receiving system honors the separator page request. Some LPD implementations ignore the SEPPAGE parameter and print or do not print a separator page by default.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Request a separator page.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>Do not request a separator page.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="LPR.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SNDTCPSPLF.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>TCP3701</b></dt>
|
|
<dd>Send request failed for spooled file &1.
|
|
</dd>
|
|
<dt><b>TCP3702</b></dt>
|
|
<dd>Not authorized to spooled file &1.
|
|
</dd>
|
|
<dt><b>TCP3703</b></dt>
|
|
<dd>Send request failed. Spooled file &1 open.
|
|
</dd>
|
|
<dt><b>TCP3704</b></dt>
|
|
<dd>Send request failed. Spooled file &1 not spooled print file.
|
|
</dd>
|
|
<dt><b>TCP3705</b></dt>
|
|
<dd>Spooled file &1 not transformed.
|
|
</dd>
|
|
<dt><b>TCP3706</b></dt>
|
|
<dd>Spooled file &1 not transformed.
|
|
</dd>
|
|
<dt><b>TCP3715</b></dt>
|
|
<dd>Not authorized to delete spooled file &1. The spooled file was sent.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#LPR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|