FT_TTSSTAT

FT_TTSSTAT()
 Verify if TTS transaction has been written to disk

 Syntax

    FT_TTSSTAT( <nTransNumber> ) -> nResult

 Arguments

   <nTransNumber> is the transaction number, returned from FT_TTSEND().

 Returns

     0 - Success, transaction written to disk
   255 - Transaction not yet written to disk

 Description

   For further information on NetWare's Transaction Tracking System (TTS),
   consult Novell's documentation.

 Examples

   nResult := FT_TTSSTAT()
   DO CASE
      CASE nResult == 0
         ? "Transaction wrttten to disk"
      CASE nResult == 255
         ? "Transaction not yet written to disk"
      OTHERWISE
         ? "Unknown result code"
   ENDCASE

 Source: NWTTS5.ASM

 Author: James R. Zack

See Also: FT_TTSABORT() FT_TTSAVAIL() FT_TTSBEGIN() FT_TTSEND()

Advertisements

FT_TTSEND

FT_TTSEND()
 End explicit or implicit transaction under NetWare's TTS

 Syntax

     FT_TTSEND() -> nResult

 Arguments

    None

 Returns

        0 - Transaction tracking finished (Success)
      253 - Transaction tracking disabled
      254 - Transaction ended, records locked
      255 - No explicit transactions active
    > 255 - Transaction number

 Description

   For further information on NetWare's Transaction Tracking System (TTS),
   consult your NetWare manuals.

 Examples

   nResult := FT_TTSEND()
   DO CASE
      CASE nResult == 0
         ? "Transaction ended"
      CASE nResult == 253
         ? "Transaction tracking disabled"
      CASE nResult == 254
         ? "Transaction ended, records locked"
      CASE nResult == 255
         ? "No explicit transactions active"
      OTHERWISE
         ? "Transaction number " + Ltrim(Str(nResult))
   ENDCASE

 Source: NWTTS4.ASM

 Author: James R. Zack

See Also: FT_TTSABORT() FT_TTSAVAIL() FT_TTSBEGIN() FT_TTSSTAT()

FT_TTSBEGIN

FT_TTSBEGIN()
 Begin explicit transaction under NetWare's TTS

 Syntax

     FT_TTSBEGIN() -> nResult

 Arguments

    None

 Returns

      0 - Success (transaction begun)
    150 - Out of dynamic workspace (not begun)
    254 - Implicit Transaction already active
             (active implicit transaction now converted to
             explicit transaction)
    255 - Explicit transaction already active
             (existing explicit transaction continues normally)

 Description

   See your NetWare documentation for further information about the
   Transaction Tracking System (TTS).

 Examples

   nResult := FT_TTSBEGIN()
   DO CASE
      CASE nResult == 0
         ? "Transaction begun"
      CASE nResult == 150
         ? "Out of dynamic workspace, transaction not begun"
      CASE nResult == 254
         ? "Implicit transaction already active"
      CASE nResult == 255
         ? "Explicit transaction already active"
      OTHERWISE
         ? "Unknown result"
   ENDCASE

 Source: NWTTS3.ASM

 Author: James R. Zack

See Also: FT_TTSABORT() FT_TTSAVAIL() FT_TTSEND() FT_TTSSTAT()

FT_TTSAVAIL

FT_TTSAVAIL()
 Check whether default Novell file server supports TTS

 Syntax

     FT_TTSAVAIL() -> nResult

 Arguments

    None

 Returns

       0 - TTS unavailable or not supported.
       1 - TTS is installed and available.
     253 - TTS is disabled.

 Description

   This routine is used to check the default NetWare file server for TTS
   availability.  You must have Novell NetWare SFT Level II or above to
   use these functions.  Using these functions on a non SFT II file server
   will return unsuccessful values.  You must have TTS installed on your
   file server.

   This routine was designed and written for Novell Advanced NetWare 2.15
   SFT Level II and Novell NetWare 386 v 3.0 and above.

   This source code was written for Microsoft Macro Assembler v5.1.

 Examples

   IF FT_TTSAVAIL() == 1   // If TTS is available
     FT_TTSBEGIN()         // Begin transaction
   ENDIF

 Source: NWTTS1.ASM

 Author: James R. Zack

See Also: FT_TTSABORT() FT_TTSBEGIN() FT_TTSEND() FT_TTSSTAT()

FT_TTSABORT

FT_TTSABORT()
 Abort explicit and implicit NetWare TTS transactions

 Syntax

     FT_TTSABORT() -> nResult

 Arguments

    None

 Returns

      0 - Abort Successful (backout completed)
    253 - Transaction Tracking disabled (no backout performed)
    254 - Transaction ended, records locked (No backout performed)
    255 - No explicit transactions active

 Description

   Consult your NetWare documentation for details on the NetWare
   Transaction Tracking System.

 Examples

   nResult := FT_TTSABORT()
   DO CASE
      CASE nResult == 0
         ? "TTS aborted"
      CASE nResult == 253
         ? "Transction tracking, no backout performed"
      CASE nResult == 254
         ? "Transaction ended, records locked, no backout performed"
      CASE nResult == 255
         ? "No transactions active"
      OTHERWISE
         ? "Unknown result"
   ENDCASE

 Source: NWTTS2.ASM

 Author: James R. Zack

See Also: FT_TTSAVAIL() FT_TTSBEGIN() FT_TTSEND() FT_TTSSTAT()

FT_PFLUSH

FT_PFLUSH()
 Flush a NetWare capture buffer

 Syntax

     FT_PFLUSH( [ <nLPTPortNumber> ] ) -> NIL

 Arguments

    <nLPTPortNumber> is the captured LPT port number to flush.  If the
    parameter is omitted, the default port or LPT1: is used.

 Returns

    NIL

 Description

   This routine is used to force a Novell NetWare capture buffer to print
   it's contents.  This is useful for printing reports with a filter set
   and you don't know how long it will be between print statements.  With
   a FT_PFLUSH() function at the end of any printing, you can have the
   timeout value for any capture set to 0 (zero).

   This routine was designed and written for Advanced NetWare 286 v 2.0 or
   NetWare 386 v 3.0 or better.  It has been tested on Advanced NetWare 286
   v 2.15 rev A & C, NetWare 386 v 3.0.

   This source code was written for Microsoft Macro Assembler v5.1.

 Examples

   (in DOS)
   F:>CAPTURE S=ServerName Q=PrintQueueName TI=0 L=1

   (in your Clipper application)
   SET FILTER TO Left( FONELIST->PHONENUM, 3 ) == "415"
   GO TOP
   SET PRINT ON
   DO WHILE .NOT. Eof()
     ? fonelist->lastname...
     SKIP
   ENDDO
   FT_PFLUSH(1)     && I could just say FT_PFLUSH() here as well.

 Source: FLUSHCAP.ASM

 Author: James R. Zack

FT_NWUID

FT_NWUID()
 Return the current Novell NetWare User ID

 Syntax

      FT_NWUID( [ <nConnection> ] ) -> cUid

 Arguments

     <nConnection> is a connection number, or logical station number,
     to find a userid for.  Under NetWare 286, this number can be from
     1 to 100.  Under NetWare 386, 1-250.  If not supplied, FT_NWUID()
     defaults to the current connection (i.e., the connection running
     the application).

 Returns

     A string containing the userid, or "login name."
     The maximum length of this string, as defined by current
     versions of Novell NetWare, is 48 characters.

 Description

     FT_NWUID() returns the current NetWare userid, or "login
     name."  This is useful for implementing security or audit
     trail procedures within your programs.

     There is no simple way a user can "fool" this function into
     retrieving an incorrect value, provided a NetWare shell is loaded.

     This function requires FT_INT86() and FT_NWLSTAT()

     This function does NOT test for the existence of the NetWare shell.
     The behavior is undefined if no shell is loaded. You'll usually get
     garbage.  This function has not been tested on NetWare 386.

 Examples

     QOut( "I am: " + FT_NWUID() )

     FOR x := 1 TO 100
       cUid := FT_NWUID( x )
       IF .NOT Empty( cUid )
         QOut( Str( x, 3 ) + Space(3) + cUid )
       ENDIF
     NEXT

 Source: NWUID.PRG

 Author: Glenn Scott