Click above to get retro games delivered to your door ever month!

 CLEAR STATION
------------------------------------------------------------------------------
 Warning:
 USE WITH EXTREME CAUTION. Clearing a connection can result in corrupted
 database and index files. For more information see CLEAR STATION in the
 Novell NetWare reference manuals.

 Purpose:
 Clear a workstation connection from the server.

 Syntax:
 CLEAR STATION <station>

 Parameters:
 station The station number to clear.

 Returns:
 None.
 NWErrorGet() returns non-zero if an error occurs.

 Description:
 CLEAR STATION is a CA-Clipper UDC that emulates the Novell CLEAR STATION
 console command on the file server and can be used in the same way.

 If a connection number is cleared where a user is logged in, then that user
 is logged out and their open files are closed without changes necessarily
 being written to disk.

 Example:
 // To clear workstation number 5 from the file server:

 #include "novlib.ch"
 iStationNo = 5
 CLEAR STATION iStationNo
 if ( NWErrorGet() = 0 )
    ? "Station 5 cleared successfully"
 endif

 Notes:
 This function calls WSClrCon() via a UDC, and requires console
 operator or Supervisor equivalence.