home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / hacking / systems / release.not < prev    next >
Encoding:
Text File  |  2003-06-11  |  101.0 KB  |  3,313 lines
  1.  
  2.  
  3.  
  4.                                    CONTENTS
  5.  
  6.  
  7.  
  8. CHAPTER 1       CHANGES BETWEEN V1.0 AND V1.1
  9.  
  10.         1.1     DECnet-DOS and DECnet-Rainbow NFT  . . . . . . . . 1-1
  11.         1.2     DECnet-DOS and DECnet-Rainbow SETHOST  . . . . . . 1-2
  12.         1.3     DECnet-DOS and DECnet-Rainbow NDU  . . . . . . . . 1-2
  13.         1.4     DECnet-DOS and DECnet-Rainbow NTU  . . . . . . . . 1-3
  14.         1.5     DECnet-DOS and DECnet-Rainbow TFA  . . . . . . . . 1-3
  15.         1.6     DECnet-DOS and DECnet-Rainbow TTT  . . . . . . . . 1-3
  16.         1.7     DECnet-DOS and DECnet-Rainbow TNTERR . . . . . . . 1-3
  17.         1.8     DECnet-DOS and DECnet-Rainbow DTR/DTS  . . . . . . 1-4
  18.         1.9     DECnet-DOS and DECnet-Rainbow SPAWNER  . . . . . . 1-4
  19.         1.10    DECnet-DOS and DECnet-Rainbow MAIL . . . . . . . . 1-4
  20.         1.11    DECnet-DOS and DECnet-Rainbow FAL  . . . . . . . . 1-4
  21.         1.12    DECnet-DOS and DECnet-Rainbow DIP  . . . . . . . . 1-5
  22.         1.13    Revisions to the DECnet-DOS Programmer's Reference 
  23.                 Manual . . . . . . . . . . . . . . . . . . . . . . 1-5
  24.         1.14    DECnet-DOS and DECnet-Rainbow Programming 
  25.                 Interface  . . . . . . . . . . . . . . . . . . . . 1-9
  26.  
  27.  
  28. CHAPTER 2       SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  29.  
  30.         2.1     Asynchronous Installation Problems . . . . . . . . 2-1
  31.         2.2     Asynchronous Performance and Tuning  . . . . . . . 2-6
  32.         2.3     Asynchronous Configuration Problems  . . . . . . . 2-7
  33.         2.4     Ethernet Performance and Tuning  . . . . . . . . . 2-8
  34.         2.5     Ethernet Configuration Problems  . . . . . . . .  2-10
  35.         2.6     General Problems . . . . . . . . . . . . . . . .  2-10
  36.         2.6.1     Problems with Rainbow Only . . . . . . . . . .  2-13
  37.         2.6.2     Problems with IBM PCs Only . . . . . . . . . .  2-13
  38.         2.7     NFT - Network File Transfer  . . . . . . . . . .  2-14
  39.         2.8     Error Messages and Warnings  . . . . . . . . . .  2-15
  40.         2.8.1     Error Messages . . . . . . . . . . . . . . . .  2-15
  41.         2.8.2     Warnings . . . . . . . . . . . . . . . . . . .  2-17
  42.         2.9     SETHOST  . . . . . . . . . . . . . . . . . . . .  2-18
  43.         2.9.1     CTERM ONLY . . . . . . . . . . . . . . . . . .  2-18
  44.         2.9.2     LAT ONLY . . . . . . . . . . . . . . . . . . .  2-19
  45.         2.10    NDU - Network Device Utility . . . . . . . . . .  2-21
  46.         2.10.1    NPDRV - Virtual Printer Driver . . . . . . . .  2-21
  47.         2.10.2    NDDRV - Virtual Disk Driver  . . . . . . . . .  2-22
  48.         2.11    NCP - Network Control Program  . . . . . . . . .  2-22
  49.         2.12    NTU - Network Test Utility . . . . . . . . . . .  2-24
  50.         2.13    TFA - Transparent File Access  . . . . . . . . .  2-25
  51.         2.14    TTT - Transparent Task-to-Task . . . . . . . . .  2-25
  52.         2.15    DTR/DTS  . . . . . . . . . . . . . . . . . . . .  2-25
  53.         2.16    MAIL . . . . . . . . . . . . . . . . . . . . . .  2-25
  54.         2.17    FAL (File Access Listener) . . . . . . . . . . .  2-26
  55.         2.18    DIP - DECnet-DOS Installation Procedure  . . . .  2-28
  56.  
  57.  
  58.                                   1
  59.  
  60.  
  61.  
  62.         2.19    C Programming Library  . . . . . . . . . . . . .  2-29
  63.  
  64.  
  65. CHAPTER 3       MODEM CONTROL
  66.  
  67.         3.1     Using Modem Control  . . . . . . . . . . . . . . . 3-1
  68.         3.2     Modem States . . . . . . . . . . . . . . . . . . . 3-2
  69.         3.2.1     General  . . . . . . . . . . . . . . . . . . . . 3-5
  70.         3.2.2     State 1  . . . . . . . . . . . . . . . . . . . . 3-5
  71.         3.2.3     State 2  . . . . . . . . . . . . . . . . . . . . 3-5
  72.         3.2.4     State 3  . . . . . . . . . . . . . . . . . . . . 3-5
  73.         3.2.5     State 4  . . . . . . . . . . . . . . . . . . . . 3-6
  74.         3.2.6     State 5  . . . . . . . . . . . . . . . . . . . . 3-6
  75.         3.2.7     State 6  . . . . . . . . . . . . . . . . . . . . 3-6
  76.         3.2.8     State 7  . . . . . . . . . . . . . . . . . . . . 3-6
  77.         3.3     Interface Requirements . . . . . . . . . . . . . . 3-8
  78.         3.4     Modem Option Selections  . . . . . . . . . . . .  3-10
  79.  
  80.  
  81. CHAPTER 4       REPORTING PROBLEMS
  82.  
  83.  
  84. FIGURES
  85.  
  86.         3-1     Modem States . . . . . . . . . . . . . . . . . . . 3-4
  87.         3-2     Minimum Implementation of V.24 Circuits for Full 
  88.                 Duplex Modem Control . . . . . . . . . . . . . . . 3-7
  89.  
  90.  
  91. TABLES
  92.  
  93.         1-1     Extended Error Messages - Unable to Make a 
  94.                 Connection . . . . . . . . . . . . . . . . . . . . 1-6
  95.         1-2     Extended Error Messages - Disconnecting a Logical 
  96.                 Link . . . . . . . . . . . . . . . . . . . . . . . 1-8
  97.         3-1     Asynchronous Mode, Direct Connection . . . . . . . 3-8
  98.         3-2     Asynchronous Mode, Modem Connection  . . . . . . . 3-9
  99.         3-3     User-selectable Modem Options  . . . . . . . . .  3-10
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.                                   2
  117.  
  118.  
  119.  
  120. Preface
  121.  
  122.  
  123. The following release notes include updated information for DECnet-DOS
  124. V1.1   and  DECnet-Rainbow  V1.1.   You  should  use  these  notes  in
  125. conjunction  with   the   material   presented   in   the   DECnet-DOS
  126. documentation set.
  127.  
  128.  
  129. Intended Audience
  130.  
  131.  
  132. These release notes are intended for users of the  Rainbow  series  of
  133. personal  computers  and  for  users of the IBM PC, IBM PC/XT, and IBM
  134. Personal Computer AT.  Some  of  the  information  presented  in  this
  135. document  is  very  technical.  If you do not understand the material,
  136. you should seek assistance from the  person  who  is  responsible  for
  137. configuring your network.
  138.  
  139.  
  140. ALL-IN-1 is a trademark of Digital Equipment Corporation.
  141.  
  142. IBM is a  registered  trademark  of  International  Business  Machines
  143. Corporation.
  144.  
  145. IBM  PC/XT  is  a  trademark  of   International   Business   Machines
  146. Corporation.
  147.  
  148. IBM Personal Computer AT is  a  trademark  of  International  Business
  149. Machines Corporation.
  150.  
  151. MS is a trademark of Microsoft Corporation.
  152.  
  153. Symphony is a trademark of Lotus Development Corporation.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                                   3
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.                               CHAPTER 1
  188.  
  189.                     CHANGES BETWEEN V1.0 AND V1.1
  190.  
  191.  
  192.  
  193.  
  194. This chapter describes the software changes made from  DECnet-DOS  and
  195. DECnet-Rainbow  Version  1.0  to DECnet-DOS and DECnet-Rainbow Version
  196. 1.1.
  197.  
  198. For DECnet-DOS only, DECnet-DOS V1.1 adds  support  for  IBM  Personal
  199. Computer ATs, support for PC-DOS V3.1, and Ethernet support.
  200.  
  201. In Version 1.0, the background network task was installed as an MS-DOS
  202. device driver.  In Version 1.1, a number of tasks cooperate to provide
  203. background network processing.  All of these tasks are  terminate  and
  204. stay resident tasks, not device drivers.  They include:  the interrupt
  205. Scheduler (SCH); the Ethernet Data Link Layer (DLL); the LAT  protocol
  206. handler  (LAT);  and  the DECnet Network Process (DNP).  Note that DLL
  207. and LAT apply to DECnet-DOS only.
  208.  
  209. The processes communicate using software interrupts.   The  interrupts
  210.                                                             __________
  211. used  by  each  process  are  listed  in an appendix to the DECnet-DOS
  212. ____________ _________ ______
  213. Programmer's Reference Manual.
  214.  
  215. The  following  sections  describe  changes  to  the  DECnet-DOS   and
  216. DECnet-Rainbow utilities.
  217.  
  218.  
  219.  
  220. 1.1  DECnet-DOS and DECnet-Rainbow NFT
  221.  
  222.  
  223.  
  224.       o  NFT now provides the PRINT and SUBMIT  commands  which  queue
  225.          remote  files  at  the  remote  node,  and /PRINT and /SUBMIT
  226.          switches which can be used with  the  COPY  command  to  copy
  227.          local files to remote nodes to be queued at the remote node.
  228.  
  229.       o  The /FULL switch for the DIRECTORY command now provides a VMS
  230.          style full directory listing for remote files.
  231.  
  232.  
  233.  
  234.                                  1-1
  235.                     CHANGES BETWEEN V1.0 AND V1.1
  236.  
  237.  
  238.       o  NFT will now allow you to copy remote files directly  to  the
  239.          local printer, for example:
  240.  
  241.          NFT COPY REMOTE::FOO.BAR PRN
  242.          or
  243.          NFT COPY REMOTE::FOO.BAR PRN:
  244.  
  245.  
  246.       o  NFT can now do block  mode  file  copies.   Block  mode  file
  247.          copying  is  an image mode file transfer which moves the data
  248.          in 512 byte units independent of any record  characteristics.
  249.          The  end  of  file  byte position is properly retained.  This
  250.          file copy mode may be necessary to copy files with very  long
  251.          records.   To  use block mode when copying, specify /BLOCK as
  252.          the only switch.
  253.  
  254.       o  The date  and  time  of  creation  of  copied  files  is  now
  255.          preserved.
  256.  
  257.  
  258.  
  259.  
  260. 1.2  DECnet-DOS and DECnet-Rainbow SETHOST
  261.  
  262.  
  263.       o  SETHOST now allows you the ability to interrupt a session  to
  264.          perform  some  local task and then continue the session where
  265.          you left off.  Multiple interrupted  sessions  are  supported
  266.          (CTERM  connections  only).   Local  tasks include any MS-DOS
  267.          command or sequence of commands, starting or stopping logging
  268.          of the terminal session, and getting help.
  269.  
  270.       o  SETHOST now provides VMS style command line editing.
  271.  
  272.       o  SETHOST provides on-line help.
  273.  
  274.       o  LAT  support   is   now   provided   by   SETHOST   (Ethernet
  275.          configurations  only).   When  SETHOST attempts to connect to
  276.          the remote node it first attempts to use  LAT  protocol.   If
  277.          that fails, SETHOST attempts a CTERM connection.  There is no
  278.          multiple session LAT support.
  279.  
  280.  
  281.  
  282.  
  283. 1.3  DECnet-DOS and DECnet-Rainbow NDU
  284.  
  285.  
  286.       o  NDU can now CREATE virtual disk volumes in 4 different sizes,
  287.          1.2, 10, 20, and 32 MB.
  288.  
  289.  
  290.  
  291.  
  292.                                  1-2
  293.                     CHANGES BETWEEN V1.0 AND V1.1
  294.  
  295.  
  296. 1.4  DECnet-DOS and DECnet-Rainbow NTU
  297.  
  298.  
  299.       o  The SET RECORDING command is no longer available.  Use the TO
  300.          file option instead.
  301.  
  302.       o  LOOP command syntax has been changed to  be  more  consistent
  303.          with  other  DECnet  implementations.   The LOOP commands are
  304.          now:  LOOP EXECUTOR, LOOP CIRCUIT, LOOP NODE, and  LOOP  LINE
  305.          CONTROLLER.
  306.  
  307.  
  308.  
  309.  
  310. 1.5  DECnet-DOS and DECnet-Rainbow TFA
  311.  
  312.  
  313.       o  TFA now has on-line help.
  314.  
  315.       o  TFA can now be unloaded after use to  make  memory  available
  316.          for other tasks.  TNT unloads TFA.
  317.  
  318.  
  319.  
  320.  
  321. 1.6  DECnet-DOS and DECnet-Rainbow TTT
  322.  
  323.  
  324.       o  TTT now has on-line help.
  325.  
  326.       o  TTT can now be unloaded after use to  make  memory  available
  327.          for other tasks.  TNT unloads TTT.
  328.  
  329.  
  330.  
  331.  
  332. 1.7  DECnet-DOS and DECnet-Rainbow TNTERR
  333.  
  334.  
  335.       o  TNTERRs name has been changed to TNT.
  336.  
  337.       o  TNT provides on-line help.
  338.  
  339.       o  TNT can unload TTT or TFA from memory.
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.                                  1-3
  351.                     CHANGES BETWEEN V1.0 AND V1.1
  352.  
  353.  
  354. 1.8  DECnet-DOS and DECnet-Rainbow DTR/DTS
  355.  
  356.  
  357.       o  DTR now has on-line help.
  358.  
  359.  
  360.  
  361.  
  362. 1.9  DECnet-DOS and DECnet-Rainbow SPAWNER
  363.  
  364.  
  365.       o  The DECnet Job Spawner is a new utility with DECnet-DOS V1.1.
  366.          The  job  spawner  runs  as  a  foreground  task  waiting for
  367.          incoming connections.  When a connection arrives, the spawner
  368.          looks  up the requested object name or number in its database
  369.          and runs the program which services  that  type  of  request.
  370.          When  the  program  finishes,  the  spawner  again  waits for
  371.          incoming connections.  The spawner  supports  FAL,  DTR,  and
  372.          user-written servers.
  373.  
  374.  
  375.  
  376.  
  377. 1.10  DECnet-DOS and DECnet-Rainbow MAIL
  378.  
  379.  
  380.       o  MAIL is a new utility  with  V1.1.   MAIL  provides  you  the
  381.          ability  to  transmit  messages  or files to other non MS-DOS
  382.          nodes in your network.  MAIL does not allow  you  to  receive
  383.          mail directly at your personal computer node.
  384.  
  385.  
  386.  
  387.  
  388. 1.11  DECnet-DOS and DECnet-Rainbow FAL
  389.  
  390.  
  391.       o  The File Access Listener (FAL) allows  other  nodes  in  your
  392.          network access to files local to your personal computer node.
  393.          Access is password controlled.  FAL can be run with  the  Job
  394.          Spawner.
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.                                  1-4
  409.                     CHANGES BETWEEN V1.0 AND V1.1
  410.  
  411.  
  412. 1.12  DECnet-DOS and DECnet-Rainbow DIP
  413.  
  414.  
  415.       o  DECnet-DOS and DECnet-Rainbow can now be completely installed
  416.          by  running  the  DECnet  Installation  Procedure  (DIP)  and
  417.          answering a few simple questions.  Refer to  the  appropriate
  418.          installation guide for instructions.
  419.  
  420.  
  421.  
  422.  
  423.                        __________ ____________ _________ ______
  424. 1.13  Revisions to the DECnet-DOS Programmer's Reference Manual
  425.  
  426.  
  427. The following tables are revised Versions of Table D-1 and Table  D-2,
  428. which  are  in  Appendix  D ("SUMMARY OF EXTENDED ERROR CODES") of the
  429. __________ ____________ _________ ______
  430. DECnet-DOS Programmer's Reference Manual.
  431.  
  432. DECnet-DOS  supports  extended  error  support   to   certain   socket
  433.                                                             __________
  434. operations.   When  you  write  a  program  which  uses the getsockopt
  435.                                                         __________
  436. function call, extended error codes can be returned in  opt_status,  a
  437.                   __________
  438. data  member  of  optdata_dn.   This  can occur following an attempted
  439. connection request or after disconnecting a logical link.
  440.  
  441. Table 1-1 lists extended error codes which can be  returned  following
  442. an  attempted  connection.   It  lists  the  error  messages  found in
  443. ________
  444. derrno.h, the decimal value for each message, their  equivalent  error
  445.              _________            _____
  446. message that dnet_conn returns in errno, and the error reason.
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.                                  1-5
  474.                     CHANGES BETWEEN V1.0 AND V1.1
  475.  
  476.  
  477. Table 1-1:  Extended Error Messages - Unable to Make a Connection
  478.  
  479. Decimal     derrno.h               dnet_conn              
  480.                                                           
  481. Error Code  Mnemonic               In errno               Reason
  482.  
  483.  0          EREJBYOBJ              ECONNREFUSED           Connect failed.
  484.                                                           Connection
  485.                                                           rejected by object.
  486.  
  487.  1          EINSSNETRES            ENOSPC                 Connect failed.
  488.                                                           Insufficient network
  489.                                                           resources.
  490.  
  491.  2          EUNRNODNAM             EADDRNOTAVAIL          Connect failed.
  492.                                                           Unrecognized
  493.                                                           node name.
  494.  
  495.  3          EREMNODESHUT           ENETDOWN               Connect failed.
  496.                                                           Remote node
  497.                                                           shutting down.
  498.  
  499.  4          EUNROBJ                ESRCH                  Connect failed.
  500.                                                           Unrecognized object.
  501.  
  502.  5          EINVOBJNAM             EINVAL                 Connect failed.
  503.                                                           Invalid object
  504.                                                           name format.
  505.  
  506.  6          EOBJBUSY               ETOOMANYREFS           Connect failed.
  507.                                                           Object too busy.
  508.  
  509. 10          EINVNODNAM             ENAMETOOLONG           Connect failed.
  510.                                                           Invalid node
  511.                                                           name format.
  512.  
  513. 11          ELOCNODESHUT           EHOSTDOWN              Connect failed.
  514.                                                           Local node
  515.                                                           shutting down.
  516.  
  517. 32          ENODERESOURCES         ENOSPC                 Connect failed. No
  518.                                                           node resources for
  519.                                                           new logical link.
  520.  
  521. 33          EUSERESOURCES          ENOSPC                 Connect failed. No
  522.                                                           user resources for
  523.                                                           new logical link.
  524.  
  525. 34          EACCONREJ              ECONNABORTED           Connect failed.
  526.                                                           Access control
  527.                                                           rejected.
  528.  
  529.  
  530.  
  531.                                  1-6
  532.                     CHANGES BETWEEN V1.0 AND V1.1
  533.  
  534.  
  535. Decimal     derrno.h               dnet_conn              
  536.                                                           
  537. Error Code  Mnemonic               In errno               Reason
  538.  
  539. 36          EBADACCOUNT            ECONNABORTED           Connect failed.
  540.                                                           Bad account
  541.                                                           information.
  542.  
  543. 38          ENORESPOBJ             ETIMEDOUT              Connect failed.
  544.                                                           No response
  545.                                                           from object.
  546.  
  547. 39          ENODUNREACH            ENETUNREACH            Connect failed.
  548.                                                           Node unreachable.
  549.  
  550. 43          ECONNTOOBIG            ECONNABORTED           Connect failed.
  551.                                                           Connect image
  552.                                                           data field too
  553.                                                           long.
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.                                  1-7
  590.                     CHANGES BETWEEN V1.0 AND V1.1
  591.  
  592.  
  593. Table 1-2 lists extended error codes which can be returned following a
  594.                                                          ________
  595. disconnection.   It  lists  the  error messages found in derrno.h, the
  596. decimal value for each message, and the error reason.
  597.  
  598.  
  599.  
  600. Table 1-2:  Extended Error Messages - Disconnecting a Logical Link
  601.  
  602. Decimal      derrno.h                
  603.                                      
  604. Error Code   Mnemonic                Reason
  605.  
  606.  0           EREJBYOBJ               The   remote   node   end   user
  607.                                      disconnected a  running  logical
  608.                                      link.
  609.  
  610.  8           EABTBYNMGT              The     logical     link     was
  611.                                      disconnected by a third party.
  612.  
  613.  9           EUSERABORT              The remote end user has  aborted
  614.                                      the link.
  615.  
  616. 38           ENORESPOBJ              The  end  user  or  node  at the
  617.                                      other  end  of  the   link   has
  618.                                      crashed or failed.
  619.  
  620. 39           ENODUNREACH             The connection has been lost due
  621.                                      to a local timeout.
  622.  
  623. 41           ENOLINK                 The connection has been lost due
  624.                                      to a protocol failure,  no  such
  625.                                      link found at remote.
  626.  
  627. 42           ECOMPLETE               No    error.    A    local   end
  628.                                      user-initiated   disconnect  has
  629.                                      completed.
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.                                  1-8
  649.                     CHANGES BETWEEN V1.0 AND V1.1
  650.  
  651.  
  652. 1.14  DECnet-DOS and DECnet-Rainbow Programming Interface
  653.  
  654.  
  655.       o  The assembler language interface to the  network  process  in
  656.          Version  1.0 was software interrupt 2A (hex).  In Version 1.1
  657.          the interface to the network process is software interrupt 6E
  658.          (hex).  The 2A interface has been retained for compatibility,
  659.          but may be removed in a future release.
  660.  
  661.       o  A new technique for doing I/O which does not block  is  being
  662.          provided  in Version 1.1, asynchronous I/O.  Asynchronous I/O
  663.          provides a call back  mechanism  to  notify  the  application
  664.          program  that  a request has been completed.  Please refer to
  665.               __________  ____________  _________  ______
  666.          the  DECnet-DOS  Programmer's  Reference  Manual   for   more
  667.          information.
  668.  
  669.       o  SCBDEF.H
  670.  
  671.          The  symbol   definition   SCBS_SETOSTAT   was   changed   to
  672.          SCBS_GETOSTAT.
  673.  
  674.       o  DN.H
  675.  
  676.          The following definitions for DECnet software components were
  677.          added:
  678.  
  679.          /*
  680.           * Define DECnet modules as TLA (three letter acronym) strings.
  681.           */
  682.          #define DNMOD_LAT     "LAT"  /* LAT driver */
  683.          #define DNMOD_PDV     "PDV"  /* Port driver */
  684.          #define DNMOD_SCH     "SCH"  /* Real-time Scheduler */
  685.          #define DNMOD_DLL     "DLL"  /* Data Link Layer */
  686.          #define DNMOD_DNP     "DNP"  /* DECnet Network Process */
  687.  
  688.          /*
  689.           * Define DECnet software module interrupt vectors.
  690.           */
  691.          #define DNMODULE_LAT   0x6a    /* LAT driver */
  692.          #define DNMODULE_PDV   0x6b    /* Port driver */
  693.          #define DNMODULE_SCH   0x6c    /* Real-time Scheduler */
  694.          #define DNMODULE_DLL   0x6d    /* Data Link Layer */
  695.          #define DNMODULE_DNP   0x6e    /* DECnet Network Process */
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.                                  1-9
  708.                     CHANGES BETWEEN V1.0 AND V1.1
  709.  
  710.  
  711.       o  DERRNO.H
  712.  
  713.          The following symbol definitions were added (note that  these
  714.          are not supported by DECnet-ULTRIX V1.1):
  715.  
  716.          EUSERABORT      9   - Disconnect: Abort by user
  717.          ENODERESOURCES  32  - Connect: No node resources for new logical link
  718.          EUSERESOURCES   33  - Connect: No user resources for new logical link
  719.          EBADACCOUNT     36  - Connect: Bad account information
  720.          ENOLINK         41  - Disconnect: Protocol failure, no such link
  721.          ECOMPLETE       42  - Disconnect: No error, disconnect completed
  722.          ECONNTOOBIG     43  - Connect: Connect image data field too long
  723.  
  724.       o  NERROR.C
  725.  
  726.          Error text for additional DECnet connect  errors  was  added.
  727.          (see new definitions in DERRNO.H)
  728.  
  729.          The array of character strings, *dnet_errlist[], has changed.
  730.          The  text,  "Connect  failed,  ", which was repeated in every
  731.          string, has been removed and placed  in  a  single,  separate
  732.          character  string,  'connect_error[]'.   If your code indexed
  733.          directly into this global array of strings, you must  account
  734.          for  the  "Connect  failed,  " string in your display code or
  735.          else  use  the  connect_error[]  string.   If  you  used  the
  736.          function  'nerror()', this change will be transparent to your
  737.          program.
  738.  
  739.       o  DNET_CONN.C
  740.  
  741.          A 'signal()' function was added for support  of  non-blocking
  742.          connects.   If a 'signal()' function is not supported by your
  743.          C compiler, comment out all references to 'signal' in this  C
  744.          source file before compilation.
  745.  
  746.                            __________  ____________  _________  ______
  747.          Appendix C of the DECnet-DOS  Programmer's  Reference  Manual
  748.          should include the following entry:
  749.  
  750.          EINTR   4    Interrupted system call.
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.                                  1-10
  767.                     CHANGES BETWEEN V1.0 AND V1.1
  768.  
  769.  
  770.          Automatic outgoing proxy support was added.  This was done by
  771.          issuing  a  'bind()'  call  to  the  client  socket under the
  772.          following conditions:
  773.  
  774.          1.  No  access  control  information  passed  in  the  'node'
  775.              argument to 'dnet_conn()'.
  776.  
  777.          2.  No default access control information found in the  local
  778.              node's node database for the remote node specified in the
  779.              'node' argument to 'dnet_conn()'.
  780.  
  781.          3.  A user name has been set up for local node in  the  local
  782.              node's database.
  783.  
  784.  
  785.       o  The internal function  'dnet_errconvert()'  was  modified  to
  786.          reflect  changes  made  in  DECnet  connect  errors  (see new
  787.          definitions in DERRNO.H) This function  maps  DECnet  connect
  788.          errors to their equivalent 'errno' system error codes so that
  789.          connect  error  returns  from  'dnet_conn()'  will  have  the
  790.          correct  errno  system  error  code in 'errno' for use by the
  791.          function 'nerror()'.
  792.  
  793.       o  DNMSDOS.H
  794.  
  795.          ____________
  796.          localinfo_dn  was  revised  to  support  the  complete   path
  797.          specification  for  the  DECnet database path by adding a new
  798.          member to the data structure:
  799.  
  800.          1.  The complete database path specification is contained  in
  801.              _______________
  802.              lcl_decnet_path.
  803.  
  804.              _________________
  805.          2.  lcl_decnet_device  is  still  supported   for   backwards
  806.              compatibility.
  807.  
  808.          3.  See the file for more details on the structure format.
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.                                  1-11
  828.                     CHANGES BETWEEN V1.0 AND V1.1
  829.  
  830.  
  831.       o  DNET_PATH.C
  832.  
  833.          _________
  834.          dnet_path now supports getting the complete  DECnet  database
  835.          path  specification.   Note that the function's interface has
  836.          not changed.
  837.  
  838.       o  IOCB.H
  839.  
  840.          A  new  data  structure,  CIOCB,  was  added  which  supports
  841.          ASYNCHRONOUS NETWORK I/O.  This structure is identical to the
  842.          IOCB   structure   except   for   one   additional    member,
  843.          'io_callback'.    See  the  file  for  more  details  on  the
  844.          structure's format.
  845.  
  846.       o  TIME.H
  847.  
  848.          Three new external definitions were added:
  849.  
  850.          int daylight;
  851.          long timezone;
  852.          char *tzname[2];
  853.  
  854.          It is  ASSUMED  that  these  are  defined  by  the  user's  C
  855.          compiler.   If  not  used,  comment  them  out of header file
  856.          before compilation(s); otherwise, if not defined, then define
  857.          them in applications programs.
  858.  
  859.       o  SOCKET.H
  860.  
  861.          New flag definitions for the CIOCB / IOCB  'io_flags'  member
  862.          were added:
  863.  
  864.          #define MSG_ASYNC         0x8    /* perform function asynchronously */
  865.          #define MSG_CALLBACK      0x10   /* perform callback */
  866.          #define MSG_NEOM          0x20   /* do not perform end of message */
  867.          #define MSG_NBOM          0x40   /* do not set beginning of message */
  868.  
  869.          New address family definitions were added:
  870.  
  871.          #define AF_SES                6
  872.          #define AF_MAX                6
  873.  
  874.  
  875.       o  BEGIN.H & FINISH.H
  876.  
  877.          Segment names were changed in this file.
  878.  
  879.       o  SIZE.H
  880.  
  881.          SIZE.H is NOT necessary for V1.1 assemblies.
  882.  
  883.  
  884.  
  885.  
  886.                                  1-12
  887.                     CHANGES BETWEEN V1.0 AND V1.1
  888.  
  889.  
  890.       o  DNETDB.H
  891.  
  892.          The use of the flags byte in  the  structure,  'dnet_nodeent'
  893.          has  been  modified.   It  is  now interpreted as a bit field
  894.          flags byte.  The new flag symbols are:
  895.  
  896.          /*
  897.           * dnet_nodeent.dne_delflag - flags
  898.           */
  899.          #define DNET_NODE_DEL   0x2      /* deleted entry          */
  900.          #define DNET_NODE_CRY   0x4      /* encrypted entry        */
  901.          #define DNET_NODE_LAT   0x8      /* LAT preferred host     */
  902.  
  903.          A new data structure has been added,  'dnet_accent'.   It  is
  904.          the  incoming  access control information entry.  It uses the
  905.          new database file DECACC.DAT.
  906.  
  907.       o  PRGPRE.H
  908.  
  909.          The list of header files was modified.
  910.  
  911.       o  ERRNO.H
  912.  
  913.          New symbol definition for ASYNCHRONOUS NETWORK I/O errors was
  914.          added:  Check CIOCB 'io_status' field for this value.
  915.  
  916.          #define NOTHING -2     /* request not complete - asynch i/o */
  917.  
  918.       o  TYPES.H
  919.  
  920.          More type definitions were added:
  921.  
  922.          /*
  923.           * Defines types used in defining values returned by system level
  924.           *  calls for file status and time information.
  925.           */
  926.          typedef unsigned short ino_t;    /* i-node number (not used on DOS) */
  927.          typedef long time_t;             /* time value */
  928.          typedef short dev_t;             /* device code */
  929.          typedef long off_t;              /* file offset value */
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.                                  1-13
  945.                     CHANGES BETWEEN V1.0 AND V1.1
  946.  
  947.  
  948.       o  New function dnet_installed():
  949.  
  950.          This is a C library function found in source file DNETINST.C.
  951.          It   performs   installation  checking  of  various  software
  952.          components.  See file DN.H for component symbol definitions.
  953.  
  954.       o  New function dnet_getacc():
  955.  
  956.          This is a C library function found in source file DNETACCE.C.
  957.          It fetches incoming access control information.
  958.  
  959.       o  New function csreg():
  960.  
  961.          This is an assembly function found in source file  CSREG.ASM.
  962.          It  returns  the current CS (code segment) register value and
  963.          works with the 2 segment model only.
  964.  
  965.       o  New function dnetses():
  966.  
  967.          This  is  an  assembly  function   found   in   source   file
  968.          DNETSES.ASM.   It  currently  returns  an  incorrect  Version
  969.          number of 0.0 if SESSION is installed.
  970.  
  971.       o  New function fbcopy().
  972.  
  973.          This is an assembly function found in source file FBCOPY.ASM.
  974.          It  performs  a  FAR  byte  copy.   It  does  not  check  for
  975.          source/destination buffer overlap conditions.
  976.  
  977.       o  New function decnet():
  978.  
  979.          This is an assembly function found in source file DECNET.ASM.
  980.          (V1.0   file   name  was  INTIOCTL.ASM)  It  provides  direct
  981.          interface to the DECnet Network Process (DNP)  via  interrupt
  982.          vector  6EH.   V1.0  interrupt interface to DNP was via 2AH -
  983.          this interface is  still  supported  in  V1.1  for  backwards
  984.                          ________                   _______
  985.          compatibility.  decnet() replaces the V1.0 ioctl() function.
  986.  
  987.       o  New format for DECNODE.DAT
  988.  
  989.          The format for the file DECNODE.DAT is different  in  Version
  990.          1.1 than it was in Version 1.0.  Passwords are now encrypted,
  991.          so that other users cannot read any of the passwords you have
  992.          defined.
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.                                  1-14
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.                               CHAPTER 2
  1017.  
  1018.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1019.  
  1020.  
  1021.  
  1022. This   chapter   describes   known   problems,    restrictions,    and
  1023. troubleshooting hints.
  1024.  
  1025.  
  1026.  
  1027.  
  1028. 2.1  Asynchronous Installation Problems
  1029.  
  1030.  
  1031.       o  When connecting your Rainbow or IBM personal computer to  the
  1032.          adjacent  node using an Asynchronous DDCMP connection through
  1033.          a null modem cable, remember to switch the send  and  receive
  1034.          leads properly.
  1035.  
  1036.       o  The use of a terminal switch or a terminal server running LAT
  1037.          for  connection  of  your Rainbow or IBM personal computer to
  1038.          the adjacent node is not supported.
  1039.  
  1040.       o  When  using  the  DECnet  Router  Server   for   asynchronous
  1041.          connections,  the circuit must be full duplex and must be set
  1042.          to the same line speed as your machine.
  1043.  
  1044.          For example:
  1045.  
  1046.          Direct:  SET LINE LC-1L SPEED 9600 DUPLEX FULL MODEM NO
  1047.          Modem:  SET LINE LC-1L SPEED 1200 DUPLEX FULL MODEM YES
  1048.  
  1049.          The circuit cost and hello timer values can  be  set  to  any
  1050.          reasonable values.  The state should be set to ON.
  1051.  
  1052.       o  When making a direct  Asynchronous  DDCMP  connection  to  an
  1053.          RSX11  system,  note  that  entire  controllers  must support
  1054.          either terminals or DDCMP lines, but not both.   Insure  that
  1055.          your  sysgen  or  system  configuration  does NOT include the
  1056.          chosen controller and that your DECnet gen DOES  include  the
  1057.          chosen controller.
  1058.  
  1059.  
  1060.  
  1061.                                  2-1
  1062.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1063.  
  1064.  
  1065.       o  When using Asynchronous DDCMP and connecting  directly  to  a
  1066.          VAX/VMS  system,  note  that VAX/VMS can share the lines on a
  1067.          controller between terminal support  and  asynchronous  DDCMP
  1068.          support.
  1069.  
  1070.       o  When  configuring  your  VAX/VMS  adjacent  node,   use   the
  1071.          following  commands  as  a GUIDE for your VMS system manager.
  1072.          These  commands  establish  the  chosen  terminal  lines   as
  1073.          dedicated DDCMP lines.
  1074.  
  1075.           
  1076.          __ ____ ______ _____ ______ _______ ____ ____ __ ____ _____
  1077.          $! Load asynch DDCMP device driver. This must be done after
  1078.          __  _____ ______ _____
  1079.          $!  every system boot.
  1080.          _ ___ _________________
  1081.          $ run sys$system:sysgen
  1082.          _______ ______________
  1083.          connect noa0/noadapter
  1084.          ____
  1085.          exit
  1086.          __ ____ ___ _____ _____ ___ __ __ _________ __ _____
  1087.          $! Tell VMS which lines are to be dedicated to DDCMP
  1088.          __  ____ ____ __ ____ _____ _____ ______ ____
  1089.          $!  This must be done after every system boot
  1090.          ____ ____ ___________________________________________ _____
  1091.          $set term /protocol=ddcmp/speed=9600/notypeahead/perm ttb4:
  1092.          ____ ____ ___________________________________________ _____
  1093.          $set term /protocol=ddcmp/speed=9600/notypeahead/perm ttb5:
  1094.          __ ___ ___ __ ________ _________ ___ _____ ___ ________
  1095.          $! Use NCP to properly configure the lines and circuits
  1096.          __  ________ ____ ______ _______ ___ _________ ________
  1097.          $!  Remember that DEFINE changes the permanent database
  1098.          __  ___ ___ _____ ____________
  1099.          $!  and SET works immediately.
  1100.          _ ___
  1101.          $ ncp
  1102.          ______ ____ ______ _____ __ _______ _______ _
  1103.          define line tt-1-4 state on receive buffers 4
  1104.          ______ ____ ______ _____ __ _______ _______ _
  1105.          define line tt-1-5 state on receive buffers 4
  1106.          ______ _______ ______ _____ __
  1107.          define circuit tt-1-4 state on
  1108.          ______ _______ ______ _____ __
  1109.          define circuit tt-1-5 state on
  1110.          ____
  1111.          exit
  1112.  
  1113.  
  1114.       o  When  configuring  your  VAX/VMS  adjacent  node,   use   the
  1115.          following  commands  as  a GUIDE for your VMS system manager.
  1116.          These commands establish all  terminal  lines  as  switchable
  1117.          DDCMP lines (V4.2 and later only).
  1118.  
  1119.          ON THE VAX
  1120.  
  1121.          1.  The asynchronous DDCMP driver, NODRIVER, must  be  loaded
  1122.              on the VAX system.
  1123.  
  1124.              _______ _______ ______________
  1125.              SYSGEN> CONNECT NOA0/NOADAPTER
  1126.  
  1127.          2.  DYNSWITCH, the image that controls the switching  of  the
  1128.              line, must be installed as a shareable image on the VAX.
  1129.  
  1130.          
  1131.              ________ ______ _______________________________________________
  1132.              INSTALL> CREATE SYS$LIBRARY:DYNSWITCH/SHARE/PROTECT/HEADER/OPEN
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.                                  2-2
  1140.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1141.  
  1142.  
  1143.          3.  A virtual terminal must  be  created  in  order  for  the
  1144.              physical   terminal   connection  to  be  broken  without
  1145.              actually losing the logical connection  between  the  two
  1146.              systems.
  1147.  
  1148.              _______ _______ ______________________________
  1149.              SYSGEN> CONNECT VTA0/NOADAPTER/DRIVER=TTDRIVER
  1150.  
  1151.          4.  The terminal line must be set for 8 bit  characters  with
  1152.              no parity and have the attribute DISCONNECT on the VAX.
  1153.  
  1154.                                        NOTE
  1155.  
  1156.                  The  DISCONNECT  attribute  enables  the  virtual
  1157.                  terminal  to  be  used.  The DISCONNECT attribute
  1158.                  must be permanent; it must either  be  set  /PERM
  1159.                  after   every   boot,  or  the  default  terminal
  1160.                  characteristics must be set properly.  If you set
  1161.                  the   terminal   characteristics   for  your  own
  1162.                  terminal, you must log out and log back in  again
  1163.                  for them to take effect.  Also note that if modem
  1164.                  control is enabled, hangup must also be  enabled.
  1165.                  You  know  that  this  step  has  been  performed
  1166.                  properly  if  your  terminal  device   designator
  1167.                  begins with VT.
  1168.  
  1169.  
  1170.          5.  In the node database, the following  parameters  must  be
  1171.              set  for the node that will be switching the asynchronous
  1172.              connection:
  1173.  
  1174.               -  The INBOUND parameter must be set to either ROUTER or
  1175.                  ENDNODE.
  1176.  
  1177.               -  The RECEIVE PASSWORD must be set to match the  remote
  1178.                  node's EXECUTOR TRANSMIT PASSWORD.
  1179.  
  1180.                                          NOTE
  1181.  
  1182.                      The password will be converted  to  uppercase
  1183.                      unless it is defined as a quoted string.
  1184.  
  1185.  
  1186.       
  1187.      _______ ____        _______ _              _ _______ ________         
  1188.      NCP>SET NODE node-idINBOUND [router/endnode] RECEIVE PASSWORD password
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.                                  2-3
  1200.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1201.  
  1202.  
  1203.          ON THE PERSONAL COMPUTER
  1204.  
  1205.          1.  On a personal computer, the DECnet line must be set  OFF,
  1206.              either by default or by command with NCP.
  1207.  
  1208.          2.  The terminal line/terminal emulator must be set for 8 bit
  1209.              characters with no parity.
  1210.  
  1211.          3.  The EXECUTOR TRANSMIT PASSWORD must be set to  match  the
  1212.              RECEIVE PASSWORD specified for the node definition on the
  1213.              remote system.  The password must be entered in uppercase
  1214.              since  the  password  defined  on the VAX is converted to
  1215.              uppercase unless it is entered as a quoted string.
  1216.  
  1217.                                        NOTE
  1218.  
  1219.                  The EXECUTOR RECEIVE PASSWORD must  not  be  set;
  1220.                  when  DYNSWITCH is used, DECnet-VAX will not send
  1221.                  a password during routing initialization.  If the
  1222.                  receive  password  is set, the line will not come
  1223.                  up.
  1224.  
  1225.  
  1226.          4.  Both the terminal line and the DDCMP line must be set  to
  1227.              the  speed  of  the  line to be used; they will not share
  1228.              line characteristics.
  1229.  
  1230.          5.  Connect to the VAX as a  normal  terminal  user  using  a
  1231.              terminal emulator.
  1232.  
  1233.          6.  When the line is to be switched from a terminal line to a
  1234.              DDCMP line, the following DCL command is entered:
  1235.  
  1236.              ____ ________ ____________________________________
  1237.              $SET TERMINAL /PROTOCOL=DDCMP/SWITCH=DECNET/MANUAL
  1238.  
  1239.  
  1240.                                        NOTE
  1241.  
  1242.                  /MANUAL is only used when DECnet must  be  turned
  1243.                  on  manually.   When  the  switch is initiated, a
  1244.                  message appears on the terminal  indicating  that
  1245.                  the  switch  is  taking  place on the VAX and the
  1246.                  user must exit terminal emulation mode  and  turn
  1247.                  on the DECnet line.  If the line is not turned on
  1248.                  within  approximately   4   minutes,   a   static
  1249.                  asynchronous  line  will  return to terminal mode
  1250.                  and a dial-up asynchronous line with hangup  will
  1251.                  be disconnected.
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.                                  2-4
  1259.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1260.  
  1261.  
  1262.          Terminating a Switched DDCMP Connection
  1263.  
  1264.          A DDCMP connection created using DYNSWITCH can be  terminated
  1265.          from  either  end  of  the  connection by setting the line or
  1266.          circuit (VAX/uVAX only) OFF.  The following are  the  various
  1267.          scenarios that will occur when the line is disconnected:
  1268.  
  1269.          1.  The personal computer user sets the line OFF or the  line
  1270.              drops due to noise, etc.
  1271.  
  1272.              If the switched line is  a  hardwired  line  between  the
  1273.              personal  computer  and  the VAX, or a modem is used with
  1274.              /NOHANGUP specified, the circuit on the VAX side will  go
  1275.              into  an  ON/STARTING  state for approximately 4 minutes.
  1276.              This enables the personal computer user to set  the  line
  1277.              back  ON  and  have  it  operational without having to go
  1278.              through the entire DYNSWITCH procedure again.
  1279.  
  1280.          2.  The system manager on the VAX or uVAX can set either  the
  1281.              circuit or the line OFF.
  1282.  
  1283.              If either the circuit or the  line  is  set  OFF  on  the
  1284.              VAX/uVAX,  both  the  circuit  and  line  information are
  1285.              removed from the volatile database and  the  asynchronous
  1286.              line is returned to terminal mode.
  1287.  
  1288.          Miscellaneous Information
  1289.  
  1290.          1.  If a modem is used for a DYNSWITCH connection, the  modem
  1291.              signal will not be dropped during the switch.
  1292.  
  1293.          2.  If /NOHANGUP is specified on the terminal line, the modem
  1294.              signal  will not drop after the DDCMP circuit is set OFF.
  1295.              The line will return to terminal mode.
  1296.  
  1297.          3.  If DECnet is being turned on manually, a  <CTRL/C>  or  a
  1298.              <CTRL/Y>  after the switch message aborts the switch, and
  1299.              the line is returned to terminal mode.
  1300.  
  1301.          4.  For a dynamic  connection,  the  line  and  circuit  will
  1302.              automatically  be  added  to the volatile database on the
  1303.              VAX when the line is switched from terminal mode to DDCMP
  1304.              mode.   It  does  not  have  to  be manually added to the
  1305.              database.
  1306.  
  1307.          5.  An asynchronous terminal connection to a  VAX  through  a
  1308.              switch  or  a LAT terminal server cannot be switched to a
  1309.              DDCMP line using DYNSWITCH.
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.                                  2-5
  1317.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1318.  
  1319.  
  1320. 2.2  Asynchronous Performance and Tuning
  1321.  
  1322.  
  1323.       o  If you have a poor Asynchronous DDCMP connection (such  as  a
  1324.          noisy  phone  line between modems), the following suggestions
  1325.          may help:
  1326.  
  1327.                                                       _
  1328.          Set the line speed lower (NCP SET LINE SPEED n).
  1329.  
  1330.          Set the personal computer's executor retransmit factor higher
  1331.                                                 _
  1332.          (NCP  SET  EXECUTOR  RETRANSMIT FACTOR n).  The default is 6;
  1333.          try 10.  This is the  number  of  times  that  a  message  is
  1334.          retransmitted  before  the  logical  link is declared broken.
  1335.          Setting this parameter higher allows the network  more  times
  1336.          to retry messages with errors.
  1337.  
  1338.          Set the personal computer's segment  size  smaller  (NCP  SET
  1339.                                           _
  1340.          EXECUTOR  SEGMENT  BUFFER  SIZE  n).   A smaller segment size
  1341.          improves the chances that  messages  will  be  sent  with  no
  1342.          errors.   A  smaller segment size also means that the loss of
  1343.          one character causes fewer characters  to  be  retransmitted.
  1344.          The  VMS  minimum is 192.  Try 200 first.  The minimum of the
  1345.          peers is used.  NFT may produce "buffer too small" errors  at
  1346.          low values.
  1347.  
  1348.          Set the Host's EXECUTOR HELLO TIMER longer.  This affects how
  1349.          long  DECnet  will  wait for any traffic before declaring the
  1350.          line to be down.
  1351.  
  1352.          On VMS, SET CIRCUIT MAX  TRANSMITS  controls  the  retransmit
  1353.          count before recycling the line.  Default is 4, set it to 32.
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.                                  2-6
  1378.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1379.  
  1380.  
  1381. 2.3  Asynchronous Configuration Problems
  1382.  
  1383.  
  1384.       o  When the network process has the line state  ON,  it  assumes
  1385.          that  it  has  complete control of the communications port of
  1386.          the system.  It will continue to run DECnet protocols in  the
  1387.          background.   If  you wish to use the communications port for
  1388.          other purposes (such as a terminal emulator), you must  first
  1389.          turn  the  line  state OFF with NCP.  This will disengage the
  1390.          network process and return the  communications  port  to  its
  1391.          previous state.
  1392.  
  1393.       o  The network process uses the communications parameters stored
  1394.          in  the DECnet database, NOT the parameters that the port may
  1395.          be programmed with by MS-DOS SETUP commands  on  the  Rainbow
  1396.          (or  PC-DOS  MODE  commands on IBM PCs).  Problems will occur
  1397.          if, for example, you do not properly adjust  the  line  speed
  1398.          with NCP to match the remote system.
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.                                  2-7
  1436.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1437.  
  1438.  
  1439. 2.4  Ethernet Performance and Tuning
  1440.  
  1441. The Ethernet controllers  supported  by  DECnet-DOS  V1.1  use  single
  1442. buffers  for  message reception.  Since the personal computer's CPU is
  1443. fairly slow compared to the speed of the Ethernet, it is possible  for
  1444. a message to be lost by a personal computer because it is busy getting
  1445. the last message off of the controller.   When  this  happens,  DECnet
  1446. will  detect  that  a  message  has  been lost (after a short time has
  1447. passed) and automatically retransmit the lost message.  This  loss  of
  1448. messages and subsequent recovery can be observed in counters displayed
  1449. by NCP and NTU, in failures in Ethernet loop circuit commands in  NTU,
  1450. and  in  short pauses during normal operations.  These symptoms do NOT
  1451. indicate correctable problems.  The loss of  messages  and  subsequent
  1452. recovery is expected.
  1453.  
  1454. A number of network management parameters can be changed in an  effort
  1455. to improve performance:
  1456.  
  1457.       o  In very large networks that include many routing nodes and/or
  1458.          many LAT services, each personal computer may have to receive
  1459.          a number of messages which are regularly broadcast by routing
  1460.          nodes  and  LAT  services.   These messages are necessary for
  1461.          normal operations.  However, received data performance may be
  1462.          improved   by  preventing  the  reception  of  these  regular
  1463.          messages.   Following  are  the  commands  which   turn   off
  1464.          reception  of  these messages and the effect of each command.
  1465.          Only after all commands have been typed  will  the  potential
  1466.          performance improvement be realized.
  1467.  
  1468.                   _
  1469.          1.  LAT /n
  1470.  
  1471.                   _
  1472.              The /n switch to LAT prevents LAT  from  being  told  the
  1473.              name  of each LAT service.  If you do not wish to use LAT
  1474.              services, just do not run LAT.  If you DO wish to use LAT
  1475.                                 _
  1476.              services, use the /n switch when starting LAT and use the
  1477.              LAT-HOST keyword with the NCP SET NODE command to  inform
  1478.              LAT  which services should be available.  (This restricts
  1479.              your use of LAT services to those with service names of 6
  1480.                                                        _
  1481.              characters  or  less.) The default is no /n switch, which
  1482.              enables the reception of multicast messages.
  1483.  
  1484.          2.  NCP SET CIRCUIT SERVICE DISABLED      [ENABLED]
  1485.  
  1486.              This command prevents your personal computer  from  being
  1487.              able  to  respond to loopback requests or MOP requests at
  1488.              the circuit level.  The default is ENABLED, which  allows
  1489.              your  personal  computer to receive multicast messages in
  1490.              order to provide service functions.
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.                                  2-8
  1498.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1499.  
  1500.  
  1501.          3.  NCP SET CIRCUIT MULTICAST DISABLED    [ENABLED]
  1502.  
  1503.              This command causes your personal computer to listen  for
  1504.              announcements  concerning  which  node on the Ethernet is
  1505.              the router only when the line is started and  only  every
  1506.              ten  minutes  for  1  minute  after that.  The default is
  1507.              ENABLED, which allows your personal computer  to  receive
  1508.              multicast messages concerning routing.
  1509.  
  1510.  
  1511.       o  If logical links break, try setting the retry counter in your
  1512.          personal computer higher by typing:
  1513.  
  1514.          _______ ________ __________ ______ __
  1515.          NCP>SET EXECUTOR RETRANSMIT FACTOR 10
  1516.  
  1517.  
  1518.       o  If performance seems bursty, try setting  the  delays  before
  1519.          retransmission  lower by typing these commands on your remote
  1520.          (non-MS-DOS) systems:
  1521.  
  1522.          _______ ________ _____ ______ __
  1523.          NCP>SET EXECUTOR DELAY FACTOR 32
  1524.          _______ ________ _____ ______ _
  1525.          NCP>SET EXECUTOR DELAY WEIGHT 3
  1526.  
  1527.       o  If performance  seems  bursty,  you  may  also  want  to  try
  1528.          lowering  the  number of messages that a remote node can send
  1529.          to your personal computer at a time.  Type on  your  personal
  1530.          computer:
  1531.  
  1532.          _______ ________ _______ ____ _____ _
  1533.          NCP>SET EXECUTOR RECEIVE PIPE QUOTA 1
  1534.  
  1535.  
  1536.       o  If performance seems bursty, you may also want to try raising
  1537.          the  number  of  messages that a remote node can send to your
  1538.          personal computer at a time.  Type on your personal computer:
  1539.  
  1540.          _______ ________ _______ ____ _____ _
  1541.          NCP>SET EXECUTOR RECEIVE PIPE QUOTA 8
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.                                  2-9
  1561.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1562.  
  1563.  
  1564. 2.5  Ethernet Configuration Problems
  1565.  
  1566.  
  1567.       o  During power OFF and perhaps power ON,  Ethernet  controllers
  1568.          may introduce noise on the Ethernet.
  1569.  
  1570.       o  It may not be possible to format floppies on the IBM PC,  the
  1571.          IBM PC/XT, or the IBM PC AT while the Ethernet line is in the
  1572.          ON state.   The  DMA  of  bytes  to  and  from  the  Ethernet
  1573.          controller   may  interfere  with  the  floppy  timing  while
  1574.          formatting.  If this seems to be happening to  you,  use  the
  1575.          NCP command SET LINE STATE OFF before formatting and then SET
  1576.          LINE STATE ON after formatting.
  1577.  
  1578.  
  1579.  
  1580.  
  1581. 2.6  General Problems
  1582.  
  1583.  
  1584.       o  Following  installation,  DECPARM.DAT  contains   information
  1585.          specific  to  the  line you are using (either Asynchronous or
  1586.          Ethernet).  Each time the DECnet  Network  Process  (DNP)  is
  1587.          started,  it  verifies  that  DECPARM.DAT contains the proper
  1588.          line information.  If you wish to switch between use  of  the
  1589.          Ethernet  line  and  use of the asynchronous line, you should
  1590.          keep two copies of DECPARM.DAT:   one  for  Ethernet  (called
  1591.          DECPARM.ETH,  for  example), and one for asynchronous (called
  1592.          DECPARM.ASY, for example).  Insure that AUTOEXEC.BAT does NOT
  1593.          run  the  DECnet Network Process (DNP).  After each boot, you
  1594.          can rename the appropriate DECPARM file  to  DECPARM.DAT  and
  1595.          then  run  the matching DNP.  If you attempt to use the wrong
  1596.          network process  for  the  current  permanent  database  file
  1597.          (DECPARM.DAT),  the  error message "wrong protocol type found
  1598.          in DECPARM.DAT" will be displayed.
  1599.  
  1600.       o  The network takes control of clock interrupts as soon as  the
  1601.          scheduler  component runs (SCHPC or SCHRB).  The network also
  1602.          takes control of com option interrupts when the line state is
  1603.          ON.  Other products which also take control of interrupts may
  1604.          not  be  compatible  with  DECnet.   In  order  to  run  such
  1605.          incompatible  software,  you must either turn the DECnet line
  1606.          OFF with NCP, or prevent the scheduler component  from  being
  1607.          run.   Note  also  that  use  of the DECnet virtual disks and
  1608.          printer may not be possible during execution of  incompatible
  1609.          software products.
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.                                  2-10
  1619.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1620.  
  1621.  
  1622.          If you are using an asynchronous DDCMP connection, note  that
  1623.          Symphony  from  Lotus,  as  shipped,  will  cause the network
  1624.          circuit to drop and therefore  will  not  allow  use  of  the
  1625.          virtual disk and printer.  However, using the INSTALL program
  1626.          that comes with Symphony you can make the  changes  necessary
  1627.          to  force  Symphony to ignore the communications port when it
  1628.          runs.  Run INSTALL to create a new driver set, or  to  change
  1629.          an  existing  driver  set.   Delete  the  drivers  for modem,
  1630.          protocol, (and for the Rainbow, 7201  asynchronous  support).
  1631.          Note  that if you modify an existing driver set, you must use
  1632.          the  method  documented  on  (or  about)  page  41   of   the
  1633.          Introduction Manual which describes how to use the minus sign
  1634.          to remove an option.
  1635.  
  1636.       o  The network process determines the system  type  that  it  is
  1637.          running  on  by  looking at ROM BIOS locations and/or calling
  1638.          the Rainbow software  interrupt  18  hex.   Due  to  hardware
  1639.          dependencies,  the  Rainbow  and  IBM  PC  processes  are not
  1640.          interchangeable.  An error message will  be  issued  and  the
  1641.          process will refuse to run on the wrong system.
  1642.  
  1643.       o  The transparent file access capabilities intercept the MS-DOS
  1644.          system  call  interface through interrupt 21 hex.  If you run
  1645.          other  programs  that  intercept  interrupt  21,   they   may
  1646.          interfere with the functioning of the transparent file access
  1647.          operations.
  1648.  
  1649.       o  Be sure to understand that sockets are not bound to programs.
  1650.          Once  a  socket  is  created,  it will stay alive until it is
  1651.          closed, even if the program that created it exits.  A symptom
  1652.          of too many open sockets is running out of buffer space.  Use
  1653.          NCP and  the  command  SHOW  ACTIVE  LINKS  to  display  open
  1654.          sockets, and SET ACTIVE LINK STATE OFF to close open sockets.
  1655.  
  1656.       o  All utilities accept the node specification as either a  node
  1657.          name or node address.  When node name alone is specified, all
  1658.          utilities  will  check  to  see  if  default  access  control
  1659.          information has been stored by NCP for that node and use that
  1660.          access control information to make the  connection.   If  the
  1661.          node  address  is  used,  checking for default access control
  1662.          information is BYPASSED.
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.                                  2-11
  1677.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1678.  
  1679.  
  1680.       o  All features of  DECnet-DOS  cannot  be  supported  on  small
  1681.          memory  systems.   If  you  find that the DECnet Installation
  1682.          Procedure (DIP) warns you about having too little memory,  if
  1683.          you  find  that  MS-DOS gives you an error message indicating
  1684.          too little  memory  after  running  a  utility,  or  if  your
  1685.          personal  computer  hangs  after  running  a utility, try the
  1686.          following:
  1687.  
  1688.           -  Study the appendix in the Installation Guide which  lists
  1689.              each  utility, to determine whether it is memory resident
  1690.              and its approximate size.
  1691.           -  Do not install any unnecessary third party software  that
  1692.              is memory resident.
  1693.           -  Do not install TTT.  It is memory resident.
  1694.           -  Do not install TFA.  It is memory resident.
  1695.           -  Do not install LAT.  It is memory resident.
  1696.           -  Set the FILES parameter in CONFIG.SYS as low as possible.
  1697.              64 bytes are used for each open file.
  1698.           -  Set  the  BUFFERS  parameter  in  CONFIG.SYS  as  low  as
  1699.              possible.  528 bytes are used for each buffer.
  1700.           -  Use NCP to lower the number of logical links supported.
  1701.  
  1702.                                       _
  1703.              NCP DEFINE EXEC MAX LINK n
  1704.  
  1705.           -  Use NCP  to  lower  the  maximum  number  of  buffers  to
  1706.              allocate.
  1707.  
  1708.                                         _
  1709.              NCP DEFINE EXEC MAX BUFFER n
  1710.  
  1711.  
  1712.          On a 256K personal computer there is enough room to run  NCP,
  1713.          NFT,  NTU,  CTERM based SETHOST, NDU with one virtual device,
  1714.          FAL, DTS, DTR, and MAIL if:
  1715.  
  1716.           -  FILES=8 in CONFIG.SYS.
  1717.           -  BUFFERS=2 in CONFIG.SYS.
  1718.           -  EXEC MAX LINKS 2 in NCP.
  1719.           -  EXEC MAX BUFFERS 12-14 in NCP.
  1720.  
  1721.  
  1722.  
  1723. Note that if DIP detects insufficient memory,  it  will  automatically
  1724. adjust  memory  usage  parameters  in an attempt to fit all components
  1725. into memory.
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.                                  2-12
  1737.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1738.  
  1739.  
  1740. 2.6.1  Problems with Rainbow Only
  1741.  
  1742.  
  1743.  
  1744.       o  The Rainbow can suffer from crashes,  hangs,  memory  errors,
  1745.          and  other  problems if it contains bad memory chips.  It may
  1746.          be the case that your Rainbow can have bad  memory  which  is
  1747.          seldom  used  until DECnet is installed.  (The resident parts
  1748.          of DECnet cause more memory to be used.) As a result, it  may
  1749.          appear that the DECnet installation is causing these problems
  1750.          when it is in fact the memory.  If you are experiencing these
  1751.          problems,  have  your  local field service organization check
  1752.          your Rainbow for bad memory.
  1753.  
  1754.       o  In  order  to  avoid  problems   with   the   firmware,   all
  1755.          non-interrupt driven network processing is suspended while in
  1756.          SETUP mode.  Staying in SETUP mode for long periods  of  time
  1757.          will most likely cause your network sessions to be lost.
  1758.  
  1759.       o  The network process uses the Rainbow  MS-DOS  V2.11  Extended
  1760.          Communications  BIOS  User Defined Interrupt Service table to
  1761.          redirect communications  interrupts  to  it.   Use  of  other
  1762.          programs  that  use  the BIOS function to change or reset the
  1763.                                                _______  ______   _____
  1764.          service  routine  address  (see  the  Rainbow  MS-DOS   V2.05
  1765.          ____________  _____
  1766.          Programmer's  Guide  for  more  information) will effectively
  1767.          terminate DECnet communications if  the  process  is  active.
  1768.          For  example:   running  a poly-COM program will modify these
  1769.          addresses.  To recover, you must use  NCP  to  set  the  line
  1770.          state OFF and then back ON again.
  1771.  
  1772.  
  1773.  
  1774.  
  1775. 2.6.2  Problems with IBM PCs Only
  1776.  
  1777.  
  1778.  
  1779.       o  The SETHOST utility uses interrupt 10H of the IBM BIOS  while
  1780.          running  to  control  screen  output, and takes over keyboard
  1781.          interrupt 09H to handle keyboard input.  Any  other  programs
  1782.          that you may use to enhance the keyboard or display operation
  1783.          may interfere with the operation of this utility.
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.                                  2-13
  1797.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1798.  
  1799.  
  1800. 2.7  NFT - Network File Transfer
  1801.  
  1802.  
  1803.       o  The algorithm for determining whether  a  file  is  ASCII  or
  1804.          image  when  copying from personal computer to remote without
  1805.          switches is as follows:  If the first  512  bytes  contain  a
  1806.          CR/LF,  the file must be ASCII.  Otherwise, it must be image.
  1807.          Note that some image files may appear to be ASCII using  this
  1808.          rule.
  1809.  
  1810.       o  The SET command for paths on remote ULTRIX systems  does  not
  1811.          work.
  1812.  
  1813.       o  The use of MACY11 and LSA switches for  remote  DECsystem-10s
  1814.          and DECsystem-20s does not work.
  1815.  
  1816.       o  If a directory command specifies multiple subdirectories  and
  1817.          some  of  them  are  protected,  the  error  message fails to
  1818.          display the volume and directory names.
  1819.  
  1820.       o  The command DIR REMOTE::  defaults the file specification  to
  1821.          *.*.  This produces the correct results on all remote systems
  1822.          except ULTRIX.  On an ULTRIX system this only lists the files
  1823.          that  have  a  period  in  their  names.  To work around this
  1824.          problem, use the command DIR REMOTE::*.
  1825.  
  1826.       o  The SHOW command displays any part of a password string which
  1827.          follows  an  embedded  space.   This is not a serious problem
  1828.          since most passwords do not have spaces in them.
  1829.  
  1830.       o  If a wildcarded copy  from  a  remote  VAX  to  the  personal
  1831.          computer  specifies a wild file specification which matches a
  1832.          directory specification on the VAX, the directory  files  are
  1833.          copied  to the personal computer.  These files do not contain
  1834.          any useful information and can be deleted.
  1835.  
  1836.       o  If a wildcarded copy  from  a  remote  VAX  to  the  personal
  1837.          computer  requests  access  to  a  protected  directory,  NFT
  1838.          displays a message saying that there was  a  problem  with  a
  1839.          temporary file.  This is the wrong message.
  1840.  
  1841.       o  If a COPY command which copies files  from  a  remote  ULTRIX
  1842.          system  to  a  personal  computer  defaults  the  output file
  1843.          specification and  the  ULTRIX  file  specification  contains
  1844.          directories,  then  the resulting personal computer file will
  1845.          be named incorrectly.
  1846.  
  1847.       o  If the value of MRS is set too large (> 1024) then NFT  fails
  1848.          in unpredictable ways.
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.                                  2-14
  1855.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1856.  
  1857.  
  1858. 2.8  Error Messages and Warnings
  1859.  
  1860. The following error messages and warnings are not listed in Appendix B
  1861.                             __________ ______ _____
  1862. (NFT Error Messages) of the DECnet-DOS User's Guide.
  1863.  
  1864.  
  1865.  
  1866.  
  1867. 2.8.1  Error Messages
  1868.  
  1869.  
  1870.       -  Address already in use.
  1871.       -  Address family not supported by protocol family.
  1872.       -  Argument list too long.
  1873.       -  Argument too long.
  1874.       -  Attribute read error.
  1875.       -  Attribute write error.
  1876.       -  Bad address.
  1877.       -  Bad block on device.
  1878.       -  Bad file number.
  1879.       -  Bad terminator or bad value for switch:
  1880.       -  Bad version number.
  1881.       -  Broken pipe.
  1882.       -  Cannot close file.
  1883.       -  Cannot get JFN for file.
  1884.       -  Cannot open local file with DOS reserved names:
  1885.       -  Cannot PRINT list of files.
  1886.       -  Cannot PRINT local file.
  1887.       -  Connection refused.
  1888.       -  Connection reset by peer.
  1889.       -  Connection timed out.
  1890.       -  Destination address required.
  1891.       -  Device not available.
  1892.       -  Device not found.
  1893.       -  Device not ready.
  1894.       -  Device or file full.
  1895.       -  Disk full or other error in closing file.
  1896.       -  Disk full or other error in writing file.
  1897.       -  Disk usage exceeds quota.
  1898.       -  Error in data type.
  1899.       -  Error in file type extension.
  1900.       -  Failure to get transmit buffer.
  1901.       -  F11-ACP could not access file.
  1902.       -  F11-ACP could not create file.
  1903.       -  F11-ACP could not mark file for deletion.
  1904.       -  File activity precludes operation.
  1905.       -  File already open.
  1906.       -  File Exists.
  1907.       -  File extend failure.
  1908.       -  File is currently in an undefined state.
  1909.       -  Filename syntax error.
  1910.  
  1911.  
  1912.  
  1913.                                  2-15
  1914.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1915.  
  1916.  
  1917.       -  File name too long.
  1918.       -  File not found.
  1919.       -  FSZ field invalid.
  1920.       -  Illegal record encountered.
  1921.       -  Insufficient network resources.
  1922.       -  Invalid DAP message type received.
  1923.       -  Invalid DAP message format received.
  1924.       -  Invalid file options.
  1925.       -  Invalid object name format.
  1926.       -  Invalid wildcard context value.
  1927.       -  Logical name error.
  1928.       -  LPT page limit exceeded.
  1929.       -  Message too long.
  1930.       -  Mount device busy.
  1931.       -  Network capacity exceeded.
  1932.       -  Network dropped connection on reset.
  1933.       -  Network operation failed at remote node.
  1934.       -  Network operation not supported.
  1935.       -  Network operation timed out.
  1936.       -  NFAR error, FFIRST with dir in progress.
  1937.       -  NFAR error, file not open.
  1938.       -  NFAR error, FNEXT with no dir in progress.
  1939.       -  NFAR error, illegal access.
  1940.       -  NFAR error, invalid function.
  1941.       -  NFAR error, invalid RATs.
  1942.       -  NFAR error, missing ::.
  1943.       -  NFAR error, missing quote.
  1944.       -  NFAR error, no \\\\ or \\*\\.
  1945.       -  NFAR error, no more room.
  1946.       -  NFAR error, record buffer too small.
  1947.       -  NFAR error, socket not found.
  1948.       -  No buffer space available.
  1949.       -  Node name cannot be longer than 6 characters.
  1950.       -  Node is unreachable.
  1951.       -  No more sockets available.
  1952.       -  No such device.
  1953.       -  Not supported by remote.
  1954.       -  Operation illegal or invalid for file organization.
  1955.       -  Operation in progress.
  1956.       -  Operation not supported on socket.
  1957.       -  Operation would block.
  1958.       -  Parity error on device.
  1959.       -  Path and  file  names  not  valid  for  SET,  SHOW,  or  EXIT
  1960.          commands.
  1961.       -  Permission denied.
  1962.       -  Protocol not available.
  1963.       -  Protocol not supported.
  1964.       -  Remote object is too busy.
  1965.       -  Result too large.
  1966.       -  Socket is already connected.
  1967.       -  Socket is not connected.
  1968.  
  1969.  
  1970.  
  1971.                                  2-16
  1972.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  1973.  
  1974.  
  1975.       -  Socket operation on nonsocket.
  1976.       -  Socket type not supported.
  1977.       -  Spool or submit command file error.
  1978.       -  Switches not valid for SET, SHOW, or EXIT commands.
  1979.       -  Task not available.
  1980.       -  Too many open files.
  1981.       -  Unexpected DAP message received.
  1982.       -  Unmatched quotes:
  1983.       -  Unrecognized  local  file  specification,  remote  to  remote
  1984.          operations not supported.
  1985.       -  Unrecognized object.
  1986.       -  Unrecognized remote file specification:
  1987.       -  Unrecognized  remote  file  specification,  local  to   local
  1988.          operations not supported.
  1989.       -  Unsupported DAP flag field received.
  1990.       -  VFC value must be less than 256.
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996. 2.8.2  Warnings
  1997.  
  1998.  
  1999.       -  Extra local file names will be ignored.
  2000.       -  Extra remote file names will be ignored.
  2001.       -  Warning:  Destination file name list longer than source list.
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.                                  2-17
  2030.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  2031.  
  2032.  
  2033. 2.9  SETHOST
  2034.  
  2035.  
  2036. 2.9.1  CTERM ONLY
  2037.  
  2038.  
  2039.  
  2040.       o  Use of the @ command for batch input is not  fully  supported
  2041.          by ULTRIX and RSX hosts.
  2042.  
  2043.       o  The VMS command SET TERM/INQ  does  not  work  properly  when
  2044.          embedded in LOGIN.COM and the @ command is used.
  2045.  
  2046.       o  VMS  TDMS  applications  are  not   supported   under   CTERM
  2047.          connections.   VMS  TDMS applications are supported under LAT
  2048.          connections.
  2049.  
  2050.       o  A protocol-based virtual terminal service can be slower  than
  2051.          a  direct  dumb  terminal connection.  Some sequences will be
  2052.          faster using CTERM because all  character  operations  for  a
  2053.          complete  line will be done locally in the Rainbow or IBM PC.
  2054.          Some operations will be slower (such  as  editing  with  EDT)
  2055.          because  each  character  typed  causes  a  number  of  CTERM
  2056.          protocol messages to be exchanged.
  2057.  
  2058.       o  Writing saved session files does not check for disk error.
  2059.  
  2060.       o  While command line editing to VMS, if text is inserted  which
  2061.          fills  a  line,  the image on the screen does not wrap to the
  2062.          next line properly.  The characters sent to the  remote  node
  2063.          are correct.
  2064.  
  2065.       o  If backspace characters  are  output  which  would  back  the
  2066.          cursor  up  before  the  beginning  of  the  line, text which
  2067.          follows the backspace characters appears on  the  next  line.
  2068.          Text should appear on the same line.
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.                                  2-18
  2088.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  2089.  
  2090.  
  2091.       o  For asynchronous  configurations,  characters  are  sometimes
  2092.          lost when typing ahead.
  2093.  
  2094.       o  The following information applies to IBM PCs only:
  2095.  
  2096.           -  VT100 emulation on IBM  PCs  does  not  fully  emulate  a
  2097.              VT100.   Double  height  and  double width text cannot be
  2098.              displayed, 132 character width mode cannot  be  selected,
  2099.              not all character attributes are available, and the local
  2100.              printer is not supported.
  2101.  
  2102.           -  The first ALL-IN-1 screen leaves the cursor in the  wrong
  2103.              place.   Typing  carriage  return  properly positions the
  2104.              cursor.
  2105.  
  2106.           -  Not  all  character  attribute  escape   sequences   work
  2107.              properly.   Both  black  and  white  and  color have some
  2108.              problems.
  2109.  
  2110.           -  After exiting from SETHOST on  an  IBM  PC,  some  screen
  2111.              attributes  are  not  reset to their state before running
  2112.              SETHOST, such as color and cursor format.
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118. 2.9.2  LAT ONLY
  2119.  
  2120.  
  2121.       o  Use of the @ command for batch input is not  fully  supported
  2122.          by ULTRIX and RSX hosts.
  2123.  
  2124.       o  Use of the @ command for batch  input  is  supported  by  VMS
  2125.          hosts.   However,  it  will  not  work  properly  if  the SET
  2126.          TERM/INQ command is embedded in LOGIN.COM and the  @  command
  2127.          is used.
  2128.  
  2129.       o  VMS TDMS applications are supported  under  LAT  connections.
  2130.          VMS   TDMS   applications   are  not  supported  under  CTERM
  2131.          connections.
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.                                  2-19
  2146.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  2147.  
  2148.  
  2149.       o  The following information applies to IBM PCs only:
  2150.  
  2151.           -  VT100 emulation on IBM  PCs  does  not  fully  emulate  a
  2152.              VT100.   Double  height  and  double width text cannot be
  2153.              displayed, 132 character width mode cannot  be  selected,
  2154.              not all character attributes are available, and the local
  2155.              printer is not supported.
  2156.  
  2157.           -  Not  all  character  attribute  escape   sequences   work
  2158.              properly.   Both  black  and  white  and  color have some
  2159.              problems.
  2160.  
  2161.           -  After exiting from SETHOST on  an  IBM  PC,  some  screen
  2162.              attributes  are  not  reset to their state before running
  2163.              SETHOST, such as color and cursor format.
  2164.  
  2165.  
  2166.       o  If backspace characters  are  output  which  would  back  the
  2167.          cursor  up  before  the  beginning  of  the  line, text which
  2168.          follows the backspace characters appears on  the  next  line.
  2169.          Text should appear on the same line.
  2170.  
  2171.       o  Connections to RSX-11M-PLUS V3.0 can crash the system.   This
  2172.          problem is being solved by patches or future releases of RSX.
  2173.  
  2174.       o  Connections to RSX-11M-PLUS V3.0 can break.  This problem  is
  2175.          being solved by patches or future releases of RSX.
  2176.  
  2177.       o  Connections to the Ethernet  Terminal  Server  V2.1  (reverse
  2178.          LAT)  or  earlier  may  break.   This  problem is solved by a
  2179.          future release of the terminal server software.
  2180.  
  2181.       o  Connections to ULTRIX V1.2 (or earlier)  systems  can  break.
  2182.          This  problem is solved by patches or a future release of the
  2183.          ULTRIX software.
  2184.  
  2185.       o  If the NEW SESSION option  is  chosen  after  typing  ^\<RET>
  2186.          during  a  LAT  session,  SETHOST  allows you to create a new
  2187.          session.  However,  the  existing  LAT  session  is  aborted.
  2188.          (When  a  LAT  session  to  a  VMS  host is aborted, your job
  2189.          remains intact.  The next time you log onto the VMS host, you
  2190.          can reconnect to the same job.)
  2191.  
  2192.       o  When  using  <CTRL/S>  and  <CTRL/Q>  to  pause  output,  the
  2193.          response may be slow.  Pressing the <HOLD SCREEN> key (on the
  2194.          Rainbow) or the <ALT/F1> key (on an IBM PC)  is  faster,  but
  2195.          the response is still not immediate.
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.                                  2-20
  2204.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  2205.  
  2206.  
  2207.       o  To send <CTRL/\> to the host system, be sure  to  repeat  the
  2208.          sequence  twice.  If you only do this once, SETHOST waits for
  2209.          you to press the <RETURN> key.
  2210.  
  2211.       o  If you use /CTERM/SAVE, you can only get back to using LAT by
  2212.          deleting the file SETHOST.DEF.
  2213.  
  2214.  
  2215.  
  2216.  
  2217. 2.10  NDU - Network Device Utility
  2218.  
  2219.  
  2220.       o  When the NDU CLOSE command is issued  for  a  remote  virtual
  2221.          disk  file  which resides on a personal computer running FAL,
  2222.          FAL will report the "broken pipe"  error  message.   This  is
  2223.          only a warning; no error has occurred.
  2224.  
  2225.       o  If a virtual  disk  file  is  created  with  one  NDISK  file
  2226.          specification  and  then  an  attempt  is  made to delete the
  2227.          virtual disk file using the command:
  2228.  
  2229.                      ____       ____
  2230.          DELETE NODE node NDISK file
  2231.  
  2232.          with a different file specification which references the same
  2233.          file  (using logical names, for example), the delete function
  2234.          will fail.  Always delete the virtual  disk  using  the  same
  2235.          file  specification that it was created with if the delete is
  2236.          done for a connected disk.
  2237.  
  2238.  
  2239.  
  2240.  
  2241. 2.10.1  NPDRV - Virtual Printer Driver
  2242.  
  2243.  
  2244.       o  If the remote FAL makes an error, the Rainbow or IBM  PC  may
  2245.          hang.  This will very seldom occur.
  2246.  
  2247.       o  On IBM PCs use of the virtual printer by the background print
  2248.          spooler may hang the system.
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.                                  2-21
  2263.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  2264.  
  2265.  
  2266. 2.10.2  NDDRV - Virtual Disk Driver
  2267.  
  2268.  
  2269.  
  2270.       o  If the remote FAL makes an error, the Rainbow or IBM  PC  may
  2271.          hang.  This will very seldom occur.
  2272.  
  2273.  
  2274.  
  2275.  
  2276. 2.11  NCP - Network Control Program
  2277.  
  2278.  
  2279.  
  2280.       o  Setting the state of the  line  to  OFF  in  an  asynchronous
  2281.          configuration  will shutdown network processing, but will NOT
  2282.          hang up the phone, even if the circuit's modem  parameter  is
  2283.          set  to  full.   If  you must hang up the phone under program
  2284.          control, use the NCP command:
  2285.  
  2286.          _______ ____ _____ ______
  2287.          NCP>SET LINE STATE HANGUP
  2288.  
  2289.  
  2290.       o  The executor transmit and receive passwords  and  the  remote
  2291.          node  access  control  strings  may  be  quoted  or unquoted.
  2292.          Unquoted strings are forced to uppercase.
  2293.  
  2294.       o  Please be aware that some combinations of settings for buffer
  2295.          sizes,  buffer  counts,  and  timers  may  cause  performance
  2296.          problems  or  network  failures.    Please   change   network
  2297.          parameters  only to solve specific problems.  If new problems
  2298.          occur as a result, change back to the default settings.
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.                                  2-22
  2322.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  2323.  
  2324.  
  2325.       o  If you plan to use the SET KNOWN NODES FROM  REMOTE  command,
  2326.          be aware that in a large network, the resulting node database
  2327.          can be so large that the search time during  connections  can
  2328.          be very long.  In a large network, consider only defining the
  2329.          nodes you access frequently.
  2330.  
  2331.       o  When entering quoted strings as  part  of  the  command  line
  2332.          arguments, the quotes are removed.  For example:
  2333.  
  2334.          _______ ______ ____ _______
  2335.          NCP>SET ACCESS USER "bence"
  2336.  
  2337.          With the quotes removed, this results in:
  2338.  
  2339.          _______ ______ ____ _____
  2340.          NCP>SET ACCESS USER bence
  2341.  
  2342.          The username bence is then forced to uppercase.
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.                                  2-23
  2382.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  2383.  
  2384.  
  2385. 2.12  NTU - Network Test Utility
  2386.  
  2387.  
  2388.  
  2389.       o  The  LOOP  EXECUTOR  command  requires  3  free  sockets  for
  2390.          successful   execution.   If  only  one  (or  no)  socket  is
  2391.          available, a proper error message is  returned.   If  exactly
  2392.          two  sockets  are  available, NTU reports:  "time-out waiting
  2393.          for connect".  This  does  not  indicate  a  failure  of  the
  2394.          network.
  2395.  
  2396.       o  The LOOP CIRCUIT commands  for  Ethernet  configurations  may
  2397.          fail  to  loop  some  messages.   This does not indicate that
  2398.          there is a problem which needs  to  be  corrected.   Personal
  2399.          computers  may  lose messages at times.  DECnet automatically
  2400.          retransmits  lost  messages,   but   the   circuit   loopback
  2401.          architecture does not.
  2402.  
  2403.       o  Access control strings may be quoted or  unquoted.   Unquoted
  2404.          strings are forced to uppercase.
  2405.  
  2406.       o  LOOP CIRCUIT to the DECnet Router Server V1.0/V1.1 will fail.
  2407.          This  does  not  indicate an error.  There is no loop circuit
  2408.          server software in the asynchronous router server product.
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.                                  2-24
  2440.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  2441.  
  2442.  
  2443. 2.13  TFA - Transparent File Access
  2444.  
  2445.  
  2446.       o  One can use TFA to type and copy files as follows:
  2447.  
  2448.          TYPE \\f\node\\filespec
  2449.          COPY local-file \\f\node\\remotefile
  2450.          TYPE \\f\node\\remotefile >localfile
  2451.  
  2452.       o  TFA supports only one open file at a time.
  2453.  
  2454.  
  2455.  
  2456.  
  2457. 2.14  TTT - Transparent Task-to-Task
  2458.  
  2459.  
  2460.       o  TTT supports up to 4 logical links at one time.
  2461.  
  2462.  
  2463.  
  2464.  
  2465. 2.15  DTR/DTS
  2466.  
  2467.  
  2468.       o  DTR and DTS are tools used to test the  network  and  measure
  2469.          its  performance.   The  documentation  set  does not include
  2470.          documentation for DTR or DTS.  However, the fourth floppy  in
  2471.          the   distribution   kit  contains  the  file  DTS.TXT  which
  2472.          describes the use of these tools.
  2473.  
  2474.       o  Interrupt tests to TOPS-20 systems do not work properly.
  2475.  
  2476.       o  DTS on a personal computer  reports  sequence  errors  during
  2477.          echo tests, both to VAXes and to other personal computers.
  2478.  
  2479.  
  2480.  
  2481.  
  2482. 2.16  MAIL
  2483.  
  2484.  
  2485.       o  MAIL.EXE can only SEND  mail  to  remote  nodes.   It  cannot
  2486.          receive mail.
  2487.  
  2488.       o  If one attempts to send a  non-ASCII  text  file  as  a  mail
  2489.          message,  MAIL  will  not produce a useful error message, but
  2490.          instead will behave erratically.
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.                                  2-25
  2498.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  2499.  
  2500.  
  2501. 2.17  FAL (File Access Listener)
  2502.  
  2503.       o  FAL does incoming access checking only if the file DECACC.DAT
  2504.          exists  in  the DECnet database path.  Such a file is created
  2505.          the first time the NCP SET ACCESS command is issued.   If  no
  2506.          such  file  exists,  or if you have not issued the SET ACCESS
  2507.          command, the system's files are  available  to  any  and  all
  2508.          incoming access requests while FAL is running.
  2509.  
  2510.          The DECACC.DAT file is deleted if the NCP command CLEAR KNOWN
  2511.          ACCESS  is issued.  Note that if one clears all entries using
  2512.                                            ____
  2513.          the NCP command CLEAR ACCESS USER user, the file  will  still
  2514.          exist, but have no entries.  In this case, FAL will do access
  2515.          checking, but allow access to no users.
  2516.  
  2517.       o  Since MS-DOS is a single tasking operating system,  FAL  must
  2518.          run to the exclusion of all other application programs.
  2519.  
  2520.       o  Some hosts may use as many as 4 logical links  to  perform  a
  2521.          single  file  access function.  If you plan to run FAL, it is
  2522.          suggested that you  increase  the  number  of  logical  links
  2523.          supported.  Type:
  2524.  
  2525.          __________ ________ _______ _____ _
  2526.          NCP>DEFINE EXECUTOR MAXIMUM LINKS 8
  2527.  
  2528.  
  2529.       o  Because MS-DOS  path  specifications  contain  the  backslash
  2530.          character  and  directory  names and file names have the same
  2531.          syntax, VMS cannot  use  path  specifications  without  being
  2532.          surrounded  with  double  quotes.   In  addition, a number of
  2533.          restrictions apply when using quoted file  specifications  in
  2534.          VMS.  To solve all these problems, FAL accepts VMS syntax for
  2535.          file specifications:
  2536.  
  2537.          $ DIR MSDOS::\TEST\*.C         will fail
  2538.          $ DIR MSDOS::"\TEST\*.C"       will work
  2539.          $ DIR MSDOS::[TEST]*.C         will work
  2540.  
  2541.          VMS does not understand that \foo is  sometimes  a  file  and
  2542.          sometimes  a  directory.   To  avoid  the  problems that this
  2543.          causes, always specify file names or use VMS syntax:
  2544.  
  2545.          $ DIR MSDOS::"\"                    will fail
  2546.          $ DIR MSDOS::"\*.*"                 will work
  2547.  
  2548.          $ COPY *.FOO MSDOS::"\DIR"          will fail
  2549.          $ COPY *.FOO MSDOS::"\DIR\*.*"      will work
  2550.          $ COPY *.FOO MSDOS::[DIR]*.*        will work
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.                                  2-26
  2557.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  2558.  
  2559.  
  2560.          VMS  does  not  properly  separate  the  parts  of   a   file
  2561.          specification   when  it  does  wildcarding.   As  a  result,
  2562.          wildcard copies of files from  a  personal  computer  to  VMS
  2563.          using  VMS DCL cannot be done using MS-DOS file syntax.  Such
  2564.          copies must be done using VMS file syntax:
  2565.  
  2566.          $ COPY MSDOS::"\WORK\*.*" *.*  will fail
  2567.          $ COPY MSDOS::[WORK]*.* *.*    will work
  2568.  
  2569.  
  2570.       o  FAL does NOT do file locking.  If you will be using  FAL  for
  2571.          simultaneous  access  to the same file, insure that all users
  2572.          of the file open the file for reading  ONLY.   If  two  users
  2573.          attempt  to  open  the  same  file  for  simultaneous  write,
  2574.          unpredictable results may occur.
  2575.  
  2576.       o  If FAL is run under the SPAWNER, file access from VMS systems
  2577.          using  file  lists  may  fail after the first file.  Wildcard
  2578.          file access is supported.
  2579.  
  2580.       o  When the NDU CLOSE command is issued  for  a  remote  virtual
  2581.          disk  file  which resides on a personal computer running FAL,
  2582.          FAL will report the "broken pipe"  error  message.   This  is
  2583.          only a warning; no error has occurred.
  2584.  
  2585.       o  Trapping of hard device errors works for all IBM  PCs.   Hard
  2586.          device errors that occur on a Rainbow will cause FAL to stop.
  2587.          When FAL stops due to a device error,  all  its  sockets  are
  2588.          still  active.   Use  the  NCP command "SET KNOWN LINKS STATE
  2589.          OFF" to abort FAL's links and  sockets  before  starting  FAL
  2590.          again.
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.                                  2-27
  2615.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  2616.  
  2617.  
  2618. 2.18  DIP - DECnet-DOS Installation Procedure
  2619.  
  2620.  
  2621.      1.  The following information applies to Rainbows only:
  2622.  
  2623.           -  The files DNPETHRB.EXE and LAT.EXE are not a part of  the
  2624.              DECnet-Rainbow product, but are included on the floppies.
  2625.              Do not copy these files to your Rainbow.
  2626.  
  2627.           -  If you choose to install DECnet files to  floppies  (such
  2628.              that  loading  of  NDDRV.SYS and NPDRV.SYS will be from a
  2629.              floppy on system reboot), DIP  will  insert  a  dummy  --
  2630.              DEVICE=<x>:<path>DECDIP.SYS -- command line in CONFIG.SYS
  2631.              because MS-DOS will fail on loading the first driver  but
  2632.              will succeed on loading subsequent drivers specified.
  2633.  
  2634.           -  Due  to  problems  with  MS-DOS  and  <CTRL/C>  interrupt
  2635.              handling,  if  a  user enters a <CTRL/C> while in DIP and
  2636.              chooses to "terminate" DIP, any saved answers will not be
  2637.              written  to a saved answer file.  The only way to produce
  2638.              a saved answer file is by running DIP to  completion  and
  2639.              saving answers "normally".
  2640.  
  2641.           -  Numerous <CTRL/C>s may cause unpredictable results.
  2642.  
  2643.  
  2644.      2.  The display of disk  usage  after  copying  DECnet  files  is
  2645.          incorrect  when copy path and database paths are specified to
  2646.          be on different devices.
  2647.  
  2648.      3.  If installing DECnet V1.1 and DECnet V1.1  has  already  been
  2649.          installed  at  least  once,  database files do not have to be
  2650.          deleted from the DECnet default database path  (for  example,
  2651.          *.DAT).
  2652.  
  2653.      4.  If DIP is used to install DECnet, an existing DECPARM.DAT (if
  2654.          found  in the specified DECnet database path) will be deleted
  2655.          automatically.
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.                                  2-28
  2673.               SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
  2674.  
  2675.  
  2676. 2.19  C Programming Library
  2677.  
  2678.  
  2679.       o  dnet_conn():
  2680.  
  2681.          This  function's  first  argument  is  a  node  specification
  2682.          string,  such  as a node name or node address.  If the string
  2683.          is a node address, no default access control information will
  2684.          be  passed  with the connect request.  For example, the local
  2685.          node's remote node database will  not  be  searched  to  find
  2686.          access control information that may be set up for this remote
  2687.          node address.
  2688.  
  2689.       o  It is necessary  to  recompile/reassemble  the  V1.1  library
  2690.          sources and produce a new library against which utilities can
  2691.          be  relinked.   This   will   help   to   ensure   that   any
  2692.          inconsistencies  or  incompatibilities  that  exist from V1.0
  2693.          will go away.
  2694.  
  2695.       o  The C code in the  programming  library  uses  long  variable
  2696.          names.  Be sure that your compiler can compile such sources.
  2697.  
  2698.       o  Functions required for DECnet network I/O are  documented  in
  2699.              __________ ____________ _________ ______
  2700.          the DECnet-DOS Programmer's Reference Manual.  In addition to
  2701.          these documented functions, many other undocumented 'support'
  2702.          functions are included as part of the C programming interface
  2703.          library found on the last kit floppy (DNETLIB.SRC).
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.                                  2-29
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.                               CHAPTER 3
  2745.  
  2746.                             MODEM CONTROL
  2747.  
  2748.  
  2749.  
  2750.  
  2751. The information in this chapter is provided for  people  who  want  to
  2752. know  how  modem  control is implemented.  The information is intended
  2753. for people who understand modem operations.
  2754.  
  2755.  
  2756.  
  2757. 3.1  Using Modem Control
  2758.  
  2759. To use modem control for DECnet on your personal computer, you  should
  2760. make  sure that cables and connections conform to the EIA RS-232-C and
  2761. CCITT V.28 and V.24 standards.  (Refer to Section 3.3  of  this  guide
  2762. for information about the cables and interface leads to use with these
  2763. standards.)
  2764.  
  2765. The  following  assumptions  have  been  made  for  this  release   of
  2766. DECnet-DOS:
  2767.  
  2768.       o  Connections that were established  before  turning  the  line
  2769.          state ON will be maintained.
  2770.  
  2771.       o  Connections that still exist when turning the line state  OFF
  2772.          will  be  maintained  (unless  the  data  set is specifically
  2773.          commanded to hangup).
  2774.  
  2775. You should also be aware of the following information:
  2776.  
  2777.       o  In the United Kingdom (UK), the R1 relay in modem  number  2B
  2778.          is held up for approximately 2 seconds in order to bridge the
  2779.          gaps in the ringing signal.  For proper  operation  in  calls
  2780.          that   are  automatically  answered,  the  2-second  hold  up
  2781.          requires that the amount of time from DSR=ON through  DTR=OFF
  2782.          and  back to DSR=ON be at least 5 seconds.  This will avoid a
  2783.          false second call seizure.  (Refer to State 7 in Figure 3-1.)
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.                                  3-1
  2790.                             MODEM CONTROL
  2791.  
  2792.  
  2793.       o  It is assumed that the terminal has two modes of operation:
  2794.  
  2795.           -  data leads only (modem control signals ignored)
  2796.  
  2797.           -  full modem control (modem control signals acknowledged)
  2798.  
  2799.          The data leads only mode is used for local connections,  such
  2800.          as  null  modem  applications.   The  proper mode signals are
  2801.          simulated internally to allow the use  of  a  single  control
  2802.          flow.  You can choose between the two modes by using a set-up
  2803.          parameter.
  2804.  
  2805.  
  2806.  
  2807.  
  2808. 3.2  Modem States
  2809.  
  2810. Figure 3-1 shows the different states for the  modem.   (State  1  and
  2811. State  2  refer  to power ON and internal self test functions, and are
  2812. omitted from this diagram for purposes of clarity.)
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.                                  3-2
  2848.                             MODEM CONTROL
  2849.  
  2850.  
  2851.  Power --> on                          from any state except off
  2852.         |                                         ||
  2853.  ______state 1_ OFFLINE     Line state --> hangup or Line state -->
  2854. off
  2855.         |                           |                      |
  2856.         |                       DTR --> off                |
  2857.         |                       RTS --> off                |
  2858.         |                       TXD --> mark               |
  2859.         |                           |                      |
  2860.         |                           |                      |
  2861.         |                           ________________________ 
  2862.                                      Disconnect DECnet from
  2863.                                       hardware COM device
  2864.    Line State=on                    ________________________ 
  2865. ____________________ 
  2866.  Connect DECnet to
  2867.  hardware COM device
  2868. ____________________ 
  2869.         | 
  2870.    ___ state 3_ IDLE 
  2871.     DTR --> on _________________________________ 
  2872.     RTS --> on _____________                    | 
  2873.    ____________             |                   |
  2874.         ^                   |                   |
  2875.         |                   |                   | 
  2876.         |          Modem Control=FULL   Modem Control=NULL ?
  2877.         |          and DSR --> on ?     (Data Leads Only)
  2878.         |          __________state 5_   __________state 4_ 
  2879.         |                                 Assume
  2880.         |             Start 30 sec         DSR --> on
  2881.         |             and 1 sec            CD  --> on
  2882.         |             timers               CTS --> on
  2883.         |          __________________   __________________ 
  2884.         |               |       |               | 
  2885.         |               |       |               |
  2886.         |               |   >1 sec and          |
  2887.         |               |   CTS --> on and      | 
  2888.         |               |   CD  --> on ?  _______state 6_ 
  2889.         |               |       |          Data Exchange
  2890.         |               |       |         _______________ 
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.                                  3-3
  2906.                             MODEM CONTROL
  2907.  
  2908.  
  2909.         |               |       |               |
  2910.         |               |      ___________state 6_ 
  2911.         |               |         Data Exchange
  2912.         |               |      Transmit if CTS=on
  2913.         |               |      Receive if  CD =on
  2914.         |               |      ___________________ 
  2915.         |               |                    |
  2916.         |         >30 sec or                 | 
  2917.         |         DSR --> off ?              |
  2918.         |               |               DSR --> off or
  2919.         |               |               CD  --> off for >2 sec ?
  2920.         |               |                    |
  2921.         |               |                    |
  2922.         |               |                    |
  2923.         |               |                    |
  2924.         |               |                    |
  2925.         |               |                    |
  2926.         |               |          _____________state 7_
  2927.         |                --------->      Disconnect
  2928.         |                             DTR --> off
  2929.         |                             RTS --> off
  2930.         |                             TXD --> mark
  2931.         |                             Start 5 sec timer
  2932.         |                          _____________________ 
  2933.         |                                | 
  2934.         |                             > 5 sec ? 
  2935.         |________________________________| 
  2936.  
  2937.  
  2938.  
  2939.  
  2940. Figure 3-1:  Modem States
  2941.  
  2942.  
  2943.  
  2944. The following sections explain the modem states that are  detailed  in
  2945. Figure 3-1.
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.                                  3-4
  2964.                             MODEM CONTROL
  2965.  
  2966.  
  2967. 3.2.1  General
  2968.  
  2969.  
  2970. The general states include:
  2971.  
  2972.       o  1, OFF, or MARK - these relate to the negative voltage at the
  2973.          interface pin.
  2974.  
  2975.       o  0, ON, or SPACE - these relate to the positive voltage at the
  2976.          interface pin.
  2977.  
  2978.  
  2979.  
  2980.  
  2981. 3.2.2  State 1
  2982.  
  2983. This state is entered at power on.
  2984.  
  2985.  
  2986.  
  2987. 3.2.3  State 2
  2988.  
  2989. This state is entered if the terminal is on-line.
  2990.  
  2991.  
  2992.  
  2993. 3.2.4  State 3
  2994.  
  2995. This state exits unconditionally to State 4 if  the  data  leads  only
  2996. mode is selected.  If the full modem control mode is selected, State 5
  2997. is entered (as soon as Data State Ready, DSR, has come on).  The  wait
  2998. for  DSR  is  untimed.   State  3  is the state an on line terminal is
  2999. normally in before connection has been established.
  3000.  
  3001. In State 3, the Data Terminal Ready (DTR) and Request  to  Send  (RTS)
  3002. signals  are  turned  on.   In this state, the modem can switch itself
  3003. on-line only if DTR is ON.  The RTS signal is needed by some modems to
  3004. prepare the transmit channel.
  3005.  
  3006.                                  NOTE
  3007.  
  3008.         In some cases (such as private wire), it  is  possible
  3009.         for  DSR  to be ON before DTR is ON.  This is possible
  3010.         if there is a manual connection from the modem to  the
  3011.         line.
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.                                  3-5
  3022.                             MODEM CONTROL
  3023.  
  3024.  
  3025. 3.2.5  State 4
  3026.  
  3027. In this state, the actual signals  from  the  modem  are  ignored  and
  3028. forced internally ON (if the data leads only mode is selected).  State
  3029. 6 is then entered.
  3030.  
  3031.  
  3032.  
  3033. 3.2.6  State 5
  3034.  
  3035. This state is entered only after Data Set Ready  (DSR)  has  come  ON.
  3036. This  indicates that the modem is on-line.  The modem can come on-line
  3037. either automatically or manually.  It will come on-line  automatically
  3038. if  there is a call coming in through the automatic answer unit of the
  3039. modem.  It will come on-line manually when you switch  from  voice  to
  3040. data  after  you  have  established  an incoming or an outgoing manual
  3041. call.
  3042.  
  3043. Once the modem is on-line, two timers are  started.   The  timers  are
  3044. called T1 and T2.  The timers operate as follows:
  3045.  
  3046.       o  T1  protects  against  a  non-data  call.   This  is  a   PTT
  3047.          requirement in Germany.  If no data link has been established
  3048.          within 30 seconds after the modem has gone on-line (State 6),
  3049.          an automatic disconnect is initiated.
  3050.  
  3051.       o  T2 protects against data transfer  within  the  first  second
  3052.          after the modem has gone on-line.  This avoids garbage due to
  3053.          transient effects in some older modems.
  3054.  
  3055.  
  3056. If Clear to Send (CTS) and Carrier Detect (CD) have both come ON,  the
  3057. link is considered established.
  3058.  
  3059.  
  3060.  
  3061. 3.2.7  State 6
  3062.  
  3063. This state is the normal data exchange state of the terminal when  the
  3064. call is established.
  3065.  
  3066.  
  3067.  
  3068. 3.2.8  State 7
  3069.  
  3070. This is the disconnect state.  The disconnect is initiated by loss  of
  3071. carrier  (CD)  for  greater than 2 seconds, or by the loss of Data Set
  3072. Ready (DSR).  The terminal waits 5 seconds, then a new  connection  is
  3073. anticipated  by  entering  State  3.   This sequence provides a proper
  3074. disconnection for all known modems.
  3075.  
  3076.  
  3077.  
  3078.  
  3079.                                  3-6
  3080.                             MODEM CONTROL
  3081.  
  3082.  
  3083. Figure 3-2 illustrates the minimum implementation of the V.24 circuits
  3084. for full duplex modem control.
  3085.  
  3086.  
  3087. INTERNAL DTE                      ISO 2110 MALE               V.24
  3088. SIGNAL NAME                       CONNECTOR PIN               CIRCUIT
  3089. (TYPICAL)            See State 7  NUMBER                      NUMBER
  3090.                      in Figure 2-1
  3091.  
  3092. PROT GND ----------------TT-------->  1   PROTECTIVE GROUND    101
  3093.  
  3094.      TxD -------------|>----------->  2   TRANSMITTED DATA     103
  3095.  
  3096.      RxD -------------<|----------->  3   RECEIVED DATA        104
  3097.  
  3098.      RTS -------------|>----------->  4   REQUEST TO SEND      105
  3099.  
  3100.      CTS -------------<|----------->  5   READY FOR SENDING    106
  3101.  
  3102.      DSR -------------<|----------->  6   DATA SET READY       107
  3103.  
  3104.  SIG GND -------------------------->  7   SIGNAL GROUND        102
  3105.  
  3106.       CD -------------<|----------->  8   RECEIVED LINE        109
  3107.                                           CARRIER DETECT
  3108.  
  3109.      DTR -------------|>----------->  20  DATA TERMINAL        108/2
  3110.                                           READY
  3111.  
  3112.  
  3113.  
  3114.  
  3115. Figure 3-2:  Minimum Implementation of V.24 Circuits for  Full  Duplex
  3116.              Modem Control
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.                                  3-7
  3138.                             MODEM CONTROL
  3139.  
  3140.  
  3141. 3.3  Interface Requirements
  3142.  
  3143. The following tables specify the interface leads which are required to
  3144. use  DECnet-DOS  in asynchronous mode, either with a direct connection
  3145. or with a modem.  (The DECnet software  will  not  monitor  the  modem
  3146. leads  when  direct  connection  is  specified.   This  allows for the
  3147. connection to a remote node using a null modem, a modem eliminator, or
  3148. null  modem cable.  These are cables and devices which may not provide
  3149. all the signal leads required for a modem connection.)
  3150.  
  3151. Following each table is a list of the part numbers  for  the  DEC  EIA
  3152. RS-232 communication cables which will provide these leads.
  3153.  
  3154.  
  3155.  
  3156. Table 3-1:  Asynchronous Mode, Direct Connection
  3157.  
  3158.                                           CCITT V.24     EIA RS-232-C
  3159. Pin No.        Function                   Circuit No.    Circuit No.
  3160.  
  3161. 1              Protective Ground          101            AA
  3162. 2              Transmit Data              103            BA
  3163. 3              Receive Data               104            BB
  3164. 7              Signal Ground              102            AB
  3165.  
  3166. Communication Cables:
  3167.  
  3168. BC22D 6  wire null modem cable (transmit  and  receive  leads  crossed
  3169.          within  cable, eliminating the need for a separate null modem
  3170.          device.)
  3171. BC22E 16 wire modem cable
  3172. BC22F 25 wire modem cable
  3173. BCC14 16 wire modem cable (with thumb screw connectors)
  3174. BCC04 25 wire modem cable (with thumb screw connectors)
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194.  
  3195.                                  3-8
  3196.                             MODEM CONTROL
  3197.  
  3198.  
  3199. Table 3-2:  Asynchronous Mode, Modem Connection
  3200.  
  3201.                                           CCITT V.24     EIA RS-232-C
  3202. Pin No.        Function                   Circuit No.    Circuit No.
  3203.  
  3204. 1              Protective Ground          101            AA
  3205. 2              Transmit Data              103            BA
  3206. 3              Receive Data               104            BB
  3207. 4              Request to Send            105            CA
  3208. 5              Clear to Send              106            CB
  3209. 6              Data Set Ready             107            CC
  3210. 7              Signal Ground              102            AB
  3211. 8              Carrier Detect             109            CF
  3212. 20             Data Terminal Ready        108/2          CD
  3213.  
  3214. Communication Cables:
  3215.  
  3216. BC22E 16 wire modem cable
  3217. BC22F 25 wire modem cable
  3218. BCC14 16 wire modem cable (with thumb screw connectors)
  3219. BCC04 25 wire modem cable (with thumb screw connectors)
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.  
  3248.  
  3249.  
  3250.  
  3251.  
  3252.  
  3253.                                  3-9
  3254.                             MODEM CONTROL
  3255.  
  3256.  
  3257. 3.4  Modem Option Selections
  3258.  
  3259. To use  a  modem  with  the  asynchronous  port,  the  modem  must  be
  3260. configured  to match the line characteristics used by DECnet-DOS.  For
  3261. many modems these will be the standard factory  settings.   Table  3-3
  3262. lists some of the user-selectable options you may find on your modem.
  3263.  
  3264.  
  3265.  
  3266. Table 3-3:  User-selectable Modem Options
  3267.  
  3268.                                                 Setting for Use with
  3269. Option                  Description             DECnet-DOS
  3270.  
  3271. Character Length        No. of bits used to     10 bits -
  3272.                         encode a character.     8  data bits, 1 start
  3273.                                                 bit, and 1 stop bit.
  3274.  
  3275. Speed Indicate/Select   Indicate mode: modem    Indicate  mode.  (Pin
  3276.                         indicates modem         23, CCITT  V.24  111,
  3277.                         speed on pin 12         is never asserted and
  3278.                         (CCITT V.24 112).       pin  12,  CCITT  V.24
  3279.                                                 112, is not monitored
  3280.                                                 by DECnet-DOS.)
  3281.  
  3282. Receive  Responds  to   Allows modem to         Enabled (if you  want
  3283. RDL                     respond to a remote     to  allow  a   remote
  3284.                         digital loopback        modem test).
  3285.                         test request.
  3286.  
  3287. Other selectable modem options should be set according  to  the  modem
  3288. user's  guide  for  the  particular  modem  application you are using.
  3289. (Other  options  include  a  public  switched  line,  a  leased  line,
  3290. asynchronous or synchronous mode, etc.).
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311.                                  3-10
  3312.  
  3313.