1PR3287(1) General Commands Manual PR3287(1)
2
3
4
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
17 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
21 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
25 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
31 -assoc LUname
32 Causes the session to be associated with the specified LUname.
33
34 -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
39 -charset name
40 Specifies an alternate EBCDIC-to-ASCII mapping. The default
41 maps the EBCDIC U.S. English character set to ISO 8859-1. Other
42 built-in character sets are bracket, which corresponds to many
43 older IBM hosts' mapping of the [ and ] characters, and the non-
44 U.S. character sets german, finnish, uk, norwegian, french, ice‐
45 landic and belgian. These correspond to the x3270 character
46 sets of the same names.
47
48 If name begins with an @, then the balance is intepreted as the
49 name of a file containing character mappings. The file contains
50 whitespace-separated tokens. Each token is a number specifying
51 an EBCDIC code, an = character, and a number specifying the
52 8-bit ASCII character used to print that code. Blank lines and
53 lines beginning with # are ignored.
54
55 If name begins with an =, then the balance is intepreted as a
56 string containing mapping tokens, as in a file.
57
58 For example, a file defining the uk character set would look
59 like this:
60
61 # UK character set
62 0x4a=0x24 0x5b=0xa3 0xa1=0xaf
63 0xb0=0xa2 0xb1=0x5b 0xba=0x5e
64 0xbc=0x7e
65
66 -command command
67 Specifies the command to run for each print job. The default is
68 lpr.
69
70 -crlf Causes newline characters in the output to be expanded to car‐
71 riage-return/linefeed sequences.
72
73 -daemon
74 Causes pr3287 to become a daemon (background) process.
75
76 -eojtimeout seconds
77 Causes pr3287 to flush the print job after seconds seconds of
78 inactivity.
79
80 -ignoreeoj
81 Ignore TN3270E PRINT-EOJ commands, relying on UNBIND commands to
82 indicate the ends of print jobs.
83
84 -ffskip
85 Causes pr3287 to ignore a FF (formfeed) order if it occurs at
86 the top of a page.
87
88 -ffthru
89 In SCS mode, causes pr3287 to pass FF (formfeed) orders through
90 to the printer as ASCII formfeed characters, rather than simu‐
91 lating them based on the values of the MPL (maximum presentation
92 line) and TM (top margin) parameters.
93
94 -reconnect
95 Causes pr3287 to reconnect to the host, whenever the connection
96 is broken. There is a 5-second delay between reconnect
97 attempts, to reduce network thrashing for down or misconfigured
98 hosts.
99
100 -trace Turns on data stream tracing. Trace information is usually
101 saved in the file /tmp/x3trc.pid.
102
103 -tracedir dir
104 Specifies the directory to save trace files in, instead of /tmp.
105
107 SIGINT, SIGHUP and SIGTERM cause the current print job to be flushed
108 (any pending data to be printed) and pr3287 to exit.
109
110 SIGUSR1 causes the current print job to be flushed without otherwise
111 affecting the pr3287 process.
112
114 x3270(1), telnet(1), tn3270(1)
115 Data Stream Programmer's Reference, IBM GA23-0059
116 Character Set Reference, IBM GA27-3831
117 3174 Establishment Controller Functional Description, IBM GA23-0218
118 RFC 1576, TN3270 Current Practices
119 RFC 1646, TN3270 Extensions for LUname and Printer Selection
120 RFC 2355, TN3270 Enhancements
121
123 Modifications Copyright 1993-1996, 1997, 1999-2003 by Paul Mattes.
124 Original X11 Port Copyright 1990 by Jeff Sparkes.
125 Permission to use, copy, modify, and distribute this software
126 and its documentation for any purpose and without fee is hereby
127 granted, provided that the above copyright notice appear in all
128 copies and that both that copyright notice and this permission
129 notice appear in supporting documentation.
130 Copyright 1989 by Georgia Tech Research Corporation, Atlanta, GA 30332.
131 All Rights Reserved. GTRC hereby grants public use of this
132 software. Derivative works based on this software must incorpo‐
133 rate this copyright notice.
134
136 pr3287 3.3.3beta3
137
138
139
140 04 April 2005 PR3287(1)