ddi
Purpose
Contains device-dependent information (ddi).
Description
A ddi file contains information for customizing classes
(or types) of hardware adapters or 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 param-
eters in the files into a corresponding Define_Device
structure, which is used by the VRM device driver. 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.
The use of extended characters in ddi files is not sup-
ported.
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.
Key Possible
Word Description Choices
aa Automatic Answering: Does the printer true,
support communication auto answering? false
Key Possible
Word Description Choices
ae Automatic Enable: Refers to the method in true=enable,
which a port may be automatically enabled. false=not
enabled,
share=
shared
bidirectional
use,
delay=delay
logon
hearld
alf Automatic Line Feed: Does the printer have true,
automatic line feed with carriage return. false
ami Adapter Microcode IOCN: The IOCN of the
microcode module for an adapter that
requires an IPL.
appt Application Type: The type of application 3280,
that runs on the link. rje
ars Aspect Ratio Support: Does the printer yes,
have a set aspect ratio control? no
at Adapter Type: Refers to the last two
digits of the service request number.
backs Backspace Support: Does the printer have yes,
the ability to backspace (move print head no
backward while printing a line)?
bigs Bit-Image Graphics Support: Does the yes,
printer have bit image graphics controls? no
biopa First I/O Port Address: Refers to the
hardware adapter address.
bm Bottom Margin (last line): Refers to the 1 -
number of the last writing line. [length(in.)
S
lines/in.]
bpc Bits Per Character: Refers to the char- 5,
acter length in bits. 6,
7, 8
brea Bus RAM End Address: If not zero, refers
to the adapter's end RAM address on the
I/O bus.
brsa Bus RAM Start Address: If not zero,
refers to the adapter's start RAM address
on the I/O bus.
Key Possible
Word Description Choices
bs Block Size: Refers to the size of sectors 512,
of storage on the fixed disk; changes in 1024,
number of blocks on minidisks may affect 2048
system performance.
bsess Base Session: Indicates the base session
number for the link.
cdp Condensed Print: Does the printer support yes,
printing in condensed characters? no
cdpg Code Page: Specifies the code page loaded 437
into the printer. (PC),
850
(MLP)
cn DMA Channel Number: Refers to DMA channel 0 -
number. 9
colp Color Printer: Refers to whether the yes,
printer is capable of printing in color. no
cps Condensed Print Support: Can the printer yes,
print in condensed characters? no
cp1 - Code Page 1 through Code Page 8: Speci- PC,
cp8 fies the code pages loaded into the A,
printer. The IBM 5201 Printer and 4201 B,
Proprinter use only cp1 and cp2. C,
D,
P0,
P1,
P2,
MLP
cr Color Ribbon: Does the printer have color yes,
ribbon? no
cs Character Set: Refers to complete groups 1, 2
of characters that a printer can support.
cus Continuous Underscore Support: Supports yes,
the escape - (minus) control. no
ddbw Device Data Bus Width: Refers to whether 8,
the I/O adapter is an 8-bit or 16-bit 16
device.
devname Adapter Device Name: Refers to the device token0,
name of the communications hardware token1,
adapter to be used by the data link mpd0,
control. mpd1,
mpd2,
mpd3,
net0,
net1
Key Possible
Word Description Choices
dmao Uses DMA Support Only: Use only DMA true,
transfers. false
dmas DMA Support: Refers to whether the hard- true,
ware adapter supports DMA. false
dnec Do Not Enable DMA Channel: The channel is true,
not enabled if the value is true. false
dpc Default Print Color: Refers to the color black,
to use for printing when a file does not blue,
contain codes that specify a color: red,
usually black, blue, red, or yellow. yellow
dsp Double Strike Print: Should double-strike yes,
be turned on? no
dsps Double Strike Print Support: Does the yes,
printer have a control double-strike char- no
acters and provide boldface?
dvam Device Attachment Method: Is your device 0=local,
attached locally with a cable or is it 1=remote
attached through a modem? (modem)
dwp Double Width Print: Should a file be yes,
printed with a double-width character set? no
dwps Double Width Print Support: Does the yes,
printer have the ability to print with a no
double-width character set?
ei Enable Adapter Interrupts.
ei1 - Enable First through Fourth Interrupt true,
ei4 Level: Refers to conditions allowing the false
printer to stop when an error occurs or
when assistance is needed to complete I/O
on interrupts levels 1, 2, 3, or 4.
ep Emphasized Print: Should emphasized print yes,
be turned on? Every character is over- no
struck with a second pass of the print
head.
eps Emphasized Print Support: Does the yes,
printer have a control to do emphasized no
print?
eus Expansion Unit Slot: Refers to whether true,
the slot number is located in an expansion false
unit.
Key Possible
Word Description Choices
fd Fixed Disk: Refers to one of up to three hdisk0,
circular plates used for storing data. hdisk1,
hdisk2
fi Frequency Input: Refers to clock fre-
quency to USART chips.
fid Font ID: ID of the font used by the 11
printer.
fl Form (page) Length: Refers to the length 1 -
of the paper in terms of the number of [(in.)
lines per page. The value is determined S
by multiplying the length of paper (in lines/in.]
inches) by the number of lines printed per
inch.
fnt1 - Font 1 through Font 8: Specifies the
fnt8 printer fonts, such as letter gothic or
prestige elite. This keyword is used for
the IBM 3812 Pageprinter.
fp First Party DMA: Refers to whether hard- true,
ware adapter has own DMA controller. false
fw Form Width (right margin): Refers to the 1
width of paper in terms of the number of [width(in.)
characters per line. The value is deter- S
mined by multiplying the width of the pitch]
paper (in inches) by the number of charac-
ters printed per inch.
hsi Horizontal Spacing Increment: What hori- 60,
zontal increment is used in the ESC K 70,
control? 120
hts Horizontal Tab Support: Does the printer yes,
have horizontal tab controls? no
htvi Text Vertical Increment: The vertical 72
index increment used by subsequent CUU
(ESC A) multi-byte controls. (See "Multi-
Byte Controls.")
ic1 - Service Class of First through Fourth 0,
ic4 Interrupt: Refers to interrupt priority, 1,
where 0 is the highest. 2,
or 3
il1 - Interrupt Level Number of First through
il4 Fourth Interrupt: Refers to hardware
adapter interrupt levels 1 through 4.
iobd Input/Output Bus Device. true,
false
Key Possible
Word Description Choices
ioccb Using DMA Four-Byte Buffering. true,
false
iof1 - Read/Write Flag for I/O Operation 1 0 =
iof8 through 8 : Is a read or write required Input,
to the corresponding I/O port address (pa1 1 =
- pa8)? Output
iopar Number of I/O Port Addresses: Refers to
hardware adapter address range.
iow1 - I/O Width for I/O Operation 1 through 8: 0 =
iow8 Refers to the number of bits to be written 8
to or read from the port address bit,
(pa1-pa8). 1 =
16
bit
ip Initialize Printer: Refers to the initial true,
state of the printer after power is false
applied.
ixp Include Xon/Xoff Protocol: Refers to true,
whether communication protocol is false
included.
js Justification Support: Refers to printing yes,
with the right margin even. no
kpoe Keep Printing on Error: Should the yes,
printer complete the print job despite no
errors (without sending an error message
to the user)?
llo Leave DTR and RTS Lines On. true,
false
lm Left Margin: Refers to the area on a page 0 -
between the left edge and the leftmost [width(in.)
character position on the page. S
pitch]
lobibp Length of Buffers in Buffer Pool: The
length in bytes of each buffer in the
buffer pool of the Block I/O Communication
Area (BIOCA).
logger PTY supports a login shell. true,
false
lpi Lines Per Inch: Refers to the number of 6, 8
print lines per inch, to line spacing
density, and to the distance paper moves
during a line feed.
Key Possible
Word Description Choices
lrmc Left/Right Margin Controls: Does the yes,
printer have the ability to change left no
and right margins (does it have left and
right margin control codes)?
lun Logical Unit Number: Number associated 0 -
with an addressable physical or logical 7
device.
mask Mask: Refers to the mask that indicates F1FF
defaults overridden by corresponding field
in the Define_Device structure.
maxsaps Maximum Service Access Points: Specifies 1 -
how many concurrent service access points 126
can open on the data link control.
maxbios Maximum Number of Block I/O Devices: 1-100
Refers to maximum number of block I/O
devices.
mc Modem Controls: Refers to whether or not true,
to enable modem controls. false
mccs Multibyte Control Code Support: If yes, yes,
then the printer supports IBMOEM multi- no
byte controls. If no, then the printer is
assumed to function like an IBM 5152
printer.
mnoal Maximum Number of Attached LCCs: The
maximum number of LCCs that can be
attached to the device driver using the
Block I/O Communication Area (BIOCA).
mnonid Maximum Number of Net IDs: The maximum
number of network IDs that the device
driver can support.
nidd Net ID Displacement: The offset (in
bytes) into the receive data of the
network ID.
nidl Net ID Length: The length in bytes of a
network ID.
nnfst No Negotiate for Synchronous Transfer: true,
Refers to whether the device negotiates false
for synchronous transfer.
noabb Number of Allowed Bad Blocks.
nob Number of Blocks: Refers to the number of
blocks in a minidisk.
Key Possible
Word Description Choices
nobibp Number of Buffers in Buffer Pool: The
number of buffers to be allocated in the
buffer pool of the Block I/O Communication
Area (BIOCA).
nobod Number of Blocks on Device.
nobodr Number of Buffers on a Device Ring: The
number of buffers to be allocated for each
device ring queue in the Block I/O Commu-
nication Area (BIOCA).
nobub Number of 256-Byte Units/Block: Number of
256-byte units on each block.
noi Number of Interrupt Levels Used: Refers
to the number of hardware interrupt
levels.
nops Number of I/O Operations. 1 -
8
nor1 - Number of Repetitions for I/O Operation 1 1 -
nor8 through 8: Refers to the number of times 64
the same I/O operation is performed to the
corresponding port address (pa1 - pa8).
norbosr Number of Receive Buffers on SLIH Ring
queue.
nosb Number of Stop Bits: Refers to the number 1,
of stop bits in a communication character. 1.5,
2
nospt Number of Sectors per Track.
now Number of DMA Sub-Channels. 0
nr No Read-Only Memory. true,
false
nsess Maximum Number of Sessions: The maximum 1,
number of sessions that can be run on the 2,
link. 3,
4,
5,
6,
7, 8
od1 - Output Data for I/O Operation 1 through 8: 0000
od8 Refers to the data to be written to the -
corresponding port address (pa1 - pa8) if FFFF
the corresponding flag (iof1 - iof8) is
set for output.
Key Possible
Word Description Choices
om Operation Mode: Refers to whether commu- tx,
nications operation mode is set. rx,
full,
half
pa1 - Port Address for I/O Operation 1 through 0000
pa8 8: Refers to the adapter port address -
being written to or read from to disable FFFF
the adapter.
pacs Print All Characters Support: Does the yes,
printer support ESC ^ and ESC \ controls? no
pdt Peripheral Device Type.
ph Paper Handling: Refers to the way the 0 =
printer handles different types of paper. manual;
The manual-feed printer stops at the end 1 =
of each page and waits for the user to automatic;
insert another sheet and press the start 2 =
button. A printer with an automatic continous
sheet-feed mechanism feeds paper to the form
printer. paper.
pinit User-Supplied Sequence: Refers to the
control sequence the coprocessor uses to
reset the printers whose fonts can be
changed.
pitch1 Character Pitch 1 through Character Pitch 10,
- 8: Refers to the number of characters per 12,
pitch8 linear inch; for instance, 10-pitch type 15
has 10 characters per inch.
plot Pass Data Directly to Device Without Mod- yes,
ification. no
pn Port Number on Adapter: Refers to the 0 -
hardware adapter port. 4
pq Print Quality: May select (on some dp,
printers) degrees of print quality: dp text,
(for fast, low quality), text (for better letter
draft quality), letter (for high-quality
final text).
prin Printer Type: 0 = unspecified (func- 0,
tionally 5152); 1 = IBM 5152; 2 = IBM 1,
5182; 3 = reserved; 4 = IBM 5201 Printer; 2,
5 = IBM 4201 Proprinter; 6 = IBM 4202; 7 = 3,
IBM 3852. 4,
5,
6, 7
Key Possible
Word Description Choices
pro Protocol: Refers to communication pro- dtr,
tocol. cdstl,
dc
psd Paper Source Drawer: Refers to the 1 =
location of the paper drawer from which top;
paper is drawn for printing. 2 =
bottom
pss Proportional Spacing Support: Does the yes,
printer support proportionally spaced no
printing?
pt Parity Type: Refers to communication even,
character parity. odd,
mark,
space,
none
rdto Receive Data Transfer Offset: The device
driver using block I/O transfers the
receive packet beginning at this offset
into the buffer.
rea Bus ROM End Address: If not zero, refers
to the adapter's start ROM address on the
I/O bus.
rl RAS Length: The length in words of the
RAS section of the Define Device struc-
ture.
rlfs Reverse Line Feed Support: Does the yes,
printer support the ESC ] control? no
roffv Receive Xoff Value: Refers to character 00 -
to transmit in order to inform a remote FF
device to stop sending data.
ronv Receive Xon Value: Refers to character to 00 -
transmit in order to inform a remote FF
device to resume sending data.
rsa Bus ROM Start Address: If not zero,
refers to the adapter's end ROM address on
the I/O bus.
rtrig Receive Buffer Trigger: If the adapter 1,
has receive data buffering capability, 4,
then this value selects the number of 8,
bytes that trigger a received data inter- 14
rupt.
Key Possible
Word Description Choices
rts Receive/Transmit Speed: Refers to commu- 50,
nication baud rate. 75,
110,
134.5,
150,
300,
600,
1200,
1800,
2000,
2400,
3600,
4800,
7200,
9600,
19200
rxringq Receive Ring Queue Size: Specifies the 1 -
number of receive buffers that can be 255
queued for each data link control service
access point.
rxt Receive Xoff Threshold: Refers to 20
threshold for full communication buffer
detection.
sa Strobe Active. true,
false
sdmac Shared DMA Channel: Refers to whether a true,
hardware adapter can share DMA channel. false
sg DMA Scatter/Gather Support: Refers to DMA true,
support the ability of hardware to scatter false
and gather I/O data.
si1 - Share First through Fourth Interrupt true,
si4 Levels: Refers to whether interrupt false
levels 1, 2, 3, or 4 are able to be
shared.
sid SCSI ID: Refers to the SCSI ID number. 0 -
6
slap Skip Lines at Perforation: Refers to the 0-[length(in.)
number of lines skipped at page breaks. S
The number is divided by 2, so that half lines/in.]
the blank lines appear at the bottom of
one page and half at the top of the next.
slow Slow Device Support: Refers to whether 0 =
DFT slow device support is enabled. Dis-
abled,
1 =
Enabled
Key Possible
Word Description Choices
sn Slot Number: Refers to the slot in which 1 -
an adapter is installed. 8
sns Switched/Nonswitched: Refers to the state true,
of the communication line connection. false
sp Select Printer. true,
false
sppt Serial/Parallel Printer Type: Refers to 1 =
whether the printer is a serial or par- Par-
allel type. allel,
2 =
Serial
srbt SLIH Ring Buffer Threshold: The number of
SLIH ring queue buffers that the device
driver can use before requesting addi-
tional buffers from the block I/O device
manager.
sss Superscript/Subscript Support: Does the yes,
printer have the ability to print in no
superscript and subscript mode?
sysadd Specifies the action that the devices a,
command takes after adding the device. v,
The valid choices are: none
a Rebuilds the kernel and IPLs the
system
v Runs the vrmconfig command
none Takes no special action.
sysdel Specifies the action that the devices a,
takes after deleting the device. The v,
valid choices are: none
a Rebuilds the kernel and IPLs the
system
v Runs the vrmconfig command
none Takes no special action.
tbc Transmit Buffer Count: Number of bytes to
buffer for transmitter.
tm Top Margin: Refers to the number of lines 0 -
to be skipped at the top of a page before [length(in.)
printing begins. If the user specifies 6 S
lines, the first print line will be line lines/in.]
7. The value is determined by the length
of paper (in inches) multiplied by the
number of lines per inch.
Key Possible
Word Description Choices
toffv Transmit Xoff Value: Refers to the commu- 00 -
nication character to transmit in order to FF
inform a remote device to cease sending
data.
tonv Transmit Xon Value: Refers to the commu- 0 -
nication character to transmit in order to FF
inform a remote device to resume sending
data.
tt Terminal Type: Refers to the type of the
terminal being used.
txringq Transmit Ring Queue Size: Specifies the 1 -
number of transmit buffers that can be 255
queued for the data link control at one
time.
type1 - Typestyle 1 through Typestyle 8: Refers to
type8 a typestyle such as bold or italic.
urpim User to Receive Printer Intervention Mes- Any
sages: Refers to whether printer inter- user
vention messages are sent to any valid ID,
user or to the user who queued the print pjo
job. =
Print
Job
Owner
vhs Variable Horizontal Spacing: Does the yes,
printer have ESC d and ESC e controls? no
vpqs Variable Print Quality Support: Does the yes,
printer have the ability to print dif- no
ferent degrees of quality?
vsi Vertical Spacing Increment: Refers to 216,
parts of inch supported in ESC 3 and ESC J 144
controls.
vts Vertical Tab Support: Does the printer yes,
support vertical tabs? no
wll Wrap Long Lines: Does the printer "wrap" yes,
lines? That is, will it break lines no
longer than the specified form width at
the right margin and print the remainder
on the next line?
12ps 12 Pitch Support: Does the printer yes,
support 12 pitch? no
Files
/etc/ddi/diskette
/etc/ddi/enet
/etc/ddi/float
/etc/ddi/font
/etc/ddi/opprinter
/etc/ddi/plotter
/etc/ddi/pprinter
/etc/ddi/sprinter
/etc/ddi/tty
and possibly others.
Related Information
In this book: "attributes," "descriptions," "kaf," "master," "options,"
"predefined," and "system."