Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper Tools . Book 4-Appendices - <b>nnetpurge()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETPURGE()
 Removes the files that are marked for deletion from the server
------------------------------------------------------------------------------
 Syntax

     NNETPURGE(<cFile>,[<lAll>]) --> lSuccess

     Netware: 2.2 and 3.11

 Arguments

     <cFile>  Designates the file that is deleted, but depends on the
     Netware version that is used.

     Under Netware 3.x, <cFile> designates the file that is deleted.  The
     file name can contain a path, but the path must be unique.  Wildcard
     characters are not allowed.

     Under Netware 2.x, the operating system permits a definite purging of
     files only for the entire file server.  If NNETPURGE() determines that
     the server is running under Netware 2.x after a server change is implied
     by <cFile>, the file specification in <cFile> is no longer taken into
     account.  All the files on the related server that are marked for
     deletion are purged.

     <lAll>  Designates the files that are deleted.  <lAll> is only taken
     into account if the function is called on a Netware 2.x server.  If the
     parameter is designated .F., all the marked files of the current user
     are deleted.  If the parameter is designated .T., all the files of the
     related file server that are marked for deletion are deleted.  The
     default value is .F..

 Returns

     NNETPURGE() returns .T. if the function has been completed successfully.

 Description

     NOVELL NET PURGE
     NNETPURGE() allows you to physically delete all the files that are
     marked for deletion on a server disk.  (These files can no longer be
     restored with the Novell utility SALVAGE).  The function is supported
     differently by Netware 2.x and 3.x.  Under Netware 3.x, files can be
     purged individually.  Under Netware 2.x, all the files of the current
     user (<lAll>=.F.) or all the files that are marked for deletion
     (<lAll>=.T.) are removed.  Console operator rights are required to purge
     all the files that are marked for deletion.  You should query the
     Netware version with NNETVER() before calling NNETPURGE() to avoid a
     purging of all files marked for deletion.

 Note

     .  For compatibility reasons the previous version of the
        NNETPURGE() function is still supported (NNETPURGE() -->
        lSuccessful).  A call in this form is only valid for Netware 2.x
        servers.  With console operator rights, NNETPURGE() purges of all of
        the files that are marked for deletion.

 Examples

     .  Delete and purge the file CONFID.DBF:

        NNETMAP('L','FSERVER386/SYS:DATA')

        ERASE L:CONFID.DBF

        IF NNETVER('FSERVER386') > '2'
           NNETPURGE('L:CONFID.DBF')
        ENDIF

     .  Purge all the files that are marked for deletion for the
        current user on FSERVER286 (2.x server):

        NNETPURGE('FSERVER286/SYS:')

        The definition of the volume SYS: is necessary to identify FSERVER286
        as server name.  If FSERVER286 contains more volumes, all the volumes
        are purged.

See Also: NNETSALVAG()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson