tn3287c(4) DEVICES AND NETWORK INTERFACES tn3287c(4)
NAME
tn3287c - tn3287 printer emulator configuration file
for EXPRESS TN3270-C
SYNOPSIS
PeName.pc - tn3287 printer emulator configuration filename
DESCRIPTION
The configuration file provides a convenient method for con-
figuring tn3287 printer emulator. The file establishes
characteristics for the printer emulation environment. The
configuration file is not required; if the file does not
exist, tn3287c(1) uses internal program defaults and command
line options to determine the configuration for the printer
emulator.
The tn3287 printer emulator configuration file is an ASCII
file that can be created and edited with a standard UNIX
editor such as vi or emacs. When you create a tn3287 printer
emulator configuration file, use a standard UNIX file name
in the form PeName.pc. PeName is the configuration name that
is used when invoking tn3287c(1). When tn3287c is started,
it searches directories for the configuration file in the
following order:
1. Your working directory
2. $HOME/Express/tn3270c
3. $COMMLINK/$LOGNAME
4. $COMMLINK
The tn3287 printer emulator configuration file should be
placed in the appropriate directory location based on who
will use and maintain the file.
The 3287 printer emulator configuration file contains state-
ments introduced by configuration keywords with the follow-
ing syntax:
keyword value;
Comments are entered in the configuration file using the
number sign character (#). Statements must end with the
semicolon (;).
The keywords and syntax for configuration statements are
defined below. Keywords are not case sensitive and can be
entered in any order. If a keyword statement is not included
or a keyword is entered without a parameter value,
tn3287c(1) uses the default value. For more information on
Last change: 4/13/95 1
tn3287c(4) DEVICES AND NETWORK INTERFACES tn3287c(4)
the configuration file, see the EXPRESS TN3270-C User's
Guide.
KEYWORDS USED IN THE TN3287 PRINTER
CONFIGURATION FILE
IPHostName Name;
Specifies the TCP/IP host address or name (from
the /etc/hosts file) where the tn3270 server
resides. There is no default.
IPServiceName Name;
Specifies the TCP/IP service name or port number
for the tn3270 service. If Name is all numeric,
tn3287c(1) assumes a port address. The default is
tn3270. If tn3270 is not defined, the default is
telnet.
DeviceName Name;
Specifies the name of the device, a specific logi-
cal unit (LU) or LU pool, to which you wish to
connect. Name is a string whose length is entirely
determined by your specific tn server. There is no
default.
3270Name Name;
3270Name is similiar to DeviceName, but while Dev-
iceName specifies an LU or LU pool for connection,
3270Name indirectly determines the LU or LU pool
used for connection. 3270Name specifies the name
of the LU or LU pool that was assigned previously
to a 3270 terminal session and causes tn3287c(1)
to issue a tn3270E ASSOCIATE command. Unlike the
CONNECT command caused by DeviceName, the ASSOCI-
ATE command requests that the tn server assign the
LU or LU pool for the printer device that is
paired with the 3270 terminal session to the
tn3287 printer emulator session. 3270Name indi-
cates the name of the LU or LU pool for 3270 ter-
minal session in the terminal and printer device
pair. Name is a string whose length is entirely
determined by your specific tn server. There is
no default.
NationalLanguageFile Filename;
Specifies the name of the file that defines the
National Language used by the tn3287 printer emu-
lator. If the file cannot be found, the directory
$COMMLINK/adm/natlang is inserted at the beginning
of the Filename. National language files for
IBM-defined national languages are provided with
Last change: 4/13/95 2
tn3287c(4) DEVICES AND NETWORK INTERFACES tn3287c(4)
EXPRESS TN3270-C and are located in
$COMMLINK/adm/natlang using filenames that start
with NLO. The default value is NLO.US.
PrintMode n;
Determines the initial mode of operation for local
printing. Two values are permitted:
1 - Print to a UNIX file
2 - Print to a UNIX command. The command is
treated as a filter process. This is commonly
used to send the print stream to a print spooler.
The default is 1.
PrintDestination Dest;
Specifies the initial destination for local print
requests and is required if PrintMode is speci-
fied.
If the PrintMode is 1, enter the full path and
file name.
If the PrintMode is 2, enter a UNIX command. If
the command includes blank spaces, use quotation
marks around the command.
The default destination is to a file named
Printer.ProcessID, where ProcessID is the actual
process ID of the tn3287 printer emulator.
PrinterFile Filename;
Specifies the name of the file that defines the
printer capabilities for local printing for host
sessions, local sessions, and the Session Manager.
When no file is specified, a device initialization
string is not used and all universal ASCII charac-
ters are sent as is to the print destination. If
the file cannot be found, the directory
$COMMLINK/adm/natlang is inserted at the beginning
of the Filename. Printer capability files for com-
mon printer types are provided with EXPRESS
TN3270-C and are located in $COMMLINK/adm/natlang
using filenames that end in .pca. There is no
default value.
NoTranslate enable|disable;
Specifies whether transparent data sent to an SNA
character string (SCS) printer is translated into
universal ASCII. If NoTranslate is enabled, tran-
sparent data is printed exactly as sent from the
host. Do not enable NoTranslate if PrintMode is 1
(print to UNIX file). The default is disable.
PrintFormatting enable|disable;
Determines whether the final step of print
Last change: 4/13/95 3
tn3287c(4) DEVICES AND NETWORK INTERFACES tn3287c(4)
formatting is performed. Disabling PrintFormatting
allows operation with special print data streams
that require nonstandard formatting. When dis-
abled, tn3287c(1) sends the data stream directly
to the print destination. The default is enable.
FILES
$COMMLINK/adm/3270/tn3287-c.pc Sample tn3287 printer emula-
tor configuration file
SEE ALSO
tn3287c(1), EXPRESS TN3270-C User's Guide
Last change: 4/13/95 4