dcinit(1M) MISC. REFERENCE MANUAL PAGES dcinit(1M)
NAME
dcinit - compile a Display Capabilities file
for EXPRESS TN3270-C
SYNOPSIS
dcinit [TerminalName] [-s InputFile] [-o OutputFile]
[-t TermType] [-b BaudRate] [-z] [-r [ReportFile] ]
[-rf ReportFormat]
DESCRIPTION
Use the dcinit utility to customize EXPRESS TN3270-C for the
display capabilities of your terminal. When invoked, dcinit
has no default definitions for screen capabilities other
than the echo strings. dcinit updates screen definitions
using the Display Capabilities source file. If the source
file lacks definitions for any standard screen capabilities,
dcinit may take the definitions from the standard UNIX
termcap or terminfo database. If no standard terminal data-
base exists on the system, the undefined screen capabilities
are configured as disabled.
OPTIONS
TerminalName
is a shorthand method for specifying several dcinit
parameters. TerminalName is position-dependent and
must be specified before any other parameters. Specify-
ing TerminalName is equivalent to specifying
TerminalName.dc as the dcinit input file,
TerminalName.d as the dcinit output file, and Terminal-
Name as the standard termcap or terminfo name for the
target terminal.
For example, specifying the command line:
dcinit vt100
is equivalent to specifying:
dcinit -s vt100.dc -o vt100.d -t vt100
Explicitly specifying a name with the -s, -o or -t
parameter will take precedence. For example, specify-
ing:
dcinit vt100 -o outfile
is equivalent to specifying:
dcinit -s vt100.dc -o outfile -t vt100
If the -r parameter (see below) is specified without an
associated report file name, the report file
TerminalName.rep is used as the default name. For the
two sample command lines shown above, if -r were speci-
fied without a report file name, the name vt100.rep
would be used. If TerminalName is not specified, the
value of the environment variable TERM is used to
create default names.
-s InputFile
specifies the name of the Display Capabilities source
Last change: 4/13/95 1
dcinit(1M) MISC. REFERENCE MANUAL PAGES dcinit(1M)
file. If omitted, TerminalName is used to determine the
file name (see above). If TerminalName is not speci-
fied, the environment variable DCI3279 is used to
obtain the name of the Display Capabilities source
file. If DCI3279 is not defined, the default file name
$TERM.dc is assumed. If the source file is not in the
current directory, the directory $COMMLINK/adm/3270 is
searched. If the file is not found, dcinit attempts to
create an output file based on the default values for
display capabilities and on the definition of the asso-
ciated termcap name (refer to the TerminalName, -t and
-z parameters). By default, national language charac-
ters have representations defined by the ISO8859-1
Latin-1 encodings. The default values for all other
display capabilities are listed in the EXPRESS TN3270-C
Administrator's Reference Guide.
-o OutputFile
specifies the name of the Display Capabilities file
compiled by dcinit. If -o OutputFile is omitted, Ter-
minalName is used to determine the file name (see
above). If TerminalName is also omitted, the environ-
ment variable DC3279 is used to obtain the file name
for the compiled Display Capabilities file. If DC3279
is also not defined, the default file name $TERM.d is
used, where $TERM is the value of the environment vari-
able TERM. The pathname $COMMLINK/adm/3270 is appended
to the beginning of the file name unless the name
starts with "/" or "./". The compiled Display Capabili-
ties file must be named with the .dc suffix and placed
in the $COMMLINK/adm/3270 directory to be available to
tn3270c(1).
-t TermType
specifies the standard termcap or terminfo name of the
terminal. If this parameter is omitted, TerminalName is
used (see above). If TerminalName is not specified, the
environment variable TERM is used to obtain the termcap
or terminfo terminal name. To customize a terminal
using only the dcinit input description file, specify a
terminal name which is not found in the system database
(for example, "-t abcdefgh").
-b BaudRate
specifies the baud rate for the terminal. If this
parameter is omitted, the Display Capabilities source
file is searched for the ospeed capability to determine
the baud rate. If the ospeed capability is not speci-
fied in the source file, the baud rate of stdin is used
(if stdin is a terminal device).
-z specifies that if the terminal name (specified with the
Last change: 4/13/95 2
dcinit(1M) MISC. REFERENCE MANUAL PAGES dcinit(1M)
-t parameter, TerminalName parameter, or $TERM) is not
found in the system's terminal data base
(termcap/terminfo), dcinit must immediately abort exe-
cution. If this option is not specified and the termi-
nal name is not found in the system's terminal data-
base, dcinit continues execution and uses the value of
TERM for TerminalName.
-r ReportFile
directs the dcinit utility to create a report of the
display capabilities being defined. If no report file
is specified, a default name is determined based on the
presence of the TerminalName parameter (see above). The
format of the report file depends on the setting of the
-rf parameter. The dcinit report file is similar to the
Display Capabilities source file, except that any com-
ments are stripped out and only one capability is
listed per line. All capabilities are explicitly speci-
fied, including booleans that default to OFF, numerics
that default to 0, strings that default to "nothing",
and echo strings that have default values. A report
file from dcinit can be used as a Display Capabilities
source file.
-rf ReportFormat
specifies the format of the dcinit utility report.
ReportFormat "tc" produces a report in termcap format.
Any other value for ReportFormat produces a report in
terminfo format (the default).
BUILDING THE DISPLAY CAPABILITIES SOURCE FILE
Most terminals fall into one of two broad categories: ASCII
or ANSI. ASCII terminals use the cursor-addressing sequence
\E=lc, where l is a character which encodes the line number,
and c represents the column number. ANSI terminals use the
cursor-addressing sequence \E[l;cH, where l and c are
numbers. Most ASCII terminals will work acceptably with the
supplied customization files cP.dc or cPdim.dc. Most ANSI
terminals will work with vt100.dc (the system database for
vt100 is also required).
It is not necessary to build a Display Capabilities source
file unless you need to display certain special characters
(such as national language characters, the field-mark, or
DUP characters) and/or exploit special features of the ter-
minal. Common examples of such special features include:
o Ability to display color
o Ability to display extended highlighting
o Ability to change display size
Last change: 4/13/95 3
dcinit(1M) MISC. REFERENCE MANUAL PAGES dcinit(1M)
o Presence of a hardware status line
o Implementation of automatic margins
o Ability to remotely set key click or cursor attributes
If it is necessary to create a Display Capabilities source
file, find an existing customization file that includes
display capability definitions similar to your needs. Then
perform the following steps to build the Display Capabili-
ties source file:
1. Identify the screen capabilities which must be imple-
mented. The EXPRESS TN3270-C Administrator's Reference
Guide contains a list of the functions which may be
defined.
2. Identify the dcinit utility defaults, if any, which are
not appropriate for the terminal.
3. Make a copy of the existing Display Capabilities source
file that includes definitions similar to your needs.
Use this copy as a starting point for the new Display
Capabilities source file.
4. Redefine echo strings for all inappropriate character
defaults (for example, DC_CENT).
5. For logical display features on the target terminal,
define the following standard termcap capabilities:
Termcap Name, Terminfo Name, Description, cm, cup, cur-
sor motion (see also tccm and ticup), cl, clear, clear
screen, co, cols, number of display columns, li, lines,
number of display lines.
6. Once any new definitions are made, ensure that there
are no conflicts with the default definitions (for
example, identical echo strings for two display charac-
ters).
Display Capabilities source files can use either
termcap or terminfo syntax. Capability names may be
specified in the Display Capabilities source file using
termcap names and/or terminfo names regardless of
whether your system uses termcap or terminfo. If pad-
ding is required, you may specify it using either
termcap (marked by the presence of digits at the start
of a string capability) or terminfo style (marked by
digits at the end of the capability string, in the form
$digits). Both termcap and termminfo syntax are
described below.
Last change: 4/13/95 4
dcinit(1M) MISC. REFERENCE MANUAL PAGES dcinit(1M)
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 Display
Capabilities source file is as follows:
FileDescription:\
:DisplayDescription:\
.
.
.
:DisplayDescription:\
:DisplayDescription:
FileDescription is a character string, used to identify the
file (for example, vt100).
DisplayDescription is an display association description,
which has the following format:
Mnemonic=String
Mnemonic is a display mnemonic. A complete list is provided
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 com-
ment by placing a number sign (#) in the first non-
whitespace position of the line. The syntax of a terminfo-
style Display Capabilities source file is as follows:
FileDescription,
DisplayDescription,
.
.
.
DisplayDescription,
DisplayDescription
FileDescription and DisplayDescription have the same mean-
ings as described above.
Last change: 4/13/95 5
dcinit(1M) MISC. REFERENCE MANUAL PAGES dcinit(1M)
The Display Capabilities source files provided with EXPRESS
TN3270-C work on systems that use termcap or terminfo.
FILES
The following Display Capabilities source files are located
in $COMMLINK/adm/3270:
4105.dc AT&T 4105 color terminal
a5.dc Altos V running terminal emulation program
a7.dc Altos VII running terminal emulation program
adm3a.dc adm3a terminal
aixterm.dc Used for windows running under AIX's motif
window manager for X
ansi.dc A general description for a terminal using
ANSI control sequences. It should be modified
for a particular ANSI terminal.
AT386.dc AT terminals
cP.dc Televideo models using "space-dependent"
attributes (an attribute change affects data
already in the display). Use as is or with
minor modifications.
cPdim.dc Televideo models using "time-dependent" attri-
butes (an attribute change does not affect
data already in the display).Use as is or with
minor modifications.
cPextat.dc Televideo models where an attribute change
sends a harmless control string to the screen,
instead of changing the attribute. Used mostly
for internal debugging.
d230c.dc Data General Dasher D230c color terminals
d410-7b.dc Data General D410 terminal operating in 7-bit
ASCII mode. This file is based on the terminfo
entry provided with DG/UX 5.4.
d410-dg.dc Data General D410 terminal operating in native
mode (8-bit ASCII)
hds3ans.dc Honeywell HDS3 in ANSI mode
hft.dc hft terminal display
Last change: 4/13/95 6
dcinit(1M) MISC. REFERENCE MANUAL PAGES dcinit(1M)
hp2622x.dc Used for a window generated by Hewlett Packard
X Window. This window emulates an HP2622 ASCII
terminal. To customize 3270 for an HP2622 phy-
sical terminal, the file ansi.dc should be
modified for use with the terminal in ANSI
mode, since the display capabilities in ASCII
mode are limited.
hp300h.dc HP9000 Series 300 System console
ibm.dc IBM PC
ibm3151.dc IBM 3151 terminals
ibm5151.dc IBM 5151 terminals
ibm8514.dc IBM 8514 console display
lnk220.dc LINK MC5/Wyse 99-GT terminals in VT 220-8 emu-
lation mode
prolg.dc Bull Questar 705 in Prolog mode
scocon.dc SCO XENIX and UNIX system console
sun-cmd.dc Sun Open Windows environment command tool win-
dow
tm228.dc IBM MOTOROLA tm228 terminals
tm229.dc IBM MOTOROLA tm229 terminals
tm3179.dc MOTOROLA tm3179 terminal
vt100.dc Digital vt100 terminal
wy50.dc Wyse 50 terminal
wy60.dc Wyse 60 terminal
wy120.dc Wyse 120 terminal
xterm.dc Used for X Window System xterm vt102 terminal
emulator
xterm24dg.dc AViiON Systems "xterm" window under DG/UX X
Window System
xtermc.dc xterm color terminal
A compiled version of each source file is also provided with
EXPRESS TN3270-C. The filenames for the compiled versions
Last change: 4/13/95 7
dcinit(1M) MISC. REFERENCE MANUAL PAGES dcinit(1M)
end with "d" rather than "dc".
SEE ALSO
tn3270c(1), kminit(1M), neinit(1M), prinit(1M), tn3270c(4),
EXPRESS TN3270-C Administrator's Reference Guide
Last change: 4/13/95 8