pr3287 Manual Page
Contents
Name
Synopsis
Description
Options
Signals
Proxy
See Also
Copyrights
Version
Name
pr3287 -
IBM
host printing tool
Synopsis
pr3287
[ options ]
[ L: ] [[ LUname [, LUname ...]@] hostname [: port ]]
Description
pr3287
opens a telnet connection to an
IBM
host, and emulates an IBM 3287 printer.
It implements RFCs 2355 (TN3270E), 1576 (TN3270) and 1646 (LU name selection).
If the hostname is prefixed with L:, the connection will be made
through an SSL tunnel.
pr3287 also supports TELNET START-TLS option negotiation without any
need for command-line options.
A specific LU name to use may be specified by prepending it to the
hostname
with an
`@'.
Multiple LU names to try can be separated by commas.
An empty LU can be placed in the list with an extra comma.
The port to connect to defaults to
telnet.
This can be overridden by appending a
port
to the
hostname
with a colon
`:'.
Options
pr3287
understands the following options:
- -assoc LUname
-
Causes the session to be associated with the specified
LUname.
- -blanklines
-
In LU3 formatted mode, print blank lines even if they are all NULLs or control
characters.
(This is a violation of the 3270 printer protocol, but some hosts require it.)
- -charset name
-
Specifies an alternate EBCDIC-to-ASCII mapping.
The default maps the EBCDIC U.S. English character set to ISO 8859-1.
Other built-in character sets are bracket, which corresponds to
many older IBM hosts' mapping of the [ and ] characters,
and the non-U.S. character sets german, finnish, uk,
norwegian, french, icelandic and belgian.
These correspond to the x3270 character sets of the same names.
If name begins with an @, then the balance is intepreted as
the name of a file containing character mappings.
The file contains whitespace-separated tokens.
Each token is a number specifying an EBCDIC code, an = character,
and a number specifying the 8-bit ASCII character used to print that code.
Blank lines and lines beginning with # are ignored.
If name begins with an =, then the balance is intepreted as
a string containing mapping tokens, as in a file.
For example, a file defining the uk character set would look like
this:
# UK character set
0x4a=0x24 0x5b=0xa3 0xa1=0xaf
0xb0=0xa2 0xb1=0x5b 0xba=0x5e
0xbc=0x7e
- -command command
-
Specifies the command to run for each print job.
The default is lpr.
- -crlf
-
Causes newline characters in the output to be expanded to
carriage-return/linefeed sequences.
- -daemon
-
Causes
pr3287
to become a daemon (background) process.
- -eojtimeout seconds
-
Causes pr3287 to flush the print job after seconds seconds
of inactivity.
- -ignoreeoj
-
Ignore TN3270E PRINT-EOJ commands, relying on UNBIND commands to indicate
the ends of print jobs.
- -ffskip
-
Causes pr3287 to ignore a FF (formfeed) order if it occurs
at the top of a page.
- -ffthru
-
In SCS mode, causes pr3287 to pass FF (formfeed) orders through to the
printer as ASCII formfeed characters, rather than simulating them based on the
values of the MPL (maximum presentation line) and TM (top margin) parameters.
The printer can be the name of a local printer, or a UNC path to a remote
printer, e.g., \\server\printer1.
- -proxy type:host[:port]
-
Causes pr3287 to connect via the specified proxy, instead of
using a direct connection.
The host can be an IP address or hostname.
The optional port can be a number or a service name.
For a list of supported proxy types, see PROXY
below.
- -reconnect
-
Causes pr3287 to reconnect to the host, whenever the connection is
broken.
There is a 5-second delay between reconnect attempts, to reduce network
thrashing for down or misconfigured hosts.
- -trace
-
Turns on data stream tracing.
Trace information is usually saved in the file
/tmp/x3trc.pid.
- -tracedir dir
-
Specifies the directory to save trace files in, instead of /tmp.
Signals
SIGINT, SIGHUP and SIGTERM cause the current print job to be flushed (any
pending data to be printed) and pr3287 to exit.
SIGUSR1 causes the current print job to be flushed without otherwise
affecting the pr3287 process.
Proxy
The -proxy option
causes pr3287 to use a proxy server to connect to the host.
The syntax of the option is:
type:host[:port]
The supported values for type are:
Proxy Type | Protocol | Default Port |
http | RFC 2817 HTTP tunnel (squid) | 3128 |
passthru | Sun in.telnet-gw | none |
socks4 | SOCKS version 4 | 1080 |
socks5 | SOCKS version 5 (RFC 1928) | 1080 |
telnet | No protocol (just send connect host port) | none |
The special types socks4a and socks5d can also be used to force
the proxy server to do the hostname resolution for the SOCKS protocol.
See Also
x3270(1), c3270(1), telnet(1), tn3270(1)
Data Stream Programmer's Reference, IBM GA23-0059
Character Set Reference, IBM GA27-3831
3174 Establishment Controller Functional Description, IBM GA23-0218
RFC 1576, TN3270 Current Practices
RFC 1646, TN3270 Extensions for LUname and Printer Selection
RFC 2355, TN3270 Enhancements
Copyrights
Modifications Copyright © 1993-1996, 1997, 1999-2005, 2007 by Paul Mattes.
Original X11 Port Copyright © 1990 by Jeff Sparkes.
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in
supporting documentation.
Copyright © 1989 by Georgia Tech Research Corporation, Atlanta, GA 30332.
All Rights Reserved. GTRC hereby grants public use of this software.
Derivative works based on this software must incorporate this copyright
notice.
Version
pr3287 3.3.7
This HTML document and the accompanying troff document were generated with
a set of write-only m4 macros and the powerful vi editor.
Last modified 24 December 2007.