DDI(5,F) AIX Technical Reference DDI(5,F)
-------------------------------------------------------------------------------
ddi
PURPOSE
Contains device-dependent information (ddi).
DESCRIPTION
A ddi file contains information for customizing classes (or types) of devices
supported by the system. The information in this file may be modified using
the devices command or an editor program. The ddi files are attribute files
that are located in the /etc/ddi directory. See "attributes" for the format of
attribute files.
The equivalent of a ddi file can be created and added to the system. Customize
helper programs convert the parameters in the files into a format required by
the operating system device drivers. A ddi file contains the following
information:
o Device-dependent information. This is a series of keywords whose values
the user supplies when the device is defined.
o Instructions to the customize helper program for processing input
parameters.
o Mapping information for the ddi structure.
o Bit field mapping information.
Devices that can be added, deleted, or changed by devices must have a ddi file.
Note: In the multibyte environment, the ddi file can contain only ASCII
characters.
Keywords
The following keywords are used in the stanzas of device-dependent information
files. These keywords describe attributes and settings for a particular device
that may be changed to suit your device.
MISCELLANEOUS KEYWORDS
Processed November 7, 1990 DDI(5,F) 1
DDI(5,F) AIX Technical Reference DDI(5,F)
Key Possible
Word Description Choices
sysadd Specifies the action that the a, o, none
devices command takes after
adding the device. The valid
choices are:
a Rebuilds the kernel and
IPLs the system
o Runs the osconfig
command
none Takes no special action.
sysdel Specifies the action that the a, o, none
devices takes after deleting
the device. The valid choices
are:
a Rebuilds the kernel and
IPLs the system
o Runs the osconfig
command
none Takes no special action.
PRINTERS AND PLOTTERS: Keywords followed by an asterisk (*) can be changed
only when adding or changing information about a non-IBM printer.
Key Possible
Word Description Choices
aa Automatic Answering: Does the
printer support communication
auto answering?
alf Automatic Line Feed: Does the
printer have automatic line
feed with carriage return.
ars* Aspect Ratio Support: Does yes, no
the printer have a "Set Aspect
Ratio" control?
backs* Backspace Support: Does the yes, no
printer have the ability to
backspace (move print head
backward while printing a
line)?
Processed November 7, 1990 DDI(5,F) 2
DDI(5,F) AIX Technical Reference DDI(5,F)
Key Possible
Word Description Choices
bigs Bit-Image Graphics Support: yes, no
Does the printer have bit
image graphics controls?
bm Bottom Margin (last line): 1 - [length(in.) x lines/in.]
Refers to last line of text at
bottom of a page; for
instance, to leave a one-inch
bottom margin on a page 66
lines long, you might set the
margin on line 60. The value
is determined by multiplying
the length of the page in
inches by the number of lines
per inch.
caps Map Lowercase Alphanumerics: yes, no
Maps lowercase alphanumerics
to uppercase.
cdp Condensed Print: Should a yes, no
file be printed with condensed
print?
cdpg Code Page: Specifies the code 437 (PC), 850 (MLP)
page loaded into the printer.
colp* Color Printer: Is the printer yes, no
capable of printing in color?
cps* Condensed Print Support: Does yes, no
the printer support printing
in condensed characters?
cr Color Ribbon: Is the printer yes, no
capable of using a color
ribbon?
cs Character Set: Refers to the 1, 2
specific character set to be
used for printing.
cus* Continuous Underscore Support: yes, no
Is the printer capable of
underscoring characters?
Processed November 7, 1990 DDI(5,F) 3
DDI(5,F) AIX Technical Reference DDI(5,F)
Key Possible
Word Description Choices
dpc Default Print Color: Refers black, blue, red, yellow
to the color to use for
printing when a file doesn't
contain codes that specify a
color: usually black, blue,
red, or yellow.
dsp Double Strike Print: Should yes, no
double-strike be turned on?
dsps* Double Strike Print Support: yes, no
Does the printer have a
control to double-strike
characters and provide
boldface?
dwp Double Width Print: Should a yes, no
file be printed with a
double-width character set?
dwps* Double Width Print Support: yes, no
Does the printer have the
ability to print with a
double-width character set?
ep Emphasized Print: Should yes, no
emphasized print be turned on?
Every character is overstruck
with a second pass of the
print head.
eps* Emphasized Print Support: yes, no
Does the printer have a
control to do emphasized
print?
fid Font ID: ID of the font used 11
by the printer.
fl Form (page) Length: Refers to 1 - [length (in.) x lines/in.]
the length of the paper in
terms of the number of lines
per page. The value is
determined by multiplying the
length of paper (in inches) by
the number of lines printed
per inch.
Processed November 7, 1990 DDI(5,F) 4
DDI(5,F) AIX Technical Reference DDI(5,F)
Key Possible
Word Description Choices
fw Form Width (right margin): 1 - [width(in.) x pitch]
Refers to the width of paper
in terms of the number of
characters per line. The
value is determined by
multiplying the width of the
paper (in inches) by the
number of characters printed
per inch).
hsi* Horizontal Spacing Increment: 60, 70
What horizontal increment is
used in the ESC K control?
hts* Horizontal Tab Support: Does yes, no
the printer have horizontal
tab controls?
htvi Text Vertical Increment: The 72
vertical index increment used
by subsequent CUU (ESC A)
multibyte controls. (See
"Multi-Byte Controls.")
ip Initialize Printer: Refers to true, false
the initial state of the
printer after power is
applied.
js* Justification Support: Does yes, no
the printer support an even
right margin?
kpoe Keep Printing on Error: yes, no
Should the printer complete
the print job despite errors
(without sending an error
message to the user)?
lm Left Margin: Refers to the 0 - [width(in.) x pitch]
area on a page between the
left edge and the leftmost
character position on the
page.
Processed November 7, 1990 DDI(5,F) 5
DDI(5,F) AIX Technical Reference DDI(5,F)
Key Possible
Word Description Choices
lpi Lines Per Inch: Refers to the 6, 8
number of print lines per
inch, to line spacing density,
and to the distance paper
moves during a line feed.
lrmc* Left/Right Margin Controls: yes, no
Does the printer have the
ability to change left and
right margins (does it have
left and right margin control
codes)?
mccs* Multibyte Control Code yes, no
Support: Does the printer
support IBM/OEM multibyte
controls? Or does the printer
act like an Epson (5152)?
nocr No Carriage Returns: yes, no
Substitute line feeds for
carriage returns.
noff No Form Feed: Simulate the yes, no
form feed function.
pacs* Print All Characters Support: yes, no
Does the printer support ESC
and ESC- controls?
ph Paper Handling: Refers to the 0=manual; 1=automatic; 2=continuous
ways the printer handles (continuous form paper)
different types of paper. The
manual-feed printer stops at
the end of each page and waits
for the user to insert another
sheet and press the start
button. A printer with an
automatic sheet-feed mechanism
feeds paper to the printer.
pitch Character Pitch: Refers to 10, 12, 15
the number of characters per
linear inch; for instance,
10-pitch type has 10
characters per inch.
Processed November 7, 1990 DDI(5,F) 6
DDI(5,F) AIX Technical Reference DDI(5,F)
Key Possible
Word Description Choices
plot Pass Data Directly to Device yes, no
Without Modification:
Overrides NOFF, NONL, NOTAB,
NOBS, CAPS, and WRAP.
pq Print Quality: May select (on dp, text, letter
some printers) degrees of
print quality: dp (for fast,
low quality), text (for better
draft quality), letter (for
high-quality final text).
prin Printer Type: 0,1,2,3,4,5,6,7,8
0 = 5152
1 = 5182
2 = 3812
3 = 3852
4 = 5201
5 = 4201
6 = 4202
7 = 3852
8 = 5202
psd Paper Source Drawer: Refers 1=top; 2=bottom
to the location of the paper
drawer from which paper is
drawn for printing.
pss* Proportional Spacing Support: yes, no
Does the printer support
proportionally spaced
printing?
ptime Printer Timeout: Specifies 0-32768
the printer timeout. Value is
in seconds.
Processed November 7, 1990 DDI(5,F) 7
DDI(5,F) AIX Technical Reference DDI(5,F)
Key Possible
Word Description Choices
rlfs* Reverse Line Feed Support: yes, no
Does the printer support the
ESC J control?
slap Skip Lines at Perforation: 0-[length(in.) x lines/in.]
Refers to the number of lines
skipped at page breaks. The
number is divided by 2, so
that half the blank lines
appear at the bottom of one
page and half at the top of
the next.
sp Select Printer. true, false
sss* Superscript/Subscript Support: yes, no
Does the printer have the
ability to print in
superscript and subscript
mode?
tbc Transmit Buffer Control: 0x00 - 0x10
Number of bytes to buffer for
transmitter.
tm Top Margin: Refers to the 0 - [length(in.) x lines/in.]
number of lines to be skipped
at the top of a page before
printing begins. If the user
specifies 6 lines, the first
print line will be line 7.
The value is determined by the
length of paper (in inches)
multiplied by the number of
lines per inch.
urpim User to Receive Printer Any user ID, pjo=Print Job Owner
Intervention Messages: Refers
to whether printer
intervention messages are sent
to any valid user or to the
user who queued the print job.
vhs* Variable Horizontal Spacing: yes, no
Does the printer have ESC d
and ESC e controls?
Processed November 7, 1990 DDI(5,F) 8
DDI(5,F) AIX Technical Reference DDI(5,F)
Key Possible
Word Description Choices
vpqs* Variable Print Quality yes, no
Support: Does the printer
have the ability to print
different degrees of quality?
vsi* Vertical Spacing Increment: 216, 144
Refers to parts of inch
supported in ESC J and ESC 3
control.
vts* Vertical Tab Support: Does yes, no
the printer support vertical
tabs?
wll Wrap Long Lines: Does the yes, no
printer "wrap" lines? That
is, will it break at the right
margin those lines longer than
specified form width and print
the remainder on the next
line?
12ps* 12 Pitch Support: Does the yes, no
printer support the printing
of 12 characters per inch?
FONTS: You can select any of the fonts or print type styles included on the
font diskette. You must type the name of the font and the type style exactly
as they appear on the diskette.
IBM 5201 QUIETWRITER
Key Possible
Word Description Choices
cp1 Code Page 1 PC, A, B, C, D
fnt1 Font 1
pitch1 Character Pitch 1
type1 Typestyle 1
IBM PROPRINTER (4201) AND IBM PROPRINTER XL (4202): Four different sets of
values are available for the IBM 4202 Proprinter (character pitch 1-4 and code
page 1-4). Each set contains a designation for character pitch and code page.
The possible choices for each of the four sets are shown below.
Processed November 7, 1990 DDI(5,F) 9
DDI(5,F) AIX Technical Reference DDI(5,F)
The code page choices for the IBM 4202 are the PC or multilingual code page
(MLP). The PC code page contains the standard U.S. English alphabet, symbols,
and punctuation marks. The MLP code page contains characters, symbols, and
punctuation marks from many alphabets and languages.
Key Possible
Word Description Choices
cp1 Code Page 1: On the American PC, MLP
version of the 4201, cp1 must
be set to PC.
pitch Character Pitch 10, 12
TTY, TTYN, OR TTYP DEVICES
Key Possible
Word Description Choices
aa Automatic Answering: Specifies whether true, false
the device supports communication auto
answering. If the aa keyword is true, the
getty command will transmit a modem
command sequence to place the modem in
automatic answering mode.
ae Automatic Enable: At boot time, this true=enabled; false=not
determines the original enabling of the enabled For TTY devices
port. When ae is true, the port will be only: share=
enabled whenever the system is ipl'ed. shared/bidirectional
When ae is false, the port will be use; delay=delay logon
disabled. Setting ae to share or delay herald
will result in the port being enabled with
the proper locking to permit outgoing
calls to originate from the PS/2.
bpc Bits Per Character: The number of bits 5, 6, 7, 8
per character used to transmit data from
the PS/2 to the terminal or modem. This
is usually set to 7 or 8 and must match
whatever the terminal or modem is setup to
use. NLS support requires a bpc value of
8.
Processed November 7, 1990 DDI(5,F) 10
DDI(5,F) AIX Technical Reference DDI(5,F)
Key Possible
Word Description Choices
dvam Device Attachment Method: Refers to 0=local; 1=remote
whether the device is attached locally (modem)
without a modem or remotely through a
modem. Locally attached devices can be
opened no matter what the state of the
Carrier Detect, Clear To Send, Data Set
Ready, and Ring Indicate signals. Opens
do not complete for remote devices until
Carrier Detect, Clear to Send, and Data
Set Ready are all asserted.
ixp Include Xon/Xoff Protocol: When ixp is true, false
set to true, Xon/Xoff flow control is used
on both the received and transmitted data
streams. The values of the roffv, ronv,
toffv, and tonv keywords determine the
actual characters which will be used to
implement the flow control.
elevel Run-level of the getty process: Each 0-6, a, b, c
getty process spawned by init is assigned
to a run-level in which it is allowed to
exist. For example, if elevel is set to
14, then the getty is executed when the
system is in multi-user mode. Refer to
the level attribute in the description of
inittab for more information.
logger Pty Supports Login Shell: True indicates true, false
that a stanza for this pty will be put in
the /etc/ports file that will allow the
port to be enabled and disabled.
nosb Number of Stop Bits: Refers to the number 1, 1.5, 2
of stop bits used to frame each data
character transmitted. The value chosen
must be compatible with the bpc selection.
1.5 stop bits is only valid when bpc is
set to 5.
Processed November 7, 1990 DDI(5,F) 11
DDI(5,F) AIX Technical Reference DDI(5,F)
Key Possible
Word Description Choices
pro Protocol: Refers to communication dtr, dc
protocol which determines how the modem
control lines are used during a
communications session. The pro keyword
is generally set to dtr. The dc (Direct
Control) value allows attachment of
devices that use hard-wired flow control,
such as certain serial printers and
plotters.
Note: While hard-wired flow control is
sometimes referred to as DTR
pacing, the pro keyword must be set
to dc to support this function.
pt Parity Type: Specifies what type of even, odd, mark, space,
parity, if any, the transmitted data will none
have. Received data will be checked to
ensure it has the proper parity. The
Native Serial Ports do not support the
mark or space parity.
rts Receive/Transmit Speed: Refers to the 50, 75, 110, 134.5,
communication baud rate. 150, 300, 600, 1200,
1800, 2000, 2400, 3600,
4800, 7200, 9600, 19200
tt Terminal Type: Refers to the type of
device attached.
3270 DEVICES
Key Possible
Word Description Choices
lobibp Buffer Length: Length of the 4096-65453
buffers in the 3270 device
driver buffer pool.
serial Serial Number: PS/2 serial 0000001-9999999
number, must be 7 digits.
machtype PS/2 Machine Type. 8580, 8570
Processed November 7, 1990 DDI(5,F) 12
DDI(5,F) AIX Technical Reference DDI(5,F)
Key Possible
Word Description Choices
mnonid Number of 3270 Sessions: 1-8
There may be up to eight
simultaneous Distributed
Function Terminal sessions per
3270 Connection Adapter.
slow Slow Device Mask Enables or 0-12345678
Disables Slow Device on a per
3270 Session Basis: If slow
device is set to 2, then 3270
session will be set to a slow
device. If slow is set to 28,
then 3270 sessions 2 and 8
will be slow devices.
printer Printer Device Mask: Refer to 0-12345678
slow for interpretation of
mask.
FILES
/etc/ddi/diskette
/etc/ddi/ethernet
/etc/ddi/token
/etc/ddi/opprinter
/etc/ddi/plotter
/etc/ddi/pprinter
/etc/ddi/sprinter
/etc/ddi/tty
/etc/ddi/pty
/etc/ddi/tape
/etc/ddi/c327
/etc/ddi/nty
and possibly others.
RELATED INFORMATION
In this book: "attributes," "descriptions," "kaf," "master," "options,"
"predefined," and "system."
Processed November 7, 1990 DDI(5,F) 13