home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / APPS / DATACOM / DIVERSEN / SNAAOS2 / SNAAOS2.LST < prev    next >
File List  |  1992-12-30  |  59KB  |  2,129 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                      USER'S GUIDE FOR THE OS/2 SNA OVER ASYNC PROTOTYPE PACKAGE
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                                               December 30, 1992
  22.  
  23.  
  24.                                                                 James J. Martin
  25.  
  26.  
  27.                                                                       F93A/B673
  28.                                                                             RTP
  29.                                                                   JJM at RALVM6
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.   ii  User's Guide for the OS/2 SNA over Async Prototype Package
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.   CONTENTS
  140.   ________
  141.  
  142.  
  143.  
  144.  
  145.  
  146.   ABSTRACT   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  147.  
  148.   INTRODUCTION   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  149.  
  150.   BACKGROUND   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  151.  
  152.   OVERVIEW OF THE OS/2 SNA-A PROTOTYPE   . . . . . . . . . . . . . . . . . .  7
  153.  
  154.   INSTALLATION AND CONFIGURATION OF THE PROTOTYPE  . . . . . . . . . . . . .  9
  155.   Install and configure the hardware.  . . . . . . . . . . . . . . . . . . .  9
  156.   Install the prototype code.  . . . . . . . . . . . . . . . . . . . . . . .  9
  157.   Configure CM for an SDLC data link.  . . . . . . . . . . . . . . . . . .   10
  158.   Configure the rest of SNA as needed.   . . . . . . . . . . . . . . . . .   11
  159.   Configure the async specific options.  . . . . . . . . . . . . . . . . .   11
  160.  
  161.   CURRENT STATUS OF THE PROTOTYPE  . . . . . . . . . . . . . . . . . . . .   15
  162.  
  163.   APPENDICES   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  164.   Appendix A Summary of the Async Protocol   . . . . . . . . . . . . . . .   16
  165.   Appendix B:  Configuration examples  . . . . . . . . . . . . . . . . . .   18
  166.   Appendix C:  Modem configurations  . . . . . . . . . . . . . . . . . . .   25
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                                   Contents  iii
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.   iv  User's Guide for the OS/2 SNA over Async Prototype Package
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                                                               1
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.   ABSTRACT
  339.   ________
  340.  
  341.  
  342.  
  343.  
  344.  
  345.   This document is the user's guide for the SNA-A OS/2 prototype code.  The
  346.   code provided is PROTOTYPE code and is NOT a part of the OS/2 Communications
  347.   Manager product.  All service issues and questions will be handled through
  348.   the SNAASYNC forum on the IBMPC disk.  This package is available on both
  349.   OS2TOOLS and MKTTOOLS disks.  The package is also available on CompuServe via
  350.   the APPC Info Exchange Forum.  The intent is to make the prototype available
  351.   to any (internal and external) OS/2 Communications Manager customers.  If the
  352.   package is distributed to external customers, the following  must be under-
  353.   stood:
  354.  
  355.   o   Distribution/service for this package may be stopped without notice.
  356.  
  357.   o   Communications Manager's service organization MUST NOT BE called for any-
  358.       thing dealing with this prototype.
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.   2  User's Guide for the OS/2 SNA over Async Prototype Package
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.   INTRODUCTION
  406.   ____________
  407.  
  408.  
  409.  
  410.  
  411.  
  412.   SNA-A, also referred to as SNA over async or SDLC over async, is an extension
  413.   to the SNA architecture allowing SNA traffic to flow across asynchronous
  414.   (start/stop) communications lines.  This document is the user's guide for the
  415.   prototype code which enhances OS/2's Communications Manager (EE 1.3 and ES
  416.   1.0) with SNA-A connectivity.  An overview of SNA-A is provided, followed by
  417.   a detailed description of how to install, configure and operate the proto-
  418.   type. Several appendices have been added to provide additional information.
  419.   I would recommend reading section 2 (SNA-A Background) and then Appendix A
  420.   (Summary of the SNA-A protocol) before proceeding with sections 3 through 5
  421.   which discuss the prototype.
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.                                                                 Introduction  3
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.   BACKGROUND
  473.   __________
  474.  
  475.  
  476.  
  477.  
  478.  
  479.   Early SNA simply ignored asynchronous communications. The thinking was that
  480.   synchronous communications (e.g., SDLC) would be sufficient for any PC
  481.   requiring remote connections into an SNA network.  This decision has caused
  482.   many problems for many customers.  Work arounds developed to fill this void
  483.   include protocol converters and (non IBM) SNA implementations which support
  484.   some form of SNA over async communication (such as Hayes autoSync modems).
  485.   Since the PC's inception, there has been a requirement for SNA over async.
  486.  
  487.  
  488.   It is estimated that 40% of all data communications travels across asynchro-
  489.   nous lines. The volume of asynchronous communications will continue to
  490.   increase (as will the demand for SNA over async).  Some reasons for this
  491.   include:
  492.  
  493.   1.  The number of PC's, especially laptops, in use will continue to increase.
  494.  
  495.   2.  The increase use of async dialup information services (e.g., BBS,
  496.       CompuServe, Dow Jones, etc.).
  497.  
  498.   3.  A growing requirement for remote any-to-any connectivity.
  499.  
  500.   However, the key factor which will keep async as the dominant method of
  501.   remote PC communications is technology.  PC technology has generated laptops,
  502.   notebooks, palmtops and pen based machines.  These new forms of PC's are
  503.   forecasted to be the highest growing segments of the PC market.  Each of
  504.   these machines rely heavily (if not solely) on asynchronous communications.
  505.  
  506.  
  507.   Additionally, PC technology has created the "type 2" COM port which provides
  508.   separate tx and rx 16 byte deep FIFO's.  Such ports allow PC's to support
  509.   async data rates of over 38.4 kbps.  All PS/2's are shipped with a type 2 COM
  510.   port on the system board.  The recently released "type 3" COM port (available
  511.   on the system board COM port of the PS/2 MOD 90 and MOD 95) supports normal
  512.   CPU memory mapped I/O or DMA I/O.  Furthermore the port provides hardware
  513.   capabilities for a character hunt mode.  The type 3 COM port will allow the
  514.   PC to support async protocols at  line speeds of 64 kbps comfortably.
  515.  
  516.  
  517.   Modem technology is keeping pace with PC async technology (in fact the modem
  518.   industry is being driven by the PC industry).  The standard PC async modem is
  519.   2400 bps.  Within the next few years, the standard will be 9600 bps modems
  520.   capable of supporting error correcting protocols and compression.  Asynchro-
  521.   nous data link throughputs of 38.4 kbps will become the standard.
  522.  
  523.  
  524.   Two completely new forms of PC communications have emerged: RF modem and
  525.   infrared. RF modem technology has created a new industry: mobile communi-
  526.   cations.  This technology uses cellular and RF packet networks (e.g., the
  527.  
  528.  
  529.   4  User's Guide for the OS/2 SNA over Async Prototype Package
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.   Ardis network) modems which are all async based (at least at the DTE level).
  540.   Infrared technology (available in some palmtops) allows unconnected, line of
  541.   sight point to point communications. To the DTE, the infrared port looks like
  542.   a COM port. Both of these technologies are really "application enablers".
  543.   They will provide the power of PC's to industries (such as the service indus-
  544.   tries) which in the past have not been able to exploit computers.
  545.  
  546.  
  547.   SNA-A will be able to exploit these future technological advances and trends.
  548.   Today, the driving force behind SNA-A is the laptop market.  SNA-A adds value
  549.   by enabling laptops (as well as the existing base of PC's) to be remote SNA
  550.   nodes without having to buy additional hardware adapters, special modems or
  551.   FEP's such as protocol converters. Any SNA customer with a salesforce has a
  552.   requirement to be able to take their SNA applications "on the road".  SNA-A
  553.   is the IBM solution for this requirement.
  554.  
  555.  
  556.   Architecturally, SNA-A is quite simple to understand. SNA-A consists of an
  557.   SNA tower using an SDLC data link, except instead of using synchronous hard-
  558.   ware, it uses asynchronous ports.  Traditional SDLC has an SDLC protocol
  559.   stack driving a low level synchronous MAC (machine access layer).  The MAC
  560.   layer is responsible for sending and receiving frames across the wire.  SNA-A
  561.   uses the same SDLC protocol stack (and consequently uses SDLC frames), but
  562.   substitutes an asynchronous MAC in place of the synchronous MAC. Looking at
  563.   the data on the wire, rather than seeing a bit oriented synchronous data
  564.   stream, you now will see a character oriented start/stop data stream.  At the
  565.   frame level on the wire, you will see SDLC frames using start/stop communi-
  566.   cations.
  567.  
  568.  
  569.   The SNA-A async framing MAC, defined internally by Architecture Working Paper
  570.   (AWP) 224, is based on an ISO standard (3309) which defines  HDLC frame
  571.   formats for start/stop communications.  Appendix A describes the async
  572.   framing technique in detail.
  573.  
  574.  
  575.   Since SNA-A defines a new SNA data link, both nodes must be equipped and con-
  576.   figured properly (both must have async ports and both must have the port con-
  577.   trolled by the same SNA-A data link).  SNA-A can be used with a switched or
  578.   nonswitched line, although it obviously is intended for dial-up lines. The
  579.   typical customer scenario will have many remote SNA-A nodes which period-
  580.   ically dial into an office based SNA node supporting the same SNA-A link.
  581.   Therefore there is a requirement for a SNA node capable of supporting a large
  582.   number of SNA-A ports. More importantly, this SNA "async concentrator" node
  583.   must be scalable with respect to both performance and cost.  Furthermore, if
  584.   the partner LU is not located on this node, either a gateway service or APPN
  585.   network node capability is required to be able to route the session traffic.
  586.  
  587.  
  588.   Current available products which can serve as this async concentrator SNA
  589.   node are AS/400 or OS/2 (via this prototype).  The AS/400 is a very good
  590.   choice since it can support many SNA-A ports.  OS/2 can be used, however it
  591.   has the limitation of supporting only 2 SNA-A ports.  Both the AS/400 and
  592.   OS/2 are capable of being APPN network nodes and consequently can route LU6.2
  593.  
  594.  
  595.                                                                   Background  5
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.   session traffic into a customer's SNA network.  Future IBM SNA products will
  606.   be introduced over the next several years which can also serve in this role.
  607.  
  608.  
  609.   The remote SNA node platforms can be either DOS (using NS/DOS, a memory light
  610.   DOS APPC CPI-C  implementation available in 3Q92) or OS/2 (via this proto-
  611.   type).  Due to the layering within OS/2's Communications Manager, the SNA-A
  612.   data link can be used by all SNA components: 3270 emulator, 5250 emulator,
  613.   APPC/APPN, SNA Gateway.
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.   6  User's Guide for the OS/2 SNA over Async Prototype Package
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.   OVERVIEW OF THE OS/2 SNA-A PROTOTYPE
  672.   ____________________________________
  673.  
  674.  
  675.  
  676.  
  677.  
  678.   The OS/2 SNA-A prototype code relies on the existing SDLC support provided by
  679.   Communications Manager (CM) EE 1.3 and ES 1.0.  A CM SDLC data link requires
  680.   the Multi Protocol Adapter (MPA).  The prototype code has replaced the bottem
  681.   end of the SDLC stack which talked to the MPA and inserted the async framing
  682.   MAC which talks to COM ports.  The prototype will support up to 2 COM ports
  683.   (COM1 and/or COM2).  Examples of COM ports supported:
  684.  
  685.   1.  PS/2 system board COM port
  686.  
  687.   2.  Dual async adapters
  688.  
  689.   3.  MultiProtocol Adapters (MPAs) configured for async
  690.  
  691.   A point which needs to be stressed, the SNA over async support is completely
  692.   separate from the current CM async support (ACDI). In fact with the initial
  693.   release of the prototype (we may or may not fix this), you can not have ACDI
  694.   loaded. Consequently, you can not dedicate one COM port for ACDI and one for
  695.   SNA-A.
  696.  
  697.  
  698.   This new data link (let's call it ADLC) is really fooling CM into thinking
  699.   that it is an SDLC data link.  Therefore, the operation of the ADLC data link
  700.   is done using the SDLC support of CM.  To activate and deactivate the ADLC
  701.   data link, you would use the CM subsystem data link control facilities by
  702.   selecting SDLC.   Also, to configure the ADLC data link, you would use the
  703.   SDLC configuration screens.  When you specify the SDLC Adapter 0, this trans-
  704.   lates to COM1.  SDLC Adapter 1 translates to COM2.
  705.  
  706.  
  707.   Because this new data link shares features of the SDLC stack, it also
  708.   inherits the limitations.  For example, as CM can only support up to 2 SDLC
  709.   ports (and only 1 on AT's),  CM can only drive up to 2 SNA-A ports.  Our
  710.   implementation limits the SDLC stack to support either 2 SDLC ports OR 2 COM
  711.   ports, not 1 of each.  One limitation not inherited is on an AT, CM will be
  712.   able to support 2 SNA-A ports.
  713.  
  714.  
  715.   As with SDLC, the ADLC data link can be used across a switched or unswitched
  716.   link.  A serial cable (either 9 pin "D" shell connector or a 25 pin  RS-232
  717.   connector depending on the machine) is obviously required.  A switched link
  718.   requires a modem and a nonswitched link will require either a modem elimi-
  719.   nator or a NULL modem cable configured to connect 2 serial ports directly
  720.   together.
  721.  
  722.  
  723.   Configuration of the ADLC data link is done using the CM SDLC config panels.
  724.   We have introduced several optional async specific config parameters as well.
  725.   For example, the data rate, the transparency level or an autodial modem
  726.  
  727.  
  728.                                         Overview of the OS/2 SNA-A Prototype  7
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.   command string are configurable options supported by the prototype.  This
  739.   type of configuration data is entered in the config.sys "DEVICE" statement of
  740.   the ADLC device driver.  Configuration will be discussed in detail later in
  741.   this document.
  742.  
  743.  
  744.   Some miscellaneous pieces of information concerning the prototype:
  745.  
  746.   1.  Autobaud detect is not supported (although a later section will explain
  747.       how some modems can provide a work around).
  748.  
  749.   2.  A limited form of transparency level negotiations (see appendix A) has
  750.       been implemented.  The transparency level is configurable however, we are
  751.       not able to dynamically change the transparency level as specified by the
  752.       transparency negotiations protocol.
  753.  
  754.   3.  The max supported data rate is currently 38. 4kbs on 386 PS/2's (however,
  755.       an AT is limited to 4800 bps).
  756.  
  757.   4.  The normal async line configuration (in fact the default) is 8 data bits
  758.       per character, 1 start and 1 stop bit with no parity.
  759.  
  760.   5.  Currently the implementation prevents other async drivers from being
  761.       loaded (e.g., COM02.SYS and ACDI drivers).
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.   8  User's Guide for the OS/2 SNA over Async Prototype Package
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.   INSTALLATION AND CONFIGURATION OF THE PROTOTYPE
  805.   _______________________________________________
  806.  
  807.  
  808.  
  809.  
  810.  
  811.   The steps to install and configure the prototype are summarized below.  We
  812.   will explain each step in detail.
  813.  
  814.   1.  Install/configure the hardware
  815.  
  816.   2.  Install the prototype code
  817.  
  818.   3.  Configure Communications Manager for an SDLC data link
  819.  
  820.   4.  Configure the rest of SNA as needed
  821.  
  822.   5.  Configure the config.sys  async specific options
  823.  
  824.   WARNING:  With the current release of the prototype, make sure that CM's
  825.   async support (ACDI) is not loaded AND OS/2's async device drivers
  826.   (COM01.SYS, COM02.SYS) are not loaded!!!!!!!!!!!
  827.  
  828.  
  829.  
  830.   INSTALL AND CONFIGURE THE HARDWARE.
  831.   ___________________________________
  832.  
  833.   The prototype supports only COM1 or COM2 ports.  Using a reference disk,
  834.   verify that the COM port(s) to be used are setup for either serial 1 (COM1)
  835.   or serial 2 (COM2).  On an L40 (and any other laptop), verify that the COM
  836.   port is activated as well.
  837.  
  838.  
  839.  
  840.   INSTALL THE PROTOTYPE CODE.
  841.   ___________________________
  842.  
  843.   The following assumes CM has been installed with SDLC configured.  The SDLC
  844.   CM support requires 2 modules:
  845.  
  846.   1.  C:\CMLIB\SDLCDD.SYS
  847.  
  848.   2.  C:\CMLIB\DLL\ACSSDDLC.DLL
  849.  
  850.   If you do not have these modules, you can manually pull the files from the
  851.   installation diskettes or you can do a REINST of CM to get them.  The only
  852.   one you will need for SNA-A is ACSSDDLC.DLL.  The prototype code replaces
  853.   SDLCDD.SYS.
  854.  
  855.  
  856.   The prototype has only 1 module which needs to be loaded onto the system.
  857.   This module is effectively replacing the existing SDLC device driver
  858.   (c:\cmlib\sdlcdd.sys).
  859.  
  860.   1.  First, create a new directory c:\cmlib\async
  861.  
  862.  
  863.                              Installation and Configuration of the Prototype  9
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.   2.  Next,  copy the module into this directory using the module name
  874.       "ADLCDD.SYS"
  875.  
  876.   3.  Next, in the file c:\config.sys,  comment out the existing
  877.       DEVICE=C:\CMLIB\SDLCDD.SYS statement if it exists by adding an REM in
  878.       front of the line (REM DEVICE=C:\CMLIB\SDLCDD.SYS).  Then add a new
  879.       device driver statement for the SNA-A device driver
  880.       (DEVICE=C:\CMLIB\ASYNC\ADLCDD.SYS).
  881.  
  882.  
  883.   CONFIGURE CM FOR AN SDLC DATA LINK.
  884.   ___________________________________
  885.  
  886.   In this step, you follow the CM screens to create an SDLC data link.  If one
  887.   exists, you can use it.  The config sequences to do this can be summarized
  888.   as:
  889.  
  890.   1.  Go into the CM main menu
  891.  
  892.   2.  Select Advanced
  893.  
  894.   3.  Select Configuration
  895.  
  896.   4.  Select SNA Feature Profiles
  897.  
  898.   5.  Select Data Link Control Profiles
  899.  
  900.   6.  Select SDLC
  901.  
  902.   7.  Select which adapter you want to use (Adapter 0 implies COM1,
  903.        Adapter 1 implies COM2)
  904.  
  905.   8.  Select if you are creating, changing or displaying the SDLC link
  906.  
  907.   9.  All default SDLC profile configurations are ok, the options which you
  908.       probably need to set:
  909.  
  910.       a.  switched or nonswitched
  911.  
  912.       b.  primary/secondary/negotiable (if unsure select negotiable)
  913.  
  914.       c.  select modem rate (full speed implies 9600 bps, half speed implies
  915.           2400 bps).
  916.  
  917.   10. Hit Enter when done with this screen.  A DSR timeout value of 5 minutes
  918.       is fine.
  919.  
  920.   11. Hit Enter again and select the local station address. Any value 0x01-0xFE
  921.       is fine. Then select an XID repoll and non-XID repoll count
  922.  
  923.   12. Hit Enter and you should get a message indicating the profile has been
  924.       saved.
  925.  
  926.   13. Hit the ESC key until you are prompted to Verify the configuration
  927.  
  928.  
  929.  
  930.   10  User's Guide for the OS/2 SNA over Async Prototype Package
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.   14. After the Verify is completed you need to shutdown CM and bring it back
  941.       up for the config changes to take affect.
  942.  
  943.  
  944.   CONFIGURE THE REST OF SNA AS NEEDED.
  945.   ____________________________________
  946.  
  947.   Configure your SNA node as needed.  Whenever you need to map a logical link
  948.   to the ADLC data link, use SDLC.  For example, the following is an excerpt
  949.   from a wrkbase.ndf file (e.g., NS/2) defining a logical link using the COM1
  950.   port.
  951.  
  952.     DEFINE_LOGICAL_LINK  LINK_NAME(ASYNCLNK)
  953.                   ADJACENT_NODE_TYPE(LEARN)
  954.                   DLC_NAME(sdlc)
  955.                   ADAPTER_NUMBER(O)
  956.                   CP_CP_SESSION_SUPPORT(YES)
  957.                   ACTIVATE_AT_STARTUP(NO)
  958.                   PREFERRED_NN_SERVER(NO)
  959.                   LIMITED_RESOURCE(NO)
  960.                   LINK_STATION_ROLE(USE_ADAPTER_DEFINITION)
  961.                   FQ_ADJACENT_CP_NAME(USIBMSER.ASYNC_O1)
  962.                   COST_PER_CONNECT_TIME(USE_ADAPTER_DEFINITION)
  963.                   COST_PER_BYTE(USE_ADAPTER_DEFINITION)
  964.                   DESCRIPTION(Sample sdlc link to served EN);
  965.  
  966.   This link definition would be necessary only if the SNA-A link defines a
  967.   logical link to an adjacent network node.
  968.  
  969.  
  970.   If you are going to configure the 3270 emulator to use the ADLC data link,
  971.   simply configure the emulator to use SDLC. Likewise for the SNA Gateway.
  972.   Refer to Appendix B for configuration examples.
  973.  
  974.  
  975.  
  976.   CONFIGURE THE ASYNC SPECIFIC OPTIONS.
  977.   _____________________________________
  978.  
  979.   Since this prototype did not touch any higher layer code of CM (e.g., the
  980.   configuration code), we needed a mechanism by which we can configure async
  981.   related options specific to the ADLCDD data link.  We used OS/2's mechanism
  982.   of supplying parameters to device drivers at initialization time.  In
  983.   config.sys, each "DEVICE" statement can have an ascii string of characters
  984.   which is made available to the device driver. The negative of this mechanism
  985.   is whenever you want to change one of the config params, you must reboot the
  986.   machine.  The positive side, is that for normal use, these async specific
  987.   config options are not necessary.  The default values for most situations
  988.   should be sufficient so that no parameters are required.
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.                             Installation and Configuration of the Prototype  11
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.     All config options must be entered in the following
  1009.          format:   "/"<command id>{port id}="data"
  1010.  
  1011.     For example:
  1012.              DEVICE=C:\cmlib\async\adlcdd.sys /N0=1  /T=2
  1013.  
  1014.     **********************************************************
  1015.     *WARNING: There can not be any spaces in this line except
  1016.     *         between config options. There CAN NOT be any
  1017.     *         spaces within a config option!!!!!!!!!!!!!!!!!!
  1018.     **********************************************************
  1019.  
  1020.   Some comments concerning the command line syntax:
  1021.  
  1022.       The command id (in our example, N and T) specifies the config option.  It
  1023.       must be in capital letters.
  1024.  
  1025.       The port id is optional.  This specifies which port (0 or 1) the config
  1026.       option will apply to.  If this is not specified then the option will be
  1027.       done to both ports.
  1028.  
  1029.       Port 0 maps to COM1 and Port 1 maps to COM2!!!!!!!!!!!!!
  1030.  
  1031.       The data field is the data for the command.  It usually will be a single
  1032.       character.
  1033.  
  1034.   If an option command is not in the correct format, the prototype simply
  1035.   ignores it- no error message is generated!!!!!!!!!!!!!!!!  So if you are
  1036.   trying to autodial but nothing is happening, recheck the syntax of the config
  1037.   command.  The most likely problem is a blank space used.
  1038.  
  1039.  
  1040.   Available option commands and data values:
  1041.  
  1042.  
  1043.      /T<O|1>={O|1|2}  This specifies the transparency level
  1044.                       to be used.  Note that a different level
  1045.                       might be negotiated.
  1046.                       The data:
  1047.                           O implies Basic transparency
  1048.                           1 implies Flow control transparency
  1049.                           2 implies Full transparency
  1050.  
  1051.   Refer to Appendix A which explains the async protocol.  Transparency is
  1052.   described there.
  1053.  
  1054.  
  1055.   The default is flow control and will be used in 99% of the time.  In fact,
  1056.   the default for all current SNA-A implementations (PCS,AS/400,NS/DOS and
  1057.   OS/2) is flow control transparency.
  1058.  
  1059.  
  1060.   Full transparency implies control character transparency and 7 bit data (as
  1061.   opposed to 8 bit data) using 1 start, 1 stop bit and even parity.  Note that
  1062.  
  1063.  
  1064.   12  User's Guide for the OS/2 SNA over Async Prototype Package
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.   Basic and flow control transparency implies 8 bit data, 1 start, 1 stop bit,
  1075.   no parity.
  1076.  
  1077.  
  1078.     /N<O|1>={O|1|2} This configures transparency negotiations
  1079.                     to be performed by the node.
  1080.                         O   implies transparency negotiations
  1081.                             are disabled.
  1082.                         1   implies transparency negotiations
  1083.                             are enabled and this node will
  1084.                             act as the calling party.
  1085.                         2   implies transparency negotiations
  1086.                             are enabled and this node will
  1087.                             act as a called party.
  1088.  
  1089.   Refer to Appendix A for a description of transparency negotiations.
  1090.  
  1091.  
  1092.   For a switched connection, the default is transparency negotiations are
  1093.   enabled and the role (caller or called party) does not matter (it is deter-
  1094.   mined dynamically).
  1095.  
  1096.   For unswitched, the default is to disable transparency negotiations.  If you
  1097.   want to enable transparency negotiations for an unswitched line, you must use
  1098.   this config param and the 2 partners must be configured with different roles
  1099.   (one must be a caller and one must be a called).
  1100.  
  1101.  
  1102.   The only time you need to use this config option is if you are unswitched and
  1103.   you want transparency negotiations.  If you want to connect with PCS and
  1104.   NS/DOS over an unswitched, you must configure the OS/2 node with transparency
  1105.   negotiations enabled and and as a called party (/N=1).  This is because both
  1106.   PCS and NS/DOS require transparency negotiations and are limited to being a
  1107.   caller only.  If you are connecting to an AS/400 over an unswitched line (if
  1108.   going over a switched line you don't need this config param), you must con-
  1109.   figure this OS/2 node with transparency negotiations enabled and as a caller
  1110.   (/N=2).  This is because the AS/400 requires all partners to implement trans-
  1111.   parency negotiations and it assumes a called party role.
  1112.  
  1113.  
  1114.     /B<O|1>={O|1|2|3|4|5}  This configures the data rates.
  1115.          data rate values:
  1116.               O: 12OO;
  1117.               1: 24OO;
  1118.               2: 48OO;
  1119.               3: 96OO;
  1120.               4: 19.2k;
  1121.               5: 38.4k;
  1122.  
  1123.   If the CM config option "full speed" is set, then the data rate used is the
  1124.   option provided.  If configured for half speed, we drop the data down by 2
  1125.   speeds.  For example, if you use /B=3 (9600 bps) but have the config option
  1126.   set for half speed, then the actual data rate will be 2400 bps.
  1127.  
  1128.  
  1129.  
  1130.                             Installation and Configuration of the Prototype  13
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.   Exceptions to this are if you specify config line options of 1200 or 2400
  1141.   bps.  If you use /B=1 (2400), then for half speed this results in a data rate
  1142.   of 1200 bps.  If you use /B=0 (1200), then half speed has no effect- the data
  1143.   is still 1200 bps. Therefore, the lowest speed the prototype supports is 1200
  1144.   bps.
  1145.  
  1146.  
  1147.   The default (if no config params are given) will be 9600 bps for full speed,
  1148.   2400 bps for half speed.
  1149.  
  1150.  
  1151.     /D<O|1>="{ascii string up to 128 characters}"
  1152.            This is a modem init string which is output
  1153.            to the modem at each link activation.   Autodial
  1154.            can be performed this way.  For example, if you
  1155.            wanted to auto dial the phone # 9-123-4567 out COM1
  1156.            port, the config data should be:
  1157.                  /DO="AT DT 9-123-4567"
  1158.  
  1159.        ********************************************************
  1160.        * WARNING:  Be careful of illegal spaces.  For example,
  1161.        *           the following is not allowed:
  1162.        *                 /D0= "AT DT 9-123-4567"
  1163.        ********************************************************
  1164.  
  1165.   The string must be encased in quotes.  The first 2 ascii characters of the
  1166.   string must be AT to wakeup the AT command set of the modem.  The string must
  1167.   be a valid AT command string.  Mulitple commands can be sent in the same
  1168.   string.  For example, if you wanted to keep the same autodial command, AND
  1169.   you want to enable the speaker audio output from the modem ..
  1170.  
  1171.   /D0="AT M1 DT 9-123-4567"
  1172.  
  1173.  
  1174.   Consult the users guide of the modem for a description of the AT command set
  1175.   (or any other commands the modem can respond to).  Also refer to Appendix C
  1176.   for configuration information for particular modems.
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.   14  User's Guide for the OS/2 SNA over Async Prototype Package
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.   CURRENT STATUS OF THE PROTOTYPE
  1207.   _______________________________
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.   We have tested the prototype as follows..
  1214.  
  1215.   1.  up to 38.4 kbps on an unswitched link
  1216.  
  1217.   2.  up to 9600 bps on a switched link
  1218.  
  1219.   We have tested with the following modems ..
  1220.  
  1221.   1.  IBM 5853 and 7855
  1222.  
  1223.   2.  L40's internal modem
  1224.  
  1225.     (note: see Appendix C for details on configuring these modems.)
  1226.  
  1227.  
  1228.  
  1229.   The following is planned on being added to the prototype in the near future:
  1230.  
  1231.   1.  Add modem to DTE flow control so that modem features such as modem to
  1232.       modem error correcting protocols and modem compression can be supported.
  1233.  
  1234.   The following are known bugs:
  1235.  
  1236.   1.  For version ES 1.0, autodial does not work (it does work in EE 1.3
  1237.       however). This will be fixed in the next release.
  1238.  
  1239.   2.  For OS/2 (versions 1.3), if a session is active across the ADLC data link
  1240.       (e.g., an APPC TP), and then if you go into the DOS box the TP will end
  1241.       in an error although the data link remains alive.
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.                                             Current Status of the Prototype  15
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.   APPENDICES
  1274.   __________
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.   APPENDIX A SUMMARY OF THE ASYNC PROTOCOL
  1284.   ________________________________________
  1285.  
  1286.   SNA-A implies an SDLC stack driving an async MAC.  The async MAC is based on
  1287.   an ISO standard (3309) for HDLC framing across start/stop communications
  1288.   lines.  The framing MAC can be summarized as follows:
  1289.  
  1290.  
  1291.   The frame format used across the wire is the same as that defined by SDLC and
  1292.   HDLC with 2 exceptions:
  1293.  
  1294.   1.  start and stop bits that delimit each character
  1295.  
  1296.   2.  characters inserted for transparency as opposed to bit insertion tech-
  1297.       niques
  1298.  
  1299.   The HDLC/SDLC frame format is illustrated below:
  1300.  
  1301.     __________________________________________________________
  1302.     |  FLAG  | ADDR | CONTROL|      I field     | FCS |  FLAG |
  1303.     ----------------------------------------------------------
  1304.  
  1305.   The difference between an SDLC frame and an SDLC over async frame is that
  1306.   SNA-A frames are no longer a synchronous bit stream.  The bit stream is
  1307.   divided into characters (typically 8 bits per character) with each character
  1308.   surrounded with a start and stop bit.  Therefore, this protocol immediately
  1309.   has a 20 percent performance loss over traditional SDLC due to the overhead
  1310.   involved with the S/S bits.  Although, modems which implement error cor-
  1311.   recting protocols (e.g., MNP) use synchronous communications across the wire.
  1312.   This will not eliminate the performance degradation (due to the overhead
  1313.   involved with the modem protocol) but it will normally be less than  20%.
  1314.  
  1315.  
  1316.  
  1317.   Traditional SDLC (and HDLC) uses bit insertion and bit deletion for data
  1318.   transparency.  This means that if the flag symbol (6 consecutive 1's followed
  1319.   by a 0) occurs within a frame (in between the start and stop flags), the
  1320.   transmitter will insert a 0 after the fifth consecutive 1 to hide the flag
  1321.   sequence.  If the receiver receives 5 consecutive 1's followed by a 0, then
  1322.   it will delete the 0 from the data stream.  This guarantees that the flag
  1323.   symbol will never occur within a frame.
  1324.  
  1325.  
  1326.   The SNA-A version of transparency is character oriented rather than bit ori-
  1327.   ented. For example, if the flag character occurs in the frame (a flag is the
  1328.   character 0x7E), we hide the character with the use of an escape character
  1329.  
  1330.  
  1331.   16  User's Guide for the OS/2 SNA over Async Prototype Package
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.   followed by the original character with its sixth bit inverted.  Hence the
  1342.   framing protocol has the essence of older character oriented data link proto-
  1343.   cols such as BSC.
  1344.  
  1345.  
  1346.   However this introduces another special character (the escape character)
  1347.   which must also be hidden if it occurs in the frame.  Therefore the following
  1348.   character transparency  is performed by the transmitter.
  1349.  
  1350.   o   (FLAG) 0x7E  ->  gets transmitted as  0x7D, 0x5E
  1351.  
  1352.   o   (ESCAPE) 0x7D  ->  gets transmitted as  0x7D, 0x5D
  1353.  
  1354.   This is known as the basic transparency level.
  1355.  
  1356.  
  1357.   The ISO standard (and the IBM architecture) identifies 2 further levels of
  1358.   character transparency.  Each further level is optional and the partners must
  1359.   either negotiate or must be statically configured to operate at the same
  1360.   transparency level.
  1361.  
  1362.  
  1363.   Flow control transparency is meant to hide XON/XOFF characters within the
  1364.   frame.  Obviously, this level of transparency is used if XON/XOFF flow
  1365.   control  active.  All IBM implementations use this level of transparency as
  1366.   the default level.  Flow control transparency is defined as:
  1367.  
  1368.   o   (XON) 0x11   -> gets transmitted as 0x7D, 0x31
  1369.  
  1370.   o   (XOFF)0x13   -> gets transmitted as 0x7D, 0x33
  1371.  
  1372.   o   (FLAG) 0x7E   -> gets transmitted as  0x7D, 0x5E
  1373.  
  1374.   o   (ESCAPE) 0x7D   -> gets transmitted as  0x7D, 0x5D
  1375.  
  1376.   The final level of character transparency is control character transparency.
  1377.   This is meant to hide non-ascii characters.  It includes basic and flow
  1378.   control transparency.  Additionally, characters in the range 0x00-0x1f plus a
  1379.   0x7f character get hidden using the same transparency method as defined
  1380.   above.
  1381.  
  1382.  
  1383.   In addition to character transparency, the async framing protocol handles 7
  1384.   bit data networks.  7 bit data transparency is a technique allowing 8 bit
  1385.   characters to flow across a 7 bit async data wire.  7 bit data transparency
  1386.   must be either negotiated dynamically at link bringup or statically config-
  1387.   ured.
  1388.  
  1389.  
  1390.   The transparency algorithm  is fairly straight forward.  The source data (8
  1391.   bit characters) is divided into blocks of 7 characters.  For each block of 7
  1392.   characters sent out on the wire, an eighth character is additionally trans-
  1393.   mitted.  This eighth character, the suffix byte, contains the most signif-
  1394.   icant bit of each preceeding 7 bytes of the source block.  The receiver would
  1395.  
  1396.  
  1397.                                                                  Appendices  17
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.   need to collect the first 7 characters of each incoming block and when the
  1408.   8'th character is received, it regenerates the original 7 data bytes.
  1409.  
  1410.  
  1411.   If the source block contained less than 7 characters (e.g., the final block
  1412.   of a frame), the suffix character would have its most significant bits (ie.,
  1413.   the unused bits) cleared.  The receiver detects this case if it receives the
  1414.   end of frame flag and if it has not received a full 7 byte block of charac-
  1415.   ters.
  1416.  
  1417.  
  1418.   When a link is activated, prior to any SNA XID exchanges, a process know as
  1419.   transparency negotiations is performed.  Transparency negotiations (which is
  1420.   not a part of the ISO standard) allows 2 partners to negotiate:
  1421.  
  1422.   1.  data rate
  1423.  
  1424.   2.  character format (7 or 8 bits/character, even/odd or no parity)
  1425.  
  1426.   3.  the transparency level (basic,flow or full: full transparency implies
  1427.       control character transparency plus 7 bit data transparency).
  1428.  
  1429.   Transparency negotiations works as follows.  There is a called party and a
  1430.   caller party (this is the transparecy role configured for the station).
  1431.   Several IBM SNA-A products have a fixed transparency role.  For example,
  1432.   NS/DOS is always a caller and AS/400 is always a called party.  The OS/2 pro-
  1433.   totype can be either or none, it is a configurable option (using the "/N"
  1434.   config parameter).
  1435.  
  1436.  
  1437.   The caller party ALWAYS initiates the link bringup.  It will xmit a series of
  1438.   NULL XID frames. Once the called party has received 3 good NULL XID frames,
  1439.   it responds by xmitting a matching series of NULL XID frames.  Since it is a
  1440.   known pattern being sent, the called party can do autobaud detect.  The frame
  1441.   is sent by the caller using its desired transparency level.  All IBM products
  1442.   use either flow control or full transparency.  The called party is able to
  1443.   determine the tranparency level by looking at the NULL XID data.  After this
  1444.   exchange of NULL XID's, normal SNA XID exchange occurs and the link comes up.
  1445.  
  1446.  
  1447.  
  1448.  
  1449.   APPENDIX B:  CONFIGURATION EXAMPLES
  1450.   ___________________________________
  1451.  
  1452.   The OS/2 prototype can currently connect with:
  1453.  
  1454.   1.  another OS/2 machine also configured with the ADLC link
  1455.  
  1456.   2.  NS/DOS configured with the async router
  1457.  
  1458.   3.  AS/400 (limited to just APPC over async)
  1459.  
  1460.   1.To connect OS/2 to OS/2:
  1461.  
  1462.  
  1463.  
  1464.   18  User's Guide for the OS/2 SNA over Async Prototype Package
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.   For a switched connection, no config.sys DEVICE parameters are necessary.
  1475.   Select half speed in the SDLC adapter config if using 2400 bps modems.  Oth-
  1476.   erwise, full speed implies 9600 bps.  Although, if you want autodial enabled,
  1477.   you must have the "/D" config.sys parameter.
  1478.  
  1479.  
  1480.   For an unswitched connection, if no config.sys parameters are used, the
  1481.   default is to bypass the transparency negotiations.  If you want to enable
  1482.   transparency negotiations, you must specify the "/N" parameter, and you must
  1483.   make one partner a caller and the other a called party!!!!!
  1484.  
  1485.  
  1486.   The OS/2 3270 emulator can be configured with the ADLC data link.  You can
  1487.   configure an office based machine which has, for example, an upstream T/R
  1488.   connection to a host as a SNA gateway with downstream ADLC connections to
  1489.   remote 3270 sessions.  The trick to this configuration is each ADLC data link
  1490.   configuration must be configured for a max RU size to be the same as the max
  1491.   RU size used in the upstream T/R connection to the host.
  1492.  
  1493.  
  1494.   2.Connecting NS/DOS to OS/2:
  1495.  
  1496.  
  1497.   NS/DOS supports only a secondary SDLC link station only.  Therefore, make
  1498.   sure to configure the OS/2 ADLC link as either negotiable or primary role.
  1499.  
  1500.  
  1501.   NS/DOS requires a partner to participate in transparency negotiations.
  1502.   Therefore on a switched data link, do not disable transparency negotiations.
  1503.   Since the OS/2 prototype  learns dynamically what transparency negotiations
  1504.   role it must be, you don't have to specify the role.  However, if using an
  1505.   unswitched connection, you must specify the OS/2 station to be the called
  1506.   party (e.g., /N=2).  NS/DOS is always going to be a caller role.  Note that
  1507.   this also implies OS/2 can not initiate the connection.  It must be NS/DOS
  1508.   which initiates a connection, this is true for both switched and unswitched
  1509.   connections.
  1510.  
  1511.  
  1512.   THEREFORE, you must not enable autodial on the OS/2 side!!!!!
  1513.  
  1514.  
  1515.   The following is a sample NS/DOS CONFIG.NSD for SDLC over Async connection to
  1516.   OS/2.
  1517.  
  1518.     NSDC ASYN
  1519.     NSDN USIBMZP1.JOE
  1520.     SDLD RALAS101,01
  1521.     SDLF HALF
  1522.     ASBR 2400
  1523.     //IF THE PCs ARE DIRECTLY CONNECTED ..
  1524.     //SDLT NONSWTPP
  1525.     //IF MODEMS ARE USED ..
  1526.     SDLT SWTPP
  1527.     SWAD ATDT 9-123-4567
  1528.  
  1529.  
  1530.                                                                  Appendices  19
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.   3.Connecting OS/2 to AS/400:
  1543.  
  1544.  
  1545.   The AS/400 implementation requires OS/2 to be configured as a secondary link
  1546.   station.
  1547.  
  1548.  
  1549.   If you are using NS/2, the OS/2 SNA node must be configured as an end node
  1550.   (EN) and NOT a network node (NN).
  1551.  
  1552.  
  1553.   The AS/400 requires all partners to participate in transparency negotiations.
  1554.   Using a switched link, a "/N" parameter is not necessary since the OS/2 pro-
  1555.   totype will default to using transparency negotiations over a switched link.
  1556.   For an unswitched connection, you must configure the OS/2 SNA-A data link to
  1557.   be enable transparency negotiations and to be a caller role (e.g., "/N=1").
  1558.   The AS/400 is always a called party.  Note this implies the AS/400 can not
  1559.   initiate a connection- it must be the OS/2 side.
  1560.  
  1561.  
  1562.   The AS/400 SNA-A support was originally done just to support PC/Support on
  1563.   DOS.  It does work with our OS/2 SNA-A implementation.  To configure the
  1564.   AS/400 side, you can make use of some configuration tools which were really
  1565.   for PCS, but we can use them as well.  PCS simply provides a user friendly
  1566.   front end to create several "descriptions" required by the AS/400 APPC imple-
  1567.   mentation.
  1568.  
  1569.  
  1570.   The following shows how to configure the AS/400 using the PCS config tools.
  1571.   We show each config screen.  You can accomplish the same without PCS by manu-
  1572.   ally creating the descriptions.
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.   20  User's Guide for the OS/2 SNA over Async Prototype Package
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.     AS/4OO Side
  1607.     -----------
  1608.     Add a PC support user
  1609.     - On the AS/4OO Main Menu, select option 11,
  1610.       PC Support tasks.
  1611.     - Select option 21, Enroll PC Support users.
  1612.     - You will need to fill out the User profile and
  1613.       User ID fields. Both of these fields should be
  1614.       to match the partner's network name.
  1615.     - The Address field should automatically default to the
  1616.       name by which the AS/4OO is known on the network.
  1617.     - Press Enter and you should return to the PC Support
  1618.       Task menu.
  1619.     ----------------------------------------------------
  1620.                               Enroll PC Support Users
  1621.  
  1622.        Type choices, press Enter.
  1623.  
  1624.          User profile . . . . . .  JOE
  1625.          User identifier:
  1626.            User ID  . . . . . . .  JOE
  1627.            Address  . . . . . . .  RALAS1O1
  1628.          User description . . . .  Joe Smiths access to system.
  1629.  
  1630.  
  1631.  
  1632.  
  1633.       F3=Exit   F12=Cancel
  1634.     ---------------------------------------------------------
  1635.     Configure PC support connections.
  1636.     - From the PC Support Task menu, select option 22,
  1637.       Configure PC Connections.
  1638.     - Select option 5 for Asynchronous communications.
  1639.     - On the Add PC to ASYNC connection screen you will need
  1640.       to supply the following information.
  1641.     Device Description - This is the network name of the
  1642.                          partner SNA-A node.
  1643.     Port number        - This is the port on the AS/4OO work
  1644.                          station controller that the line from
  1645.                          the PC is physically connected to.
  1646.                          This must match.
  1647.     Attachment type    - This is the type of attachment you
  1648.                          will be using.  This can be either
  1649.                          direct or through a modem.
  1650.     Attached controller- Specifies the name of the controller
  1651.                          to which the device is connnected.
  1652.                          The first available controller name
  1653.                          is the default.  PF4 will display a
  1654.                         list of ASCII workstations controllers
  1655.                          on your system.
  1656.                          SNA-A can only communicate through an
  1657.                          AS/4OO ASCII workstation controller.
  1658.  
  1659.     --------------------------------------------------------
  1660.  
  1661.  
  1662.                                                                  Appendices  21
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.                        Add PC to ASYNC Connection
  1673.  
  1674.     Type choices, press Enter.
  1675.  
  1676.     Device description . . .JOE      Name
  1677.     Port number  . . . . . .1        O-17
  1678.     Attachment type  . . . .*MODEM   *MODEM, *DIRECT, *PTT
  1679.     Attached controller  . .CTLO2    Name, F4 for list
  1680.     F3=Exit   F4=Prompt   F12=Cancel
  1681.  
  1682.     ---------------------------------------------------
  1683.  
  1684.     To configure or add a SNA-A connection attached to
  1685.     an ASCII work station controller on your AS/4OO system,
  1686.     you must  create a configuration description
  1687.     for the partner on the AS/400.
  1688.  
  1689.     To create a configuration description, go to the Work with
  1690.     Device Device Descriptions display.
  1691.     1) On any display with a cmd line, type WRKDEVD *LCLDSP.
  1692.     2) On the Work with Device Descriptions display, press
  1693.        PF6 (CREATE).
  1694.     You will need to supply the following information.
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.   22  User's Guide for the OS/2 SNA over Async Prototype Package
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.     Device description- Specifies the user defined name
  1740.                       of the device description.
  1741.     Device class    - Specifies the device class for the PC.
  1742.                       Enter *LCL for this field.
  1743.     Device type     - Specifies the type of device which the
  1744.                       description represents. Enter 515O
  1745.                       for this field.
  1746.     Device model    - Specifies the model number of the device
  1747.                       for this description. Enter A1
  1748.                       for this field.
  1749.     Port number     - Must match the physical port to
  1750.                     which the modem or line is attached on the
  1751.                       AS/4OO.  Read the "Determining the ASCII
  1752.                       port address" section which follows to
  1753.                       determine an available port number.
  1754.     Physical attachment - Used to describe whether the
  1755.                           partner is directly attached to the
  1756.                           AS/4OO or through a modem.
  1757.     Online at IPL  - Specifies if device should be
  1758.                      automatically varied online at IPL.
  1759.                      Use the default of *YES.
  1760.     Attached controller - The attached ASCII Controller name.
  1761.                           Read the "Determining the ASCII port
  1762.                           address" section which follows to
  1763.                           determine the correct attached
  1764.                            controller.
  1765.     Keyboard language type- Specifies the country keyboard
  1766.                           laguage identifier for the attached
  1767.                           PC. Enter the default of *SYSVAL.
  1768.     Inactivity timer  - Specifies a inactivity timeout value
  1769.                         for the attached  PC.  Change this
  1770.                         value to *NOMAX and press Enter.
  1771.     Line speed        - Specifies baud rate of communications.
  1772.                         change this  value to *CALC.
  1773.     Word length       - Change this value to *CALC.
  1774.     Type of parity    - Change this value to *CALC.
  1775.     Stop bits         - Change this value to 1.
  1776.     Maximum outstanding frames - Accept the default of 7
  1777.     Idle timer            - Accept the default of 4O.
  1778.     ------------------------------------------------
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.                                                                  Appendices  23
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.                  Create Device Desc (Display) (CRTDEVDSP)
  1805.  
  1806.     Type choices, press Enter.
  1807.  
  1808.     Device description .  .   ASYNCPC Name
  1809.     Device class . . . .  .   *LCL    *LCL, *RMT, *VRT
  1810.     Device type  . . . .  .   515O    31O1, 3151, 3161, 3162.
  1811.     Device model . . . .  .   A1      O, 1, 2, 4, 11, 12, 23.
  1812.     Port number  . . . .  .   1       O-17
  1813.     Switch setting . . .  .   ______  O, 1, 2, 3, 4, 5, 6
  1814.     Physical attachment   . . *MODEM  *DIRECT, *PTT, *MODEM.
  1815.     Online at IPL  . . .  . . *YES    *YES, *NO
  1816.     Attached controller  .  . CTL02   Name
  1817.     Keyboard language type  . *SYSVAL *SYSVAL, AGB, AGI, BLI
  1818.     Inactivity timer . . .  . *NOMAX  1-3O, *ATTACH, *NOMAX.
  1819.     Line speed . . . . . .  . *CALC   *TYPE, *CALC, 15O, 3OO.
  1820.     Word length  . . . . .  . *CALC   *TYPE, *CALC, 7, 8
  1821.     Type of parity . . . .  . *CALC  *TYPE, *CALC, *EVEN,*ODD.
  1822.     Stop bits  . . . . . .  . 1       *TYPE, 1, 2
  1823.     Maximum outstanding frames . 7       1-7
  1824.     Stop bits  . . . . . . . 4O      1O-5O (O.1 seconds)
  1825.                                                   More...
  1826.     F3=Exit F4=Prompt F5=Refresh F12=Cancel
  1827.     F13=How to use this display F24=More keys
  1828.  
  1829.     --------------------------------------------------
  1830.  
  1831.   DETERMINING THE ASCII PORT ADDRESS FOR ASYNCHRONOUS CONNECTION
  1832.  
  1833.  
  1834.   The following steps show you how to determine which addresses are available
  1835.   on a particular port on a particular ASCII work station controller card on
  1836.   the AS/4OO.
  1837.  
  1838.   1.  Determine which controller is associated with the particular ASCII con-
  1839.       troller card on the AS/4OO.  Using the Work with Controller Description
  1840.       (WRKCTLD) command, you can view a list of all the controllers on your
  1841.       system.  Controllers of the following types are associated with a ASCII
  1842.       card:  2637, 6O41, 6141.
  1843.  
  1844.   2.  Once you have found the controller name you must determine the available
  1845.       addresses for each port on the twinaxial card.  This can be done by
  1846.       entering the Print Device Address command (PRTDEVADR) and specifying the
  1847.       controller name determined in step 1. This program creates a spool file
  1848.       which can be viewed by issuing the Work with Spool Files (WRKSPLF)
  1849.       command.  The file should have a filename of QPDCDEVA.
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.   24  User's Guide for the OS/2 SNA over Async Prototype Package
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.   APPENDIX C:  MODEM CONFIGURATIONS
  1871.   _________________________________
  1872.  
  1873.   Modem configuration will most likely be the leading cause of problems in
  1874.   getting a SNA-A data link up.  Modem configuration can be quite complicated.
  1875.   There are entire books written on the subject.  The following are some sug-
  1876.   gestions and some potential pitfalls:
  1877.  
  1878.   1.  use a default Hayes AT base profile
  1879.  
  1880.   2.  the modem must assert DSR at connect time- it can not be asserted all the
  1881.       time. You can use the AT command AT &S1 to do this.
  1882.  
  1883.  
  1884.       NOTE: for L40 internal modem users, you must do this.  The L40 user's
  1885.       manual does not document support for the &S AT command-  however the
  1886.       modem does support it!  The default for the modem is &S0- this will cause
  1887.       a data link failure! You change this in one of 2 ways.  First, using some
  1888.       type of communications program and issue the AT command &S1  AND then
  1889.       issue a &W0 to save this in profile 0 to save this change.  Or you can
  1890.       add    the command &S1 to the modem initialization string.  Let's say you
  1891.       wanted to autodial 123-4567 and you want to issue the &S command. The
  1892.       config.sys DEVICE line would be:  DEVICE=C:\CMLIB\ASYNC\ADLCDD.SYS /D0=
  1893.       "AT &S1 DT 123-4567"
  1894.  
  1895.  
  1896.   3.  AT S register 0 must be nonzero if you want auto answer So, you can add
  1897.       the following to the /D string: "AT S0=1"
  1898.  
  1899.  
  1900.   4.  Currently (4/29/92), MNP protocols, V.42 protocol and any compression
  1901.       (MNP 5, V.42bis) must be disabled in the modem until we support modem to
  1902.       DTE flow control.
  1903.  
  1904.   Another aspect of modems which needs clarification deals with the various
  1905.   terms floating around for serial line (either asynchronous or synchronous)
  1906.   speeds. There are 3 aspects associated with a line speed:  baud rate, bits
  1907.   per second and throughput. Each of these can be used to describe different
  1908.   perspectives of line speeds.
  1909.  
  1910.  
  1911.   The baud rate describes the rate of signalling changes which occur across the
  1912.   wire.   The baud depends entirely on the modulation technique being used.
  1913.   There is not a one-to-one corresponence between a modulation signal change
  1914.   and an information bit (ie. a data bit).  For example,  the CCITT standard
  1915.   for 2400 bps modem modulation (V.22bis) uses a 600 baud  modulation technique
  1916.   (Quadrature Amplitude Modulation, or QAM) which encodes 4 bits of information
  1917.   in a signal change.  For our purposes, the baud rate is entirely a function
  1918.   of the modem and we need not concern ourselves with it.
  1919.  
  1920.  
  1921.   The second aspect of line speed is the bit rate or the bits per second (bps).
  1922.   I also refer to the bps as the data rate.  A modem  (and a modulation tech-
  1923.   nique) is typically described by the bps it supports.  Bps also describes the
  1924.   physical line speed the COM port is normally programmed with.  For example,
  1925.  
  1926.  
  1927.                                                                  Appendices  25
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.   if we are using a V.22bis modem, even though the baud rate is 600, since 4
  1938.   bits of information are being sent for each signalling change, the actual bps
  1939.   is 2400.  The COM   port would be programmed for 2400 bps to match the modem
  1940.   speed.
  1941.  
  1942.  
  1943.   The actual line speed, however, might be quite different from the data rate.
  1944.   For example, if the COM port has been setup for a data rate of 2400 bps using
  1945.   a V.22bis modem, the modems might temporarily lose synchronization (e.g.,
  1946.   lose carrier).  Typically the modem would assert some sort of flow control
  1947.   back to its controlling COM port (the DTE) telling it to stop sending data
  1948.   for a while until the modems have regained synchronization.  If this happens,
  1949.   the actual data throughput will be less than the data rate available across
  1950.   the line.  So the throughput is the actual amount of data sent and received
  1951.   across the wire.
  1952.  
  1953.  
  1954.   There may be cases when the throughput across the wire is actually greater
  1955.   than the allowable data rate support.  This can happen if modem to modem com-
  1956.   pression is being used.  For example, if a V.22bis modem supports compression
  1957.   (such as V.42bis), it is possible that the effective modem to modem
  1958.   throughput (across the 2400 bps wire) can be up to 9600 bps.  The actual
  1959.   throughput would vary from 2400 to 9600 bps depending on the contents of the
  1960.   data.
  1961.  
  1962.  
  1963.   In order for the async data link to take advantage of this, the COM port must
  1964.   be programmed to use the maximum possible throughput available across the
  1965.   wire.  In our example, this would be 9600 bps.  Since the modem will most
  1966.   likely not be able to achieve a constant throughput of 9600, flow control
  1967.   must be enabled between the modem and the COM port so that when the
  1968.   throughput drops down to less than 9600, the modem can tell the COM port to
  1969.   stop sending data (since it would be sending at a higher speed) until the
  1970.   modem has caught up.
  1971.  
  1972.  
  1973.   Modem to COM port flow control is required in order to use modem to modem
  1974.   compression and also to use modem to modem error correcting protocols.  The
  1975.   OS/2 prototype will support CTS modem handshaking flow control (whenever the
  1976.   modem wants to pace the COM port, it negates CTS).
  1977.  
  1978.  
  1979.   Modem to COM port flow control can also be used to bypass the prototype's
  1980.   lack of autobaud detect.  For example, if the modems being used supported
  1981.   baud rate negotiations (such as IBM's 7855 modem), the COM port driving such
  1982.   a modem would be set to support its maximum throughput.  When a partner dials
  1983.   into this modem, it might be using any data rate (1200 through 9600). The
  1984.   modems would negotiate what modulation technique to be used, any error cor-
  1985.   recting protocols to be used and/or if compression will be used.  As long as
  1986.   the COM port was setup for the maximum throughput, it will be able to support
  1987.   any type of modem.  This technique simply allows the COM port to take advan-
  1988.   tage of a modem's line rate negotiations capabilities.
  1989.  
  1990.  
  1991.  
  1992.  
  1993.   26  User's Guide for the OS/2 SNA over Async Prototype Package
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.           +-------------------------------------------------------+
  2003.           |                  PROCESSING OPTIONS                   |
  2004.           +-------------------------------------------------------+
  2005.  
  2006.  
  2007.           Runtime values:
  2008.                Document fileid ........................ SNAAOS2 SCRIPT
  2009.                Document type .......................... USERDOC
  2010.                Document style ......................... DEFAULT
  2011.                Profile ................................ EDFPRF30
  2012.                Service Level .......................... 0027
  2013.                SCRIPT/VS Release ...................... 4.0.0
  2014.                Date ................................... 92.12.30
  2015.                Time ................................... 08:10:37
  2016.                Device ................................. 3270
  2017.                Number of Passes ....................... 2
  2018.                Index .................................. NO
  2019.  
  2020.  
  2021.           Formatting values used:
  2022.                Annotation ............................. NO
  2023.                Cross reference listing ................ YES
  2024.                Cross reference head prefix only ....... NO
  2025.                Dialog ................................. LABEL
  2026.                Duplex ................................. SB
  2027.                DVCF conditions file ................... (none)
  2028.                DVCF value 1 ........................... (none)
  2029.                DVCF value 2 ........................... (none)
  2030.                DVCF value 3 ........................... (none)
  2031.                DVCF value 4 ........................... (none)
  2032.                DVCF value 5 ........................... (none)
  2033.                DVCF value 6 ........................... (none)
  2034.                DVCF value 7 ........................... (none)
  2035.                DVCF value 8 ........................... (none)
  2036.                DVCF value 9 ........................... (none)
  2037.                Explode ................................ NO
  2038.                Figure list on new page ................ YES
  2039.                Figure/table number separation ......... YES
  2040.                Folio-by-chapter ....................... NO
  2041.                Head 0 body text ....................... Section
  2042.                Head 1 body text ....................... (none)
  2043.                Head 1 appendix text ................... Appendix
  2044.                Hyphenation ............................ YES
  2045.                Justification .......................... NO
  2046.                Language ............................... ENGL
  2047.                Layout ................................. 1
  2048.                Leader dots ............................ YES
  2049.                Master index ........................... (none)
  2050.                Partial TOC (maximum level) ............ 4
  2051.                Partial TOC (new page after) ........... INLINE
  2052.                Print example id's ..................... NO
  2053.                Print cross reference page numbers ..... YES
  2054.                Process value .......................... (none)
  2055.                Punctuation move characters ............ .,
  2056.                Read cross-reference file .............. (none)
  2057.                Running heading/footing rule ........... NONE
  2058.                Show index entries ..................... NO
  2059.                Table of Contents (maximum level) ...... 3
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.                Table list on new page ................. YES
  2069.                Title page (draft) alignment ........... RIGHT
  2070.                Write cross-reference file ............. (none)
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.