Google
 

Trailing-Edge - PDP-10 Archives - cust_sup_cusp_bb-x130c-sb - 10,7/unsmon/ksdmr.doc
There are 6 other files named ksdmr.doc in the archive. Click here to see a list.


1.0  INTRODUCTION

The 7.02 release of the TOPS-10 monitor contains unsupported
code  to  run DMR11s on a KS10.  Although this code has been
used successfully on in-house systems, it is not an official
part of the Monitor.

This document describes the known limitations and advantages
of  using  a DMR11 on a KS10.  It also describes the process
necessary  to  install  and  use  the  software.    Hardware
installation considerations are also discussed.

No representation is made that this document is complete  or
correct  in  all  respects.   Although every effort has been
made by  the  author  to  ensure  its  correctness,  Digital
disclaims  any  responsibility  for  the  use of unsupported
hardware and/or software, whether or  not  such  use  is  in
accordance  with  information contained in this document, or
any other.



2.0  LIMITATIONS AND RESTRICTIONS

Use of a DMR11 in a KS10 represents a  change  to  both  the
hardware  and  software  environment,  and  may  impact  the
perceived performance of the system.

The  DMR11  hardware's  inherent  performance  exceeds   the
ability  of  the  2020  to  drive  it.   As  a  consequence,
configuring a 2020 which includes DMRs requires evaluating a
complex  set  of  trade-offs.   Although  this document will
attempt to present some of the  considerations  involved  in
this  evaluation,  you should enlist the help of a qualified
network analyst in applying them to your situation.

The "standard"  2020  configuration  has  extremely  limited
backplane  space.  It is not possible to install DMR11s in a
maximally configured 2020 system  without  the  purchase  of
additional  hardware.  Installing DMR11s in a smaller system
may limit future expansion.

We strongly urge any site considering installing this option
to  consult  with  their  local  Field  Service and Software
Services representatives prior to making any final decision.
KSDMR.BWR - Beware file for KS DMR (non-)support      Page 2


3.0  ADVANTAGES

The  DMR11  provides  the  following  advantages  over   KDP
(KMC/DUP) synchronous interfaces:

      o  The DMR11 supports V.35,  RS-422-A,  RS-423-A,  and
         coaxial cable interfaces, in addition to RS-232-C.

      o  The coax DMR11 can operate over a distance of up to
         6 km (19,685 feet) without an external modem.

      o  The DMR11 will operate in half-duplex  mode.   Half
         duplex  mode  is  supported  by  the  software  for
         DECnet, ANF-10, and Program use.

      o  The DMR11 will operate over  a  switched  (dial-up)
         line, and will provide the necessary modem control.

      o  The DMR11 runs self diagnostics upon startup.   The
         monitor   will   not   use   a   DMR   that   fails
         microdiagnostics.

      o  The  DMR11  does  all  DDCMP  protocol   (including
         retransmissions)  without  help  from the KS10 CPU.
         This results in slightly lower overhead.

      o  The  DMR11  can  have   more   than   two   buffers
         outstanding at any one time.

      o  The DMR11 does not require  a  user-mode  microcode
         loader.




4.0  PERFORMANCE CONSIDERATIONS

Preliminary testing indicates  that  the  performance  of  a
DMR11  on a 2020 is approximately the same as that of a KDP.
Thus, although the  DMR11  hardware  is  capable  of  higher
speeds  than  the KDP, the DMR should not be viewed as a way
of getting higher network thruput from a 2020.

Setting the speed of a DMR link higher  than  the  2020  can
accept  data  will  cause  retransmissions,  and if taken to
extremes, may cause the other node to declare the link down.
Such  retransmissions  cause  unnecessary  Unibus traffic on
both nodes, and unnecessary KSBus traffic on the 2020.  Such
traffic  can impact the performance of other applications on
the system(s).

Although there is no experimental  data  supporting  it,  we
expect  that the DMR11 may perform significantly better than
a KDP over links which have a high  error  rate,  and  which
pipeline   effectively.   (eg.   Satellite  links)  This  is
KSDMR.BWR - Beware file for KS DMR (non-)support      Page 3


because  the  format  of  network  messages  is  changed  to
accomodate  the  KS10  UBA whenever a message is given to an
interface for transmission.   This  is  a  fairly  expensive
operation,  and  is  one  of  the limits of a 2020's network
performance.  Because the DMR holds  the  buffer  containing
the  external  form  of  the message until it has been DDCMP
ACK'd, the DMR's retransmissions  have  lower  cost  than  a
KDP's.   A  DMR can also manage up to 64 outstanding buffers
(if you can afford the core).



5.0  HARDWARE OPTIONS

The DMR11 used for a 2020 is  the  same  as  that  used  for
PDP-11  and  VAX  applications.   The  basic DMR11 subsystem
(DMR11-AD)  includes  the  microprocessor  and   line   unit
modules,   documentation,  test  connectors,  and  a  module
interconnect cable.  Customers should NOT order the DMR11-AD
option.   Instead,  one of the four DMR11 packages should be
ordered, depending on the  interface  type  desired.   These
are:

      o  DMR11-AA - RS-232-C/RS-423-A

         The  RS-232-C/RS-423-A  distribution  panel  mounts
         inside   the   KS10  cabinet.   Connection  to  the
         external modem  requires  purchase  of  a  BC05D-25
         cable  for RS-232-C modems, or a BC55D-33 cable for
         RS-423-A modems.

      o  DMR11-AB - CITT V.35

         This package includes a 25  foot  (BC05Z-25)  cable
         that  terminates  in  a  37  pin  DataPhone Digital
         Service (DDS) connector.

      o  DMR11-AC - Integral modem (Coax)

         Interconnecting two DMRs requires  TWO  cables  for
         full  duplex operation.  Only one cable is required
         for half duplex.  For  2020  data  rates,  purchase
         BC55N-98  twinax  cable.   (98  feet  long)  Longer
         cables can  be  purchased  on  special  order  thru
         Digital's Accessories and Supplies group.

      o  DMR11-AE - RS-422-A

         The RS-422-A distribution panel mounts  inside  the
         KS10  cabinet.   Connection  to  the external modem
         requires purchase of a BC55D-33 cable.

KSDMR.BWR - Beware file for KS DMR (non-)support      Page 4


6.0  HARDWARE INSTALLATION

6.1  Backplane Requirements

Each DMR11 requires 2 hex-height SPC slots on  UBA  3.   The
DMR11  can co-exist with KDP lines.  A fully configured 2020
has  no  free  hex-height  slots.    Reasonable   trade-offs
include, but are not limited to:

      o  1 DMR and no KDP lines.  Use slots 2 and 4.

      o  2 DMRs and no KDPs.  Use slots 2,3,4, and 5.   This
         implies  that no more than 24 terminal (DZ11) lines
         exist.


Of course, it is possible to add a DNHXX-AA/AB expansion box
to  hold  the  DMRs.  In this case, you must order a DD11-DK
backplane, as the expansion box comes empty.  The DNHXX will
be  mounted  to  the left of the current CPU box to keep the
Unibus  length  within  specifications.   This  may  require
changing Massbus cables to disks or tapes.



6.2  Power Requirements

Each DMR11 requires 8 Amps of +5 volts, .1A  of  +15  Volts,
and  .2A  of -15 Volts.  The BA11-K mounting boxes which are
used in the KS10 have  a  capacity  of  50A  of  +5V  (split
between  2  25A  regulators),  4A  of +15V, and 10A of -15V.
Field Service must verify that any DMRs added to a system do
not  require  more  power  than is available in the box, and
that the power capacity of the backplanes  involved  is  not
exceeded.  (A DD11-DK can power no more than three DMR11s.)



6.3  Unibus Loading

Each DMR11 represents 1 Unibus DC  load,  and  5  Unibus  AC
loads.



6.4  Address/Vector/Priority

The KS puts DMR11s into the Unibus "user" address  space  in
the IO page.  DMR addresses are assigned starting at 764000,
and proceed sequentially in increments of 10  for  each  DMR
installed.   DMR vectors start at 610.  DMRs are expected to
operate at their default BR level, 5.
KSDMR.BWR - Beware file for KS DMR (non-)support      Page 5


6.5  Installation Considerations

The information presented here  is  intended  to  supplement
that  presented  in  the  DMR11 Technical Manual.  It is not
complete,  and  should  be  used  in  conjunction  with  the
instructions in chapter 2 of that manual.

Backplane  voltages  should  be  checked  with  a  DMM,  and
adjusted  if necessary both before and after installation of
each DMR11.  Both slots of each DMR should be  checked.   +5
is on C1A2, +15 is on C1U1, and -15 is on C1B2.

The NPG backplane jumper must be removed from CA1-CB1 of the
backplane   slot  used  for  the  microprocessor  (M8207-RA)
module.


                          Caution

               Failure to remove this  jumper
               may  damage the M8207, as well
               as result in incorrect  system
               operation.





6.6  Jumpers and Switches

6.6.1  M8207 (Microprocessor Module) -

The "normal" configuration  from  the  technical  manual  is
correct, except with respect to addressing.  The KS does not
use floating addresses for the DMR.  See above.

Thus, W1, W2 are installed.  E28-7 is ON, E28-8 is OFF,  and
E85-1 is ON.



6.6.2  M8203 (Line Unit Module) -

Jumpers should be exactly as specified in table 2-8  of  the
technical  manual.   Note  in  particular that W17 should be
OUT, even for "half duplex" operation.  Some DMRs have  been
known to arrive mis-jumpered, so check!

Switch pack E39 - set per customer requirements.

Switch pack E121 - SW1-8 should all be ON.  SW9-10 should be
ON,  unless  a DMC is on the other end of the link, in which
case SW9 is OFF and SW10 is ON.
KSDMR.BWR - Beware file for KS DMR (non-)support      Page 6


Switch pack E134 - SW1-8 should all be OFF.  SW10 should  be
OFF.   SW9  should  be  ON  for  non-switched lines (eg null
modems, leased lines), OFF otherwise (dial-up).   Except  in
unusual  cases,  everything  will  work with SW9 OFF even on
non-switched lines.

For DMR11-AAs, refer to table 2-13 (p 2-27) for distribution
panel jumper selections.

For DMR11-ACs, Make sure that the terminators are  installed
per  figure  2-7  or  2-8  (p  3-35/6).   Note that only one
terminator is installed per cable, and that it goes  at  the
RCV  end.   Also  ensure  that  the  HDX/FDX  switch  is set
correctly on the distribution panel.



6.6.3  Ribbon Cables And Berg Connectors -

All of the ribbon cables and other Berg connectors in a  DMR
can be inserted two ways.  ONLY ONE OF THEM WORKS.  Here are
a few hints on getting it right the first time:

      o  The ribbon cable that goes between  the  line  unit
         and  the  microprocessor modules has no twists when
         installed correctly.  The cable is  marked  on  the
         smooth  side at each end with AA and VV.  Make sure
         that the AA edge of the cable is inserted into  the
         AA  end  of  the  module connector, and that the VV
         edge of the cable is inserted into the  VV  end  of
         the module connector.

      o  The  Ribbon  cables  that  go  from  the  M8203  to
         RS232/RS442   or   RS423  distribution  panels  are
         similarly marked.  But note that  the  Ribbed  side
         faces out.

      o  The COAX cables  that  go  to  the  Integral  Modem
         (DMR11-AC)      distribution      panel     install
         counter-intuitively;  when correctly inserted,  the
         cable  from  the connector runs toward the FRONT of
         the BA11 box and  is  squeezed  tightly  along  the
         M8203  edge.   The  plastic tab faces away from the
         module.




6.6.4  Mounting Distribution Panels -

The DMR11-AA/AB/AE (eg all but V.35) all run a ribbon  cable
from  the  M2803  to a metal distribution panel.  For proper
operation, the distribution panel must be properly  grounded
to the frame of the 2020 cabinet.  Scrape both the panel and
the cabinet rail, and use lockwashers liberally.  Also, make
KSDMR.BWR - Beware file for KS DMR (non-)support      Page 7


sure  that  the  spot  you  pick  will  allow  clearance and
sufficient cable slack for the BA11 box to slide in/out  and
rotate  for  service,  and  that  the rear cabinet door will
close with connectors inserted into the panel.



6.6.5  Site Management Guide -

Installation of DMR11(s) on a 2020 system  is  not  complete
until  the site management guide has been updated to reflect
the new hardware and software.

The following is recommended:

      o  General Information Page
         Add an item stating that unsupported DMR11 hardware
         is installed.

      o  Bus Layout/Configuration
         Add the new device(s) to the bus  in  their  proper
         locations.  Add the BR, CSR, and vector assignments
         both here and on the label on top of the BA11 box.

      o  System and Diagnostic Software
         Insert a copy of this  document,  and  the  console
         output   of   a  complete  successful  run  of  the
         diagnostics.    Include   the   location   of   the
         diagnostics.




7.0  DIAGNOSTICS

7.1  Availability

Diagnostics for the DMR11 are  available  to  Digital  Field
Service personnel from the DMR11 TOPS-10 developer.



7.2  Restrictions

The 2020 DMR11 diagnostics run in PDP-11 compatibility mode.
Certain  diagnostics  (noted  below) will incorrectly report
failures.
KSDMR.BWR - Beware file for KS DMR (non-)support      Page 8


7.3  Reference Documentation

Information on operation of the  DMR11  diagnostics  can  be
found  in the DMR11 Synchronous Controller Technical Manual,
and in the Maintenance Documentation Service microfiche set.



7.4  Operation

The DMR11 diagnostics are loaded from a TOPS-10 system  pack
by  MONBTS.   They  are  provided  as PDP-10 .EXE files, and
operate under a special version of DDT11.

Five diagnostics are provided.  These are:

      o  ZDMPB0 - M8207 Static Diagnostic #1

         This  diagnostic  is  equivalent  to   the   PDP-11
         diagnostic CZDMPB0.  It performs basic tests of the
         microprocessor, and should be the first  diagnostic
         run.

      o  ZDMQB0 - M8207 Static Diagnostic #2

         This  diagnostic  is  equivalent  to   the   PDP-11
         diagnostic  CZDMQB0.  It performs extended tests of
         the  microprocessor,  and  should  be  the   second
         diagnostic run.

         You should note that the normal position of the Run
         switch  (SW7  E28) is ON, while the default for the
         diagnostic's prompt is OFF.  Tests 9,  27,  and  42
         will   fail  if  the  run  switch  is  ON  and  the
         diagnostic is not told.

         Test 31 will usually fail even with a  good  M8207;
         it  is  dependent  on CPU timing, and a KS is not a
         PDP-11.  The expected error is "ERR 100 CLOCK  TIME
         TOO FAST".

         Test 32 will also fail;  the KS  does  not  support
         remote  load  detect.  The expected errors are "ERR
         17 FORCE POWER FAIL ERROR" and "ERR 35 FORCE  POWER
         FAIL ERROR".

      o  ZDMRD0 - M8203 Static Diagnostic #1

         This  diagnostic  is  equivalent  to   the   PDP-11
         diagnostic CZDMRD0.  It performs basic tests of the
         line unit.  It assumes that the  microprocessor  is
         in  working  order,  since it is dependent on it to
         access the M8203;  the M8203 is not accessible from
         the UNIBUS.
KSDMR.BWR - Beware file for KS DMR (non-)support      Page 9


         The microprocessor Run switch (SW7  E28)  can  also
         cause test failures if set incorrectly;  however in
         this case, the default is correct.

      o  ZDMSD0 - M8203 Static Diagnostic #2

         This  diagnostic  is  equivalent  to   the   PDP-11
         diagnostic  CZDMSD0.  It performs extended tests of
         the line unit.  It should be run after ZDMRD0  runs
         successfully.

         This diagnostic  is  most  useful  if  you  install
         turnaround  connectors  someplace;   the diagnostic
         allows for 4 places to put  them.   One  should  be
         suitable for your site.

         The diagnostics asks  for  the  contents  of  three
         M8203  registers  that  are  derrived  from  switch
         settings.  If you change the SW  P-table,  you  can
         get  test 11 to print them for you.  Of course, you
         still get to check that what it prints  corresponds
         to what you intended to set.

      o  ZDMIC0 - DMR11 Functional Tests

         This  diagnostic  is  equivalent  to   the   PDP-11
         diagnostic CZDMIC0.  It performs functional testing
         of the DMR11 subsystem, and should be run after the
         static diagnostics.

         Test 2 will print out the  revision  level  of  the
         DMR11 CROMs.

         Test 10 will generally fail even with a good DMR11.
         It  depends  on  CPU timing.  The expected error is
         "ERR 19 M8207 PROGRAM TIMER OUT OF RANGE".




7.5  Loading and Starting Diagnostics

The DMR11 diagnostics are started  in  the  same  way  as  a
monitor is.

Type Control/Backslash (\) to get the KS10> prompt.  Then BT
to  load  BOOT.   Type  DSKB:diagnostic[6,6]<CR> to load and
start DDT11.  When you get the "Input: " prompt,  enter  the
magic  string  "/UBA:3/LA36/PATCH/GO".   Typing  errors  may
cause alarming failures;  if they do, start over.  When  you
get  a  prompt  of  a  blank  line,  type 200<ESC>G to start
execution.  From this point on, the dialog is  the  same  as
that for the PDP-11 diagnostic.
KSDMR.BWR - Beware file for KS DMR (non-)support     Page 10


For  example,  the  following  shows  loading  and  starting
ZDMRD0:
        ^\
        KS10>BT
        KS10>USR MOD
        BOOT V1(4)

        BOOT>DSKB:ZDMRD0[6,6]
        [Loading from DSKB:ZDMRD0[6,6]]
        DDT11 5(55)-3

        Input:  /UBA:3/LA36/PATCH/GO

        200$G

           beginning execution @pc = 200

        DIAG. RUN-TIME SERVICES-D-0
        M8203 STATIC LOGIC TESTS - PART 1 OF 2
        INIT IS M8203
        50 HZ (L) N ?
        LSI (L) N ?
        DR>STA/PASS:1/FLAGS:PNT

        # UNITS (D) ? 1

        UNIT 0
        DEVICE CSR ADDRESS : (O) 164000 ?
        DEVICE VECTOR ADDRESS : (O) 610 ?
        DEVICE PRIORITY LEVEL : (O) 5 ?
        M8207 RUN SWITCH (E28 SW7) - TYPE 0 IF OFF, 1 IF
        ON : (O) 1 ? 1

        TST:001
        TST:002
                ...
        TST:042
        CZDMR EOP   1
                0 CUMULATIVE ERRORS
        DR>
KSDMR.BWR - Beware file for KS DMR (non-)support     Page 11


8.0  SOFTWARE INSTALLATION

8.1  Rebuild MONGEN

Building a monitor with DMR support requires that MONGEN  be
re-assembled with FTUNSUPPORTED turned on.



8.2  HDWGEN differences

When FTUNSUPPORTED is turned on,  the  dialogue  differs  in
many   places   from   the  docunentation  in  the  Software
Installation  Guide.   Only  the  DMR-specific  changes  are
discussed here.

Following the section on KDPs, a new section  on  DMR  lines
appears.

#  DMR11  Lines(0,0-8)[Number  of  DMR11  synchronous   line
controllers.]:
     Reply with the number of DMR11s installed in your 2020.
     If a DMR is not found at run time, a message is issued,
     but the system will function without it.

The following questions are repeated for  each  DMR  in  the
configuration:

 DMRn line type(ANF10,DECNET,USER,IBM):
     Reply with a one of the listed  keywords.   Your  reply
     indicates  which of the protocols listed is allowed use
     of this DMR.  USER allows you to OPEN the  DMRn  device
     and run your own protocol.  IBM has never been tried.

 DMRn switched line(Y,N)[
 Does DMRn control a switched (dial-up) line]:
     Reply "Y" or "N" as appropriate.   Switched  lines  are
     sensitive  to  DSR glitches.  Non-switched lines ignore
     them.  If you answer "N", the remaining  questions  are
     skipped, as they only apply to switched lines.

 DMRn half duplex(Y,N)[
 Does DMRn control a half duplex line]:
     Reply "Y" or "N" as appropriate.  "Y" causes the DMR to
     be  initialized in half-duplex mode.  This setting must
     be consistent at both ends of the  physical  link.   If
     you  answer  "N", the remaining question is skipped, as
     it only applies to half duplex lines.

 Is DMRn secondary(Y,N)[
 Exactly one end of the link should be a secondary station.
 Secondary status controls link startup only]:
     Half duplex DDCMP requires that  the  start  timers  on
     each  end  of  a  physical  link  differ  in  order  to
     guarantee that a  START  message  can  get  thru.   "Y"
KSDMR.BWR - Beware file for KS DMR (non-)support     Page 12


     causes  a  three second timer to be used.  "N" causes a
     one second timer to be used.  DMC11s use a  one  second
     timer.   The timer value must be DIFFERENT at the other
     end of the physical link.



8.3  Changing The Number Of Buffers Assigned

Each DMR is assigned static buffer  space  in  COMMON.   Two
variables  in  NETPRM.MAC  determine  how  many  buffers are
available to each DMR, and how much memory is allocated.  In
general, the defaults should be adequate.  But for satellite
links, for example, you may want to increase them.

DR%NBF is  the  number  of  buffers  assigned  to  each  DMR
channel.   Each DMR has two channels (transmit and receive),
so each DMR uses 2*DR%NBF buffers.  DMRPPL is the number  of
pages  to  be  allocated  per  DMR  line.   These  pages are
permanently allocated in COMMON, and are used as DMR scratch
and buffer space.  The exact formulae for allocation of this
space may be found in NETPRM  and  DMRSER  (D8RINT.MAC).   A
reasonable  rule  of  thumb for the current software is that
increasing DR%NBF by one costs about  700(8)  words  of  DMR
buffer space.

If increasing DR%NBF will make the maximum message size  too
small, DMRPPL should be increased as well.  For small values
of DR%NBF, there is a one  for  one  correspondence  between
increasing DR%NBF and DMRPPL.



8.4  Monitor Build

The  rest  of  the  monitor  assembly  and  build   proceeds
normally.  You should assemble D8RINT.MAC in some convenient
place (after the universal files) , and  include  D8RINT.REL
in the LINK command string someplace after MONBTS and before
TOPS10.REL.



8.5  Considerations For Half-Duplex ANF-10 Links

Half duplex links  will  work  with  no  further  effort  to
another  KS  system.   Use  of half duplex links to a PDP-11
based ANF node requires the following (unsupported) patch:

In your C.P11 file, add the following symbol definitions for
each half duplex DMC/DMR line:

KSDMR.BWR - Beware file for KS DMR (non-)support     Page 13


LnHDX=1         ;Makes the line half duplex


LnSEC=x         ;1 makes line "secondary" (3 sec timer)

"n" is the synchronous line number of the line you  want  to
change.  Half duplex will only work with DMC/DMR lines.
KSDMR.BWR - Beware file for KS DMR (non-)support     Page 14


File 1) BLKK:DNCDMC.P11[7,7023]         created: 1555 27-May-82
File 2) DSKP:DNCDMC.702[30,5742,TL]     created: 1540 13-Jul-82

1)5     DMCLB0: .WORD   0                       ;ADDRESS OF FIRST DMC-11 LINE
****
2)5             LSXHDX=B3                       ;LINE IS TO BE RUN IN HDX MODE
2)              LSXSEC=B4                       ;LINE IS A SECONDARY STATION
2)      DMCLB0: .WORD   0                       ;ADDRESS OF FIRST DMC-11 LINE
**************
1)11            BIT     #LSXMAI,LB.STX(J)       ;IF MAINT MODE,
1)              BNE     10$                     ; THE REST IS DONE DIFFERENTLY.
****
2)11            BIT     #LSXHDX,LB.STX(J)       ;WANT TO RUN HDX MODE?
2)              BEQ     5$                      ;NO, NORMAL (FDX) MODE
2)              BIS     #MC.HD,R2               ;YES, SET THE BIT
2)              BIT     #LSXSEC,LB.STX(J)       ;WANT TO USE LONG START TIMER?
2)              BEQ     5$                      ;NO, WE ARE MASTER STATION
2)              BIS     #MC.SEC,R2              ;YES, SET SECONDARY BIT
2)      5$:     BIT     #LSXMAI,LB.STX(J)       ;IF MAINT MODE,
2)              BNE     10$                     ; THE REST IS DONE DIFFERENTLY.
**************
KSDMR.BWR - Beware file for KS DMR (non-)support     Page 15


File 1) BLKK:DNLBLK.P11[7,7023]         created: 1558 27-May-82
File 2) DSKP:DNLBLK.702[30,5742,TL]     created: 1601 15-Jul-82

1)1             .WORD   0                                       ;LB.ST2
1)      .IF NE,LBTOT
****
2)1             .WORD   0                                       ;LB.STX
2)      .IF NE,LBTOT
**************
1)1     .ENDM   X
****
2)1     .IF DF LB.STX
2)          .IF GT DMCN
2)              .IIF NDF,L'Q'HDX,L'Q'HDX=0
2)              .IIF NE,L'Q'HDX,L'Q'HDX=1
2)              .IIF NDF,L'Q'SEC,L'Q'SEC=0
2)              .IIF NE,L'Q'SEC,L'Q'SEC=1
2)              .=.-<LB.SIZ-LB.STX>
2)              .WORD <L'Q'HDX*LSXHDX>+<L'Q'SEC*LSXSEC>
2)              .=<.-2>+<LB.SIZ-LB.STX>
2)          .ENDC
2)      .ENDC
2)      .ENDM   X
**************
KSDMR.BWR - Beware file for KS DMR (non-)support     Page 16


File 1) BLKK:DNDCMP.P11[7,7023]         created: 0856 07-Jul-82
File 2) DSKP:DNDCMP.702[30,5742,TL]     created: 1140 16-Jul-82

1)1             MOV     LB.SLA(J),R3            ;GET THE HARDWARE ACCESS ADDRESS FOR LINE
****
2)1     .IIF DF,LB.STX, CLR     LB.STX(J)       ;NOT DMC, DUPS WANT ST2 CLEAR
2)              MOV     LB.SLA(J),R3            ;GET THE HARDWARE ACCESS ADDRESS FOR LINE
**************
KSDMR.BWR - Beware file for KS DMR (non-)support     Page 17


File 1) BLKK:DNCNFG.P11[7,7023]         created: 0900 07-Jul-82
File 2) DSKP:DNCNFG.P11[30,5742,TL]     created: 1220 18-Jul-82

1)22    X       ZER,0   ;FIRST WORD TO ZERO ON A RESET
1)      .IF NE FTDUP11!DMCN     ;AN EXTRA STATUS WORD FOR THE DUP-11 AND DMC11
****
2)22    .IF NE FTDUP11!DMCN     ;AN EXTRA STATUS WORD FOR THE DUP-11 AND DMC11
**************
1)22    .IF NE,FTDUP11
****
2)22    X       ZER,0   ;FIRST WORD TO ZERO ON A RESET
2)      .IF NE,FTDUP11
**************
KSDMR.BWR - Beware file for KS DMR (non-)support     Page 18


9.0  REFERENCES

The following documents  may  be  consulted  for  additional
information:

      o  DMR11 Synchronous Controller Technical Manual
         Describes the detailed installation and programming
         of   the   DMR11   hardware.    DEC   order  number
         EK-DMR11-TM-002.

      o  M8203 Line Unit Technical Manual
         Describes the operation of the  line  unit  module.
         Appendix B contains the technical data for Integral
         Modem   (COAX)   cables.     DEC    order    number
         EK-M8203-TM-002.

      o  KS10-Based DECsystem-2020 Technical Manual
         Describes  the  operation  of  the  KS10.    Power,
         cabling,   and  Unibus  limitations  are  included.
         Also, IO programming and module  utilization.   DEC
         order number EK-0KS10-TM-002.

KSDMR.BWR - Beware file for KS DMR (non-)support     Page 19


10.0  PROGRAMMING THE DMR:  DEVICE

The DMR:  device is programmed in a manner  similar  to  the
KDP  and  DTE  devices.   Since  these  devices  may  not be
documented  elsewhere,  this  section   will   provide   the
information necessary to program the DMR:  device.


                          Caution

               The DMR:  device  is  provided
               primarily   for  DEC  in-house
               use.      The      information
               presented  in  this section is
               subject  to   change   without
               notice.



The DMR:  device is programmed like  any  ordinary  buffered
mode device, with the following exceptions/notes:



10.1  Dynamic DDBs

The  DMR:   device  does  not  have  a  pre-allocated   DDB.
Instead,  the  DDB is built at OPEN time.  Thus, a RESOURCES
command will not show its availibility.  DMR device  support
is  automatically  included  when  DMRs  are  included  in a
MONGEN.



10.2  OPEN and the DMR:  device

There  is  one  DMR:   device  (DMRn:)  available  for  each
physical  DMR  built into the monitor.  A DMR:  DDB can only
be built by an OPEN UUO from a job which has POKE  (JP.POK),
JACCT,  or  [1,2]  privileges.   FILOP., and random commands
will return "no such device", as  will  OPEN  UUOs  from  an
unprivileged job.



10.3  Buffer Size

The DMR:  device will  allow  you  to  use  variable  length
buffers.   The default buffer size is constant for any given
monitor load,  but  varies  as  a  function  of  the  NETPRM
parameters DMRPPL and DR%NBF.  Thus, you should not count on
the default buffer size in any program, unless you obtain it
from a DEVSIZ UUO.
KSDMR.BWR - Beware file for KS DMR (non-)support     Page 20


10.4  IO Modes

Only byte mode (IO.BYT) is  allowed  to  the  DMR:   device.
Byte  mode  has a default byte size of 8 bits.  Asynchronous
IO (UU.AIO set in the OPEN block) is  supported.   The  DMR:
device  supports simultaneous input and output;  no implicit
WAIT UUOs are done by the monitor  which  would  force  half
duplex operation.



10.5  Software Interrupts

The usual software interrupts for asynchronous IO  work  for
the  DMR:   device;   Input  Done, Output Done, Input Error,
Output Error.

When DDCMP  prototocol  comes  up  on  a  line,  an  ON-LINE
interrupt  is  generated.  When DDCMP goes down, an OFF-LINE
interrupt is generated.



10.6  File Status Bits

The following File Status (GETSTS) bits are defined for  the
DMR:  device:



10.6.1  IO.IMP - Set if you attempt to use  a  DMR  that  is
assigned to another protocol (DECnet, ANF10, IBMcomm).  Also
set if a maintenance message is received while normal  DDCMP
is running.



10.6.2  IO.DTE - Set if  you  attempt  IO  to  a  line  that
doesn't  have  DDCMP  running  yet.  (Normal mode only) This
error can occur in any mode if a switched line  hasn't  been
connected  yet.   In  any  case, IO.DTE is a soft error, and
should be retried after a suitable delay.



10.6.3  IO.DER - Set if protocol on the line is (went) down.
Cleared when protocol starts.  Set when protocol goes down.
KSDMR.BWR - Beware file for KS DMR (non-)support     Page 21


10.6.4  IO.BKT - Set if a message is received or transmitted
that  exceeds  the maximum message size allowed.  A received
message that is too large causes the DMR to  shut  down  the
line.



10.6.5  IO.MAI - If set, indicates that the line is  to  run
in  DDCMP  maintenance  mode.   If clear, indicates that the
line is to run in DDCMP normal mode.



10.6.6  IO.SRM (1B28) - Not currently set  by  the  monitor.
If  set,  means  that  a DDCMP START was received by the DMR
while in  maintenance  mode.   This  condition  can  not  be
dectected  by the DMR11.  But if set, this bit is treated as
an error condition.



10.6.7  IO.MRN (1B29) - Not currently set  by  the  monitor.
If  set,  means that a DDCMP MOP message was received by the
DMR while in normal  mode.   Currently,  this  condition  is
reported  by  IO.IMP.  But if set, this bit is treated as an
error condition.



10.7  Errors

Error bits are not cleared automatically by the monitor.  If
any  error  bit  is set, the monitor will refuse to initiate
further IO.  You can clear any of the error bits via OPEN or
SETSTS.