home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / progmisc / nfsrc21.zip / NWTTS3.ASM < prev    next >
Assembly Source File  |  1991-08-16  |  3KB  |  105 lines

  1. ; File......: NWTTS3.ASM
  2. ; Author....: James R. Zack
  3. ; CIS ID....: 75410,1567
  4. ; Date......: $Date:   15 Aug 1991 23:07:04  $
  5. ; Revision..: $Revision:   1.2  $
  6. ; Log file..: $Logfile:   E:/nanfor/src/nwtts3.asv  $
  7. ; This is an original work by James Zack and is placed in the
  8. ; public domain.
  9. ;
  10. ; Modification history:
  11. ; ---------------------
  12. ;
  13. ; $Log:   E:/nanfor/src/nwtts3.asv  $
  14. ;  
  15. ;     Rev 1.2   15 Aug 1991 23:07:04   GLENN
  16. ;  Forest Belt proofread/edited/cleaned up doc
  17. ;  
  18. ;     Rev 1.1   12 Apr 1991 00:07:24   GLENN
  19. ;  Librarian error!  I didn't realize .asm functions _must_ obey the 10-char
  20. ;  limit, so the linker can't find this routine because it was 11 chars.  
  21. ;  The function is now ft_ttsBegi(), although the old ft_ttsBegin() will
  22. ;  work from Clipper.  Apologies to Mr. Zack and everyone for careless
  23. ;  renaming!
  24. ;  
  25. ;     Rev 1.0   01 Apr 1991 01:03:42   GLENN
  26. ;  Nanforum Toolkit
  27. ;  
  28.  
  29. ; $DOC$
  30. ; $FUNCNAME$
  31. ;     FT_TTSBEGIN()
  32. ; $CATEGORY$
  33. ;     NetWare
  34. ; $ONELINER$
  35. ;     Begin explicit transaction under NetWare's TTS
  36. ; $SYNTAX$
  37. ;     FT_TTSBEGIN() -> nResult
  38. ; $ARGUMENTS$
  39. ;     None
  40. ; $RETURNS$
  41. ;       0 - Success (transaction begun)
  42. ;     150 - Out of dynamic workspace (not begun)
  43. ;     254 - Implicit Transaction already active
  44. ;              (active implicit transaction now converted to
  45. ;              explicit transaction)
  46. ;     255 - Explicit transaction already active
  47. ;              (existing explicit transaction continues normally)
  48. ; $DESCRIPTION$
  49. ;    See your NetWare documentation for further information about the 
  50. ;    Transaction Tracking System (TTS).
  51. ; $EXAMPLES$
  52. ;    nResult := FT_TTSBEGIN()
  53. ;    DO CASE
  54. ;       CASE nResult == 0
  55. ;          ? "Transaction begun"
  56. ;       CASE nResult == 150
  57. ;          ? "Out of dynamic workspace, transaction not begun"
  58. ;       CASE nResult == 254
  59. ;          ? "Implicit transaction already active"
  60. ;       CASE nResult == 255
  61. ;          ? "Explicit transaction already active"
  62. ;       OTHERWISE
  63. ;          ? "Unknown result"
  64. ;    ENDCASE
  65. ; $SEEALSO$
  66. ;    FT_TTSABORT() FT_TTSAVAIL() FT_TTSEND() FT_TTSSTAT()
  67. ; $END$
  68. ;
  69. ;
  70.  
  71. PUBLIC    FT_TTSBEGI
  72. EXTRN     __RETNI:FAR
  73. EXTRN     __RET:FAR
  74. _NanFor  SEGMENT 'CODE'
  75.           ASSUME cs:_NanFor
  76. FT_TTSBEGI PROC    FAR
  77.           push    bp
  78.           mov     bp,sp
  79.           push    ds
  80.           push    es
  81.           push    si
  82.           push    di
  83.           mov     ah,0c7h          ; Novell API function c7
  84.           mov     al,00h           ; Subfunction 02
  85.           int     21h              ; TTS Begin Transaction
  86.           mov     ah,00h
  87.           push    ax
  88.           call    __RETNI
  89.           add     sp,2
  90.           pop     di
  91.           pop     si
  92.           pop     es
  93.           pop     ds
  94.           pop     bp
  95.           call    __RET
  96.           ret
  97.  
  98. FT_TTSBEGI endp
  99.  
  100. _NanFor   ends
  101.  
  102.           end
  103. 
  104.