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