HP LaserJet 9000 User manual

HP 9000 Computers
DTC Device File Access
Utilities and Telnet P
ort
Identification
ABCDE
HP Part No. B1030-90002
Printed in U.S.A. 01/95
Edition 2
E0195

Legal Notices
The information in this document is sub ject to c
hange
without notice.
Hew lett-Packar
dmakes no warr
anty of any kind with
r
e
gar
dto this material, including, but not limite
dto, the
implie
dwarr
anties of mer
chantability and tness for a
p
articular purp
ose.
Hewlett-P
ac
k
ard shall not beliable
for errors con
tained herein or direct, indirect, special,
inciden
tal, or consequen
tial damages in connection with
the furnishing, performance, or use of this material.
W
arran
t
y
.
Acop
yof the specic w
arran
t
yterms
applicable to y
our Hewlett-P
ac
k
ard pro duct and
replacemen
tparts can beobtained from your local Sales
and Service oce.
Restricted Rights Legend.
Use, duplication or disclosure
b
ythe U.S. Go
v
ernmen
tis sub ject to restrictions as
set forth in subparagraph (c) (1) (ii) of the Righ
ts in
T
ec
hnical Data and Computer Soft
w
are clause at DFARS
252.227.7013 for DOD agencies, and subparagraphs (c)
(1) and (c) (2) of the Commercial Computer Soft
w
are
Restricted Righ
ts clause at F
AR 52.227-19 for other
agencies.
HEWLETT-P
A
CKARD COMP
ANY
3000 Hano
v
er Street
Palo Alto, California 94304 U.S.A.
Use of this man
ual and exible disk(s) or tap e
cartridge(s) supplied for this pac
k is restricted to this
pro duct only
. Additional copies of the programs ma
ybe
made for securit
y and bac
k-up purposes only
. Resale of
the programs in their presen
t form or with alterations, is
expressly prohibited.

Copyrigh
t Notices.
(c)cop
yrigh
t1979, 1980, 1983,
1985-93 Regen
ts of the Univ
ersit
yof California
This soft
w
are is based in part on the F
ourth Berk
eley
Soft
w
are Distribution under license from the Regents of
the Univ
ersit
yof California.
(c)cop
yrigh
t1980, 1984, 1986 No
v
ell, Inc.
(c)cop
yrigh
t 1986-1992 Sun Microsystems, Inc.
(c)cop
yrigh
t1985-86, 1988 Massac
h
usetts Institute of
T
ec
hnology
(c)cop
yrigh
t1989-93 The Open Soft
ware F
oundation,
Inc.
(c)cop
yrigh
t1986 Digital Equipmen
tCorp oration
(c)cop
yrigh
t1990 Motorola, Inc.
(c)copyrigh
t1990, 1991, 1992 Cornell Univ
ersit
y
(c)cop
yrigh
t1989-1991 The Universit
yofMaryland
(c)cop
yrigh
t1988 Carnegie Mellon Univ
ersit
y
T
rademark Notices
UNIX is aregistered trademark
in the United States and other coun
tries, licensed
exclusiv
ely through X/Open Compan
yLimited.
XWindo
wSystem is atrademark of the Massac
h
usetts
Institute of Tec
hnology
.
MS-DOS and Microsoft are U.S. registered trademarks of
Microsoft Corp oration.
OSF/Motif is ais a trademark of the Op en Soft
w
are
F
oundation, Inc. in the United States and other
countries.
c
 Copyright 1995, Hewlett-Packard Company.

Printing History
The man
ual prin
ting date and part n
um
ber indicate its
curren
tedition. The prin
ting date will c
hange when a
new edition is prin
ted. Minor c
hanges ma
ybemade at
reprin
twithout c
hanging the prin
ting date. The manual
part n
um
ber will c
hange when extensiv
ec
hanges are
made.
Man
ual updates ma
ybeissued bet
w
een editions to
correct errors or documen
tpro duct c
hanges. T
o ensure
that y
ou receiv
ethe updated or new editions, y
ou should
subscribeto the appropriate pro duct supp ort service.
See y
our HP sales respresen
tativ
e for details.
Edition 2
Jan
uary 1995 (HP-UX Release 10.0)
iv

Contents
1. In
tro duction
In
tended Audience ..........1-2
Prerequisites .............1-2
Supported Congurations .......1-3
Related HP Do cumen
tation ......1-5
2. Ov
erview of DDF
AAnd T
elnet P
ort Iden
tication
How DDF
AUtilities W
ork .......2-2
Ho
wT
elnet P
ort Iden
tication W
orks ..2-5
Ho
wDevice Files Are Handled By MUXes
and DTC T
erminal Serv
ers .....2-5
Setting Up Outgoing and Incoming
Connections ...........2-6
DDF
AFile Directories and Setup ....2-9
3. Conguring DDF
AConnections
DDFAMaster Files . . ........3-1
Related Conguration T
asks .... . . 3-3
DDF
AConguration T
asks ......3-4
Conguring Outgoing Connections
(Prin
ters) . . . . . . . . . . . . 3-5
Conguring Incoming Connections
(Terminals) . .. . . . . . . . . 3-8
Starting Up the o cd Daemons . . . . 3-9
Contents-1

4. Dening and Executing DDF
AP
arameters
Using Dedicated P
orts .........4-1
The Dedicated P
ort File, dp . . . . . .4-2
The P
ort Conguration File, pcf ....4-4
Managing Outgoing Dedicated P
orts With
dpp and ocd .. . . . ......4-9
Preparing to Use dpp ........4-11
Using dpp to Kill and Restart ocds ..4-12
Using dpp to Start Up New o cds . ..4-12
Using dpp to Remo
v
eExisting ocds ..4-12
Managing Incoming Connections b
ytelnetd 4-13
Using dpp to Update T
elnet P
ort
Identication Info . . . .....4-13
5. Application Examples
Setting Up Prin
ters with the HP-UX
Spooler ............. . 5-1
HP-UX Spooler Example ......5-2
Accessing DTC or non-DTC P
orts
Programmatically .........5-3
Conguring Incoming Connections for
CSLIP/SLIP .. . . . ......5-5
6. Simple DDF
AT
roubleshooting
Troublesho oting Chec
klist . ......6-2
T
roublesho oting Outgoing Connections .6-3
Chec
kfor Syn
tax Errors .......6-3
Check for Incorrect Addresses ....6-3
Chec
kT
elnet Operation . . . . . ..6-3
V
erify ocd .... . ........6-4
Checkthe pty . . . . . . . . . . . 6-4
Check System Lev
el Data P
ath . . . . 6-4
Troublesho oting Incoming Connections .6-5
If You Ha
ve to Call Hewlett-P
ackard . 6-6
Contents-2

A. Appendix A: dpp Error Messages
B. Appendix B: ocd Logging Messages
Critical Messages . . . . . ......B-2
Serious Messages ...........B-7
W
arning Messages ...... . . . .B-19
Informational Messages . . . .....B-26
Index
Contents-3

Figures
2-1. HP 9000 and DTC In
teraction With
DDF
A.............2-4
2-2. Incoming Connection Using T
elnet P
ort
Iden
tication ......... . 2-8
Contents-4

1
Introduction
This man
ual explains ho
wto use the DTC Device
File Access Utilities (DDF
A) and the T
elnet P
ort
Iden
tication feature to comm
unicate with HP 9000
serial devices connected to net
w
ork terminal serv
ers suc
h
as the HP Datacommunications and T
erminal Con
troller
(DTC). DDF
Afacilitates the use of pseudoterminal
(pt
y) device les to open outgoing T
elnet connections
to the DTC or other terminal serv
er, while T
elnet P
ort
Iden
tication uses them to establish incoming T
elnet
connections from kno
wn devices on the serv
er. T
elnet
is one of the HP 9000 In
ternet Services (HP B1030B),
formerly kno
wn as the HP 9000 ARP
AServices.
DDF
Aw
as originally designed for use with DTCs, but as
of HP-UX 10.0, it can no
wbeused with other terminal
serv
ers whic
huse addressing schemes similar to the
DTC. There will besome guidelines on ho
wto congure
DDF
Afor use with non-DTC terminal serv
ers, but the
DTC will be used as the primary example throughout
this man
ual.
In addition, there is general discussion on the topic of
pt
yuse with HP DTC terminal serv
ers v
ersus the HP
MUX, and ho
w to troublesho ot incoming and outgoing
DDF
A connections.
Introduction 1-1

Intended Audience
This man
ual is in
tended for at least three t
ypes of users:
The HP 9000 system administrator or net
work
administrator who denes and congures the device
les asso ciated with DTC and other terminal serv
er
devices on the system.
The HP 9000 system operator or net
w
ork operator
who ma
yimplemen
tthe actual tasks set up by the
system or net
w
ork administrator.
The applications programmer who needs programmatic
con
trol of devices on the DTC or other terminal serv
er
using standard HP-UX input/output calls suc
has
open
,
close
,
io ctl
,
read
,and
write
.This programmer
ma
y also ha
v
eapplications using devices connected to
MUX ports and wishes to extend the application to
use DTC devices.
Prerequisites
Before reading this man
ual and using this soft
w
are, y
ou
should befamiliar with ho
wto:
Handle HP-UX operating system and system
administration, especially with devices and device les.
Congure aDTC
with either the DTC Manager/UX
pro duct (HP J2120A) or the OpenView DTC Manager
pro duct on the PC (HP D2355A).
Congure and administer other terminal serv
ers.
Program devices and use device les for
pseudoterminals (pt
ys) or MUXes.
Access on-line DDF
Aman pages on y
our system like
ddfa(7), dp(4), dpp(1M), o cd(1M), o cdebug(1M), as
well as io ctl(2), io ctl(5), p cf(4), and termio(7).
1-2 Introduction