home *** CD-ROM | disk | FTP | other *** search
/ IBM Presents OS/2 Software Hits 1995 / OS-2_SW_HITS_2ND_EDITION_1995.ISO / i17 / saa010.abs < prev    next >
Text File  |  1994-10-17  |  6KB  |  176 lines
  1. STATUS:                                                  BBS:YES
  2. FL: NETWARE SAA V1.3 DOS CLIENT LUX API SUPPORT   SAA010
  3.  
  4.  Update to provide all versions of NetWare for SAA 1.3 with DOS
  5.  Workstation API support to use SNA communications for secondary
  6.  dependent logical units using the LU 0, LU 1, LU 2, and LU 3
  7.  protocols.
  8.  ---------------------------------------------------------------
  9.  
  10.  This package is made up of the following files:
  11.  
  12.          SAA010.DOC    - This document
  13.          SAA010.EXE    - Binary self-extracting file
  14.  
  15.  The file, once downloaded with the binary option, needs to be
  16.  run as it is a self-extracting file.
  17.  ---------------------------------------------------------------
  18.  
  19.  NOVELL PRODUCT and VERSION:
  20.  NetWare for SAA 1.3B
  21.  NetWare for SAA 1.3A
  22.  NetWare for SAA 1.3
  23.  
  24.  ABSTRACT:
  25.  
  26.  SAA010.EXE provides SAA010.TXT does not provide instructions
  27.  regarding the writing of LUx applications.  If you wish to
  28.  write applications contact Novell Marketing for assistance at
  29.  the address shown in SAA010.TXT.
  30.  
  31.  ---------------------------------------------------------------
  32.                             DISCLAIMER
  33.  THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO
  34.  NOVELL.  NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY
  35.  THIS INFORMATION.  HOWEVER, THE INFORMATION PROVIDED IN THIS
  36.  DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL MAKES NO
  37.  EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  38.  ---------------------------------------------------------------
  39.  
  40.  SYMPTOM
  41.  
  42.  GENERAL
  43.  1. RUI or SLI verbs may not post as complete.
  44.  
  45.  2. The NWSAA_INIT verb was not checking all eight bytes of the
  46.     profile name.
  47.  
  48.  3. A new return code was added to LUX.
  49.  
  50.  4. Nearest server determination
  51.  
  52.  5. RUI_WRITE problems
  53.  
  54.  6. Applications that poll the primary return code may fail.
  55.  
  56.  Self-Extracting File Name:  SAA010.EXE     Revision:  A
  57.  
  58.  Files Included     Size     Date      Time
  59.  
  60.  \
  61.    SAA010.TXT         (This File)
  62.       LUX.EXE      88266   05-25-94    3:58p   *602
  63.       LUX.LIB      13487   05-25-94    3:44p   *602
  64.   CCSLOAD.EXE      20489   05-25-94    3:42p   *602
  65.  LOADBASE.EXE       8417   05-25-94    3:43p   *602
  66.  
  67.  *Novell Internal Control Number
  68.  
  69.  INSTALLATION INSTRUCTIONS
  70.  1. Create a directory in the SAA server. (SYSTEM\NWSAA\LUX\DOS)
  71.  
  72.  2. Copy the files the files in SAA010 into the directory.
  73.  
  74.  SOLUTION SPECIFICS
  75.  
  76.  A. GENERAL
  77.  
  78.  1. RUI or SLI verbs may not post as complete, even though a
  79.  trace run at the server shows the response returned to the
  80.  client  (eg. the trace obtained via CSSTATUS may show an
  81.  RUI_READ request
  82.  
  83.        RET   TIME:00:00:00:60    VPL= RUI_READ
  84.                  000000 .........................
  85.       followed by the response returned to the client
  86.  
  87.       REQ  TIME:00:00:00:60    VPL= RUI_READ
  88.                  000000 ...................
  89.       but the verb remains stuck IN_PROGRESS
  90.  
  91.  2. The NWSAA_INIT verb was not checking all eight bytes of the
  92.  profile name.  When the first four bytes were not unique, LUX
  93.  returned a primary return code of SV_STATE_CHECK and a
  94.  secondary return code of SV_SESSION_ALREADY_OPEN in error.
  95.  
  96.  3. A new return code was added to LUX when NWSAA is unloaded or
  97.  a hard reset LU is performed at the server: Primary return code
  98.  LUX_SESSION_FAILURE and secondary return code
  99.  LUX_NWSAA_SESSION_RESET.
  100.  
  101.  4. For DOS only, if the nearest server cannot be determined
  102.  within fifteen seconds, THE SLI_OPEN or RUI_INIT fails.
  103.  
  104.  5. RUI_WRITE with no data was being rejected with a parameter
  105.  error, but is valid (eg. RH with change direction )
  106.  
  107.  6. Applications that poll the primary return code may fail.
  108.  The return codes were set prematurely when the data size
  109.  exceeded the packet size (approximately 500 bytes for DOS and
  110.  4000 bytes for NLM) Applications that use LUX callback posting
  111.  are not impacted.
  112.  
  113.  TO RUN LUx
  114.  ----------
  115.  Prior to running a LUx DOS application:
  116.    - the LUX TSR may be loaded via "CCSLOAD LUX".
  117.            or
  118.    - the application may be allowed to load the TSR.
  119.  
  120.  In either case, LUx dynamically links to the code in the TSR
  121.  when the application makes the initial load request.
  122.  
  123.  The EXEs provide LUx services to LUx applications.  They work
  124.  together at the DOS Client to communicate with a host system.
  125.  
  126.  TO UNLOAD THE LUx TSR
  127.  ---------------------
  128.  Following the completion of LUx applications:
  129.       CCSLOAD /U LUX
  130.  
  131.  Files                                Description
  132.  -----                                -----------
  133.  SYSTEM\NWSAA\LUX\DOS\CCSLOAD.EXE     LUx loader
  134.  SYSTEM\NWSAA\LUX\DOS\LOADBASE.EXE    Lux loader TSR
  135.  SYSTEM\NWSAA\LUX\DOS\LUX.EXE         LUx API TSR
  136.  SYSTEM\NWSAA\LUX\DOS\LUX.LIB         LUx API Library (linked
  137.                                       with application)
  138.  
  139.  The EXEs provide LUx services to LUx applications.  They work
  140.  together at the DOS Client to communicate with a host system.
  141.  
  142.  Developing LUx Applications
  143.  ---------------------------
  144.  The LUX library is used by the application developer to build
  145.  LUx applications.  It is not required at the DOS Client to run
  146.  the application.
  147.  
  148.  A LUx application is linked with the Novell LUX.LIB when the
  149.  application is developed.
  150.  
  151.  The LUx Library provides the following LUx entry points:
  152.  
  153.     SETUP_NWSAA - Setup APIs for loading,linking &
  154.  unloadingsoftware.
  155.     SVC_NWSAA   - Service APIs for Initializing and Terminating
  156.  NetWare for SAA LUx sessions, and for the Convert function.
  157.     LUX_NWSAA   - LUx APIs
  158.                 - Request-unit interface (RUI)
  159.                 - Session-level interface (SLI)
  160.  
  161.  FOR MORE INFORMATION
  162.  For information regarding the writing of DOS LUx applications
  163.  write to:   Novell, Inc
  164.              Attn: Product Marketing
  165.              890 Ross Drive
  166.              Sunnyvale, CA 94089
  167.  
  168.  Patch History:
  169.  SAA010.EXE supersedes SAALUX.EXE.
  170.  
  171.  ---------------------------------------------------------------
  172.  Any trademarks referenced in this document are the property of
  173.  their respective owners.  Consult your product manuals for
  174.  complete trademark information.
  175.  ---------------------------------------------------------------
  176.