prinit(1M) MISC. REFERENCE MANUAL PAGES prinit(1M)
NAME
prinit - compile a printer source file for
EXPRESS TN3270-C
SYNOPSIS
prinit [-s InputFile] [-o OutputFile]
DESCRIPTION
The prinit utility compiles a Printer Capabilities source
file to customize printer support for EXPRESS TN3270-C. When
invoked, prinit has default definitions for all definable
printer characters. The Printer Capabilities source file
redefines some or all of the default definitions.
If invalid conditions occur when the prinit utility is com-
piling the Printer Capabilities source file, error messages
are generated.
The compiled Printer Capabilities file can be used when
printing screens from a host session using tn3270c(1) or
from the tn3287 printer emulator using tn3287c(1).
OPTIONS
-s InputFile
specifies the name of the Printer Capabilities source
file. If -s InputFile is omitted, the environment vari-
able PRSRC is used to obtain the source file name. If
PRSRC is not defined, the default name is general.pi.
If the Printer Capabilities source file is not found in
the current directory, $COMMLINK/adm/natlang is
searched.
-o OutputFile
specifies the name of the compiled Printer Capabilities
file. If -o OutputFile is omitted, the environment
variable PRSRC is used to obtain the file name. If
PRSRC is not defined, the default name is
$COMMLINK/adm/natlang/prgenrl.pca. The pathname
$COMMLINK/adm/natlang is appended to the beginning of
the file name unless the name starts with "/" or "./".
The compiled Printer Capabilities file must be named
with the .pca suffix and be placed in the
$COMMLINK/adm/natlang directory to be available when
using tn3270c(1).
BUILDING THE PRINTER CAPABILITIES SOURCE FILE
Before creating the Printer Capabilites source file, deter-
mine which printer characters must be implemented. Typi-
cally, this involves the alphanumeric characters and one
National Language character set. Familiarize yourself with
the capabilities and requirements of the printer. Any ini-
tial and/or ending control sequences required by the printer
Last change: 4/13/95 1
prinit(1M) MISC. REFERENCE MANUAL PAGES prinit(1M)
must be identified.
The EXPRESS TN3270-C Administrator's Reference Guide con-
tains a list of the 3270 printer capabilities along with the
mnemonics used in Printer Capabilities source files and the
defaults used by prinit. Identify any default echo strings
used by prinit that are inappropriate. For instance, the
PR_CENT, PR_SOLID, and PR_NOT printer echo strings often
need to be modified. Designate correct echo strings for all
3270 printer characters that have invalid defaults. No echo
string should generate more than 1 character. The Printer
Capabilities source file may be written using either termcap
or terminfo syntax.
termcap SYNTAX
In standard termcap description files, capability descrip-
tions are separated by colons. All description lines except
the first must start with white space and a colon. All
description lines except the last must end with a colon,
backslash, and newline. The last description line must end
with a colon. Any line can be designated as a comment by
placing a number sign (#) in the first non-whitespace posi-
tion of the line. The syntax of a termcap-style Printer
Capabilities source file is as follows:
FileDescription:\
:PrintDescription:\
.
.
.
:PrintDescription:\
:PrintDescription:
FileDescription is a character string, used to identify the
file (for example, LaserPrinter).
PrintDescription is a print description, which has the fol-
lowing format:
Mnemonic=String
Mnemonic is one of the printer mnemonics listed in the
EXPRESS TN3270-C Administrator's Reference Guide.
String is one or more characters which will be the
echo/control string for the associated capability.
terminfo SYNTAX
In standard terminfo description files, capability descrip-
tions are separated by commas. Whitespace (including new-
lines) between a comma and the start of the next capability
description is ignored. Any line can be designated as a
Last change: 4/13/95 2
prinit(1M) MISC. REFERENCE MANUAL PAGES prinit(1M)
comment by placing a number sign (#) in the first non-
whitespace position of the line. The syntax of a terminfo-
style Printer Capabilities source file is as follows:
FileDescription,
PrintDescription,
.
.
.
PrintDescription,
PrintDescription
FileDescription and PrintDescription have the same meanings
as described above.
FILES
The following Printer Capabilities files are located in
$COMMLINK/adm/natlang:
hp.pi Hewlett Packard Laserjet printer capabilities
source file
general.pi Generic printer capabilities source file
usascii.pi Printer capabilities source file for standard
ASCII printers with dashes for unknown charac-
ters
A compiled version of each source file is also provided with
EXPRESS TN3270-C. The filenames for the compiled versions
end with "pca" rather than "pi".
SEE ALSO
stop3287(1), tn3270c(1), tn3287c(1), dcinit(1M), kminit(1M),
neinit(1M), tn3270c(4), tn3287c(4), EXPRESS TN3270-C
Adminstrator's Reference Guide
Last change: 4/13/95 3