1PR3287(1) General Commands Manual PR3287(1)
2
6 pr3287 - IBM host printing tool
7
9 pr3287 [ options ] [ L: ] [[ LUname [, LUname ...]@] hostname [: port
10 ]]
11
13 pr3287 opens a telnet connection to an IBM host, and emulates an IBM
14 3287 printer. It implements RFCs 2355 (TN3270E), 1576 (TN3270) and
15 1646 (LU name selection).
16 If the hostname is prefixed with L:, the connection will be made
18 through an SSL tunnel. pr3287 also supports TELNET START-TLS option
19 negotiation without any need for command-line options.
20 A specific LU name to use may be specified by prepending it to the
22 hostname with an `@'. Multiple LU names to try can be separated by
23 commas. An empty LU can be placed in the list with an extra comma.
24 The port to connect to defaults to telnet. This can be overridden by
26 appending a port to the hostname with a colon `:'.
27
29 pr3287 understands the following options:
30 -assoc LUname
32 Causes the session to be associated with the specified LUname.
33 -blanklines
35 In LU3 formatted mode, print blank lines even if they are all
36 NULLs or control characters. (This is a violation of the 3270
37 printer protocol, but some hosts require it.)
38 -cadir directory
40 Specifies a directory containing CA (root) certificates to use
41 when verifying a certificate provided by the host.
42 -cafile filename
44 Specifies a PEM-format file containing CA (root) certificates to
45 use when verifying a certificate provided by the host.
46 -certfile filename
48 Specifies a file containing a certificate to provide to the
49 host, if requested. The default file type is PEM.
50 -certfiletype type
52 Specifies the type of the certificate file specified by -cert‐
53 file. Type can be pem or asn1.
54 -chainfile filename
56 Specifies a certificate chain file in PEM format, containing a
57 certificate to provide to the host if requested, as well as one
58 or more intermediate certificates and the CA certificate used to
59 sign that certificate. If -chainfile is specified, it overrides
60 -certfile.
61 -charset name
63 Specifies an alternate host code page (input EBCDIC mapping).
64 The default maps the U.S. English (037) code page to the current
65 locale character encoding. pr3287 generally supports the same
66 host character sets as x3270.
67 -command command
69 Specifies the command to run for each print job. The default is
70 lpr.
71 -crlf Causes newline characters in the output to be expanded to car‐
73 riage-return/linefeed sequences.
74 -daemon
76 Causes pr3287 to become a daemon (background) process.
77 -eojtimeout seconds
79 Causes pr3287 to complete the print job after seconds seconds of
80 inactivity.
81 -emflush
83 Causes pr3287 to flush any pending printer output whenever an EM
84 (End of Medium) order arrives in unformatted 3270 mode. This
85 can help preserve multi-page output with hosts that do not clear
86 the 3270 buffer between pages.
87 -ignoreeoj
89 Ignore TN3270E PRINT-EOJ commands, relying on UNBIND commands to
90 indicate the ends of print jobs.
91 -ffeoj Causes pr3287 to add a FF (formfeed) at the end of each print
93 job.
94 -ffskip
96 Causes pr3287 to ignore a FF (formfeed) order if it occurs at
97 the top of a page.
98 -ffthru
100 In SCS mode, causes pr3287 to pass FF (formfeed) orders through
101 to the printer as ASCII formfeed characters, rather than simu‐
102 lating them based on the values of the MPL (maximum presentation
103 line) and TM (top margin) parameters.
104 -keyfile filename
106 Specifies a file containing the private key for the certificate
107 file (specified via -certfile or -chainfile). The default file
108 type is PEM.
109 -keyfiletype type
111 Specifies the type of the private key file specified by -key‐
112 file. Type can be pem or asn1.
113 -keypasswd type:value
115 Specifies the password for the private key file, if it is
116 encrypted. The argument can be file:filename, specifying that
117 the password is in a file, or string:string, specifying the
118 password on the command-line directly.
119 -proxy type:host[:port]
122 Causes pr3287 to connect via the specified proxy, instead of
123 using a direct connection. The host can be an IP address or
124 hostname. The optional port can be a number or a service name.
125 For a list of supported proxy types, see PROXY below.
126 -reconnect
128 Causes pr3287 to reconnect to the host, whenever the connection
129 is broken. There is a 5-second delay between reconnect
130 attempts, to reduce network thrashing for down or misconfigured
131 hosts.
132 -selfsignedok
134 Allow self-signed host certificates.
135 -trace Turns on data stream tracing. Trace information is usually
137 saved in the file /tmp/x3trc.pid.
138 -tracedir dir
140 Specifies the directory to save trace files in, instead of /tmp.
141 -trnpre file
143 Specifies a file containing data that will be sent to the
144 printer before each print job. The file contents are treated as
145 transparent data, i.e., they are not translated in any way.
146 -trnpost file
148 Specifies a file containing data that will be sent to the
149 printer after each print job. The file contents are treated as
150 transparent data, i.e., they are not translated in any way.
151 -v Display build and version information and exit.
153 -verifycert
155 Verify the host certificate for tunneled SSL and negotiated
156 SSL/TLS connections.
157
159 SIGINT, SIGHUP and SIGTERM cause the current print job to be flushed
160 (any pending data to be printed) and pr3287 to exit.
161 SIGUSR1 causes the current print job to be flushed without otherwise
163 affecting the pr3287 process.
164
167 The -proxy option causes pr3287 to use a proxy server to connect to the
168 host. The syntax of the option is:
169 type:host[:port]
170 The supported values for type are:
172 Proxy Type Protocol Default Port
174 ──────────────────────────────────────────────
175 http RFC 2817 HTTP 3128
176 tunnel (squid)
177 passthru Sun in.telnet-gw none
178 socks4 SOCKS version 4 1080
179 socks5 SOCKS version 5 1080
180 (RFC 1928)
181 telnet No protocol (just none
182 send connect host
183 port)
184 The special types socks4a and socks5d can also be used to force the
186 proxy server to do the hostname resolution for the SOCKS protocol.
187
189 x3270(1), c3270(1), telnet(1), tn3270(1)
190 Data Stream Programmer's Reference, IBM GA23-0059
191 Character Set Reference, IBM GA27-3831
192 3174 Establishment Controller Functional Description, IBM GA23-0218
193 RFC 1576, TN3270 Current Practices
194 RFC 1646, TN3270 Extensions for LUname and Printer Selection
195 RFC 2355, TN3270 Enhancements
196
198 Copyright 1993-2013, Paul Mattes.
199 Copyright 1990, Jeff Sparkes.
200 Copyright 1989, Georgia Tech Research Corporation (GTRC), Atlanta, GA
201 30332.
202 All rights reserved.
203 Redistribution and use in source and binary forms, with or without
205 modification, are permitted provided that the following conditions are
206 met:
207 * Redistributions of source code must retain the above copyright
210 notice, this list of conditions and the following disclaimer.
211 * Redistributions in binary form must reproduce the above
213 copyright notice, this list of conditions and the following
214 disclaimer in the documentation and/or other materials provided
215 with the distribution.
216 * Neither the names of Paul Mattes, Jeff Sparkes, GTRC nor the
218 names of their contributors may be used to endorse or promote
219 products derived from this software without specific prior
220 written permission.
221 THIS SOFTWARE IS PROVIDED BY PAUL MATTES, JEFF SPARKES AND GTRC `AS IS'
223 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
224 THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
225 PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL PAUL MATTES, JEFF SPARKES OR
226 GTRC BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
227 EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
228 PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
229 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
230 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
231 NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
232 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
233
235 pr3287 3.3.12ga12
236 26 February 2013 PR3287(1)