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 -charset name
40 Specifies an alternate host code page (input EBCDIC mapping).
41 The default maps the U.S. English (037) code page to the current
42 locale character encoding. pr3287 generally supports the same
43 host character sets as x3270.
44 -command command
46 Specifies the command to run for each print job. The default is
47 lpr.
48 -crlf Causes newline characters in the output to be expanded to car‐
50 riage-return/linefeed sequences.
51 -daemon
53 Causes pr3287 to become a daemon (background) process.
54 -eojtimeout seconds
56 Causes pr3287 to flush the print job after seconds seconds of
57 inactivity.
58 -ignoreeoj
60 Ignore TN3270E PRINT-EOJ commands, relying on UNBIND commands to
61 indicate the ends of print jobs.
62 -ffskip
64 Causes pr3287 to ignore a FF (formfeed) order if it occurs at
65 the top of a page.
66 -ffthru
68 In SCS mode, causes pr3287 to pass FF (formfeed) orders through
69 to the printer as ASCII formfeed characters, rather than simu‐
70 lating them based on the values of the MPL (maximum presentation
71 line) and TM (top margin) parameters.
72 The printer can be the name of a local printer, or a UNC path to a
75 remote printer, e.g., <b>\serverrinter1</b>.
76 -proxy type:host[:port]
78 Causes pr3287 to connect via the specified proxy, instead of
79 using a direct connection. The host can be an IP address or
80 hostname. The optional port can be a number or a service name.
81 For a list of supported proxy types, see PROXY below.
82 -reconnect
84 Causes pr3287 to reconnect to the host, whenever the connection
85 is broken. There is a 5-second delay between reconnect
86 attempts, to reduce network thrashing for down or misconfigured
87 hosts.
88 -trace Turns on data stream tracing. Trace information is usually
90 saved in the file /tmp/x3trc.pid.
91 -tracedir dir
93 Specifies the directory to save trace files in, instead of /tmp.
94 -trnpre file
96 Specifies a file containing data that will be sent to the
97 printer before each print job. The file contents are treated as
98 transparent data, i.e., they are not translated in any way.
99 -trnpost file
101 Specifies a file containing data that will be sent to the
102 printer after each print job. The file contents are treated as
103 transparent data, i.e., they are not translated in any way.
104 -v Display build and version information and exit.
106
108 SIGINT, SIGHUP and SIGTERM cause the current print job to be flushed
109 (any pending data to be printed) and pr3287 to exit.
110 SIGUSR1 causes the current print job to be flushed without otherwise
112 affecting the pr3287 process.
113
116 The -proxy option causes pr3287 to use a proxy server to connect to the
117 host. The syntax of the option is:
118 type:host[:port]
119 The supported values for type are:
121 Proxy Type Protocol Default Port
123 ──────────────────────────────────────────────
124 http RFC 2817 HTTP 3128
125 tunnel (squid)
126 passthru Sun in.telnet-gw none
127 socks4 SOCKS version 4 1080
128 socks5 SOCKS version 5 1080
129 (RFC 1928)
130 telnet No protocol (just none
134 send connect host
135 port)
136 The special types socks4a and socks5d can also be used to force the
138 proxy server to do the hostname resolution for the SOCKS protocol.
139
141 x3270(1), c3270(1), telnet(1), tn3270(1)
142 Data Stream Programmer's Reference, IBM GA23-0059
143 Character Set Reference, IBM GA27-3831
144 3174 Establishment Controller Functional Description, IBM GA23-0218
145 RFC 1576, TN3270 Current Practices
146 RFC 1646, TN3270 Extensions for LUname and Printer Selection
147 RFC 2355, TN3270 Enhancements
148
150 Copyright 1993-2009, Paul Mattes.
151 Copyright 1990, Jeff Sparkes.
152 Copyright 1989, Georgia Tech Research Corporation (GTRC), Atlanta, GA
153 30332.
154 All rights reserved.
155 Redistribution and use in source and binary forms, with or without
157 modification, are permitted provided that the following conditions are
158 met:
159 * Redistributions of source code must retain the above copyright
162 notice, this list of conditions and the following disclaimer.
163 * Redistributions in binary form must reproduce the above
165 copyright notice, this list of conditions and the following
166 disclaimer in the documentation and/or other materials provided
167 with the distribution.
168 * Neither the names of Paul Mattes, Jeff Sparkes, GTRC nor the
170 names of their contributors may be used to endorse or promote
171 products derived from this software without specific prior
172 written permission.
173 THIS SOFTWARE IS PROVIDED BY PAUL MATTES, JEFF SPARKES AND GTRC `AS IS'
175 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
176 THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
177 PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL PAUL MATTES, JEFF SPARKES OR
178 GTRC BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
179 EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
180 PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
181 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
182 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
183 NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
184 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
185
187 pr3287 3.3.10ga4
188 02 October 2009 PR3287(1)