NOVLIB - one complex Novell library


As promised, it's coming. NOVLIB, one from most complex Novell libraries.
It has not ANY other use, than pure Novell networking. Written mostly in
Turbo C (2.0) as is visible in .LIB files is convering almost everything
avaialable from Novell Netware. Last time (in Clipper BBS Magazine number 9,
Volume 2) was coming review of NETLIB. This article will cover complete
review of NOVLIB. Next coming article will compare both libraries for easiest
way to see what is in which library.

NOVLIB covers ONLY Novell Netware, nothing else. That's very important
information. Scale of functions in NOVLIB is well spread over complete
services of Novell Netware, all configuration and also statistic information.
NOVLIB is coming just as two .LIB files, one with generic 2.xx and 3.xx
functions and second with functions related only to Novell 2.xx (3.xx is
missing all statistical services - SYSCON command in those two versions of
Novell is therefore also different).

    Bindery information and access

 AccBindRd()      Returns the workstation's bindery read access security.
 AccBindWr()      Returns the workstation's bindery write access security.
 Bindery()        Opens & Closes the NetWare bindery.
 BindCurrOb()     Returns current number of bindery objects. [286]
 BindMaxOb()      Returns maximum number of bindery objects. [286]
 BindPeakOb()     Returns peak number of bindery objects. [286]
 BindSearch()     Searches the bindery for specified objects (users etc).
 UserAdd()        Adds a new user to the bindery.
 UserAddGrp()     Adds a specified user to a user group.
 UserDelete()     Deletes a specified user.
 UserDelGrp()     Deletes a specified user from a user group.
 UserFName()      Returns or sets user's full name.
 UserFree()       Returns amount of free space available to specified user.

    Printing and Redirecting

 BannerFlag()     Enables & disables the printing of a Banner.
 BannerName()     Returns or sets the banner user name for printing.
 CapBanner()      Returns or sets the banner text for printing.
 CapCancel()      Cancels capture of the specified LPT device.
 CapCopies()      Returns or sets the number of copies for printing.
 CapEnd()         End capture of the specified LPT device.
 CapFlush()       Flushes capture of the specified LPT device.
 CapFrmFeed()     Enables & disables the form feed after printing
 CapFrmName()     Returns or sets the form name for printing.
 CapFrmNo()       Returns or sets the form number for printing.
 CapKeep()        Enables & disables printing of an interupted print
 CapMaxChar()     Returns or sets maximum characters per line for printing.
 CapMaxLine()     Returns or sets the maximum lines per page for printing.
 CapPrnNo()       Returns or sets the destination printer for printing.
 CapQueue()       Directs captured printing to a specified queue.
 CapSetup()       Sets up print capturing for the specified LPT device.
 CapStart()       Starts capture of the specified LPT device.
 CapTabSize()     Returns or sets the tab size for printing.
 CapTimeout()     Returns or sets the timeout count for printing.
 PrnForm()        Returns or sets the form type for specified LPT device.
 TabFlag()        Enables & Disables conversion of tabs to spaces

    Print servers and printer

 PrnOffline()     Checks whether the specified printer is Offline.
 PrnServer()      Returns or sets the server printer for the LPT device.
 PrnStopped()     Checks whether the specified LPT device is stopped.
 PServerVer()     Returns the printer server version number.

    Print Queues manipulation

 QDelJob()        Deletes the specified print queue job.
 QHalt()          Enables/disables print queue servicing.
 QJobAdding()     Checks whether the specified print queue job is adding.
 QJobDate()       Return print jobs entry date
 QJobEDate()      Set or Return defered printing execute date of a print job
 QJobDes()        Returns or sets the specified print queue job description.
 QJobFile()       Returns the name of the specified print job's spool file.
 QJobOpHold()     Places the print queue job on operator hold.
 QJobPos()        Returns or sets the print job's position in queue.
 QJobs()          Returns a list of print queue jobs.
 QJobSize()       Returns the size of the specified print queue job.
 QJobStn()        Returns station number which placed print job in queue.
 QJobTime()       Return print jobs entry time
 QJobETime()      Set or Return defered printing execute time of a print job
 QJobUser()       Returns user ID of user who placed job in queue.
 QJobUsHold()     Places the specified print queue job on user hold.
 QNewJobs()       Enables/disables new jobs being added to print queue.
 QNewServer()     Enables/disables new servers servicing print queue.
 QueueID()        Returns the ID number for a specified print queue.
 QVer()           Returns the queuing version number.

    Accounting

 AccVer()         Returns accounting system version number.

    Statistics

 BufferDirt()     Returns the number of dirty disk cache buffers. [286]
 Buffers()        Returns the total number of disk cache buffers. [286]
 BufferSize()     Returns the size of each disk cache buffer. [286]
 CacheHits()      Returns the number of fileserver cache hits. [286]
 CacheMiss()      Returns the number of file server cache misses. [286]
 CurrOpen()       Returns the current number of open files. [286]
 FatScanErr()     Returns the number of disk fat scan errors.     [286]
 FATCurrChg()     Returns the current number of changed FAT sectors. [286]
 FATErr()         Returns the number of FAT sector errors. [286]
 FATErrFat()      Returns the number of fatal FAT sector errors. [286]
 FATTotChg()      Returns the total number of changed FAT sectors. [286]
 FileOpens()      Returns the number of file open requests. [286]
 FileReads()      Returns the number of file read requests. [286]
 FileWrites()     Returns the number of file write requests. [286]
 FSProcess()      Returns the number of file server processes. [286]
 FSUtil()         Returns file server utilisation (%). [286]
 INBVer()         Returns Internet Bridge version.
 IOPending()      Returns number of disk I/Os pending. [286]
 LogDrives()      Returns the number of logical disk drives. [286]
 MaxConn()        Returns the maximum number of connections supported.
 MaxOpen()        Returns the maximum number of open files. [286]
 MaxVol()         Returns the maximum number of volumes supported.
 MemTotal()       Returns the total amount of server memory. [286]
 MemWaste()       Returns the amount of wasted server memory. [286]
 PeakConn()       Returns the peak number of connections.
 PeakOpen()       Returns the peak number of open files. [286]

    LAN/server configurations

 LANHostAdd()     Returns the specified LAN host address. [286]
 LANName()        Returns the specified LAN name. [286]
 LANNWAdd()       Returns the specified LAN network address. [286]
 LANOption()      Returns the specified LAN option. [286]
 LANSetting()     Returns the specified LAN setting. [286]
 NWAppNo()        Returns the Netware Applications Number
 NWError()        Returns the last NetWare error code.
 NWNumber()       Returns the default network number.
 NWSerNo()        Returns the Netware Serial Number.
 NWVersion()      Returns the NetWare version number.
 OSRev()          Returns the operating system revision number.
 SecureVer()      Returns the security version number.
 SFTLevel()       Returns the file server SFT level.
 VAPVer()         Returns the VAP version number.
 VConsVer()       Returns the virtual console version number.

    Rights, users...

 AccConsole()     Returns the workstation's Console Operator status.
 DirAddUser()     Makes a user a trustee of a directory.
 DirDelUser()     Deletes a user as trustee of a directory.
 DirEffRt()       Returns workstation's effective rights to a directory.
 IsMember()       Verifies that a user is a member of a specified group.
 PassChange()     Changes the specified user's password.
 PassCheck()      Checks the specified user's password.
 UserBlocks()     Returns the number of blocks owned by specified user.
 UserDirs()       Returns number of directories owned by a specified user.
 UserFiles()      Returns the number of files owned by a specified user.
 UserID()         Returns a specified user's ID number.
 UserName()       Returns a specified user's login name.
 UserRename()     Renames a specified user.

    Directories and mapping

 DirHandle()      Returns the directory handle of the current directory
 DirMap()         Maps a specified directory to a drive letter.
 DirMapDel()      Deletes a drive mapping.

    Connections and stations

 ConnClear()      Clears a specified connection number.
 ConnID()         Returns the default connection ID number.
 ConnNo()         Returns the current connection number.
 Conns()          Returns connection numbers where a user is logged in.
 ConnUsed()       Returns if a fileserver table slot is used
 CurrConn()       Returns the current number of active connections.
 FSAttach()       Attaches to new fileserver.
 FSConnNo()       Returns filserver Connection ID number.
 FSDetach()       Detaches from a fileserver.
 FSLogin()        Logs a specified user into the file server.
 FSLogout()       Logs the current user out of the file server.
 LockConn()       Returns connection number which has a record locked. [286]
 LoginDate()      Returns the login date of current user(s).
 LoginID()        Returns the ID number of current user(s).
 LoginName()      Returns the login names of current user(s).
 LoginStat()      Returns or sets the current file server login status.
 LoginTime()      Returns the login times of current user(s).
 NodeNumber()     Returns the workstation node number.
 ShellRev()       Returns the workstation shell revision number.
 ShellVer()       Returns the workstation shell version number.
 WSLHard()        Returns the workstation long hardware type.
 WSLocalDrv()     Returns number of logical local drives on workstation.
 WSOS()           Returns the workstation operating system type.
 WSOSVer()        Returns the workstation operating system version.
 WSSHard()        Returns the workstation short hardware type.

    Other...

 ExclOn()         Returns CLIPPER exclusive status. (NON working BTW)
 Strhex()         Converts number to hexadecimal string.

    File server manipulation

 FSDate()         Gets or Sets the file server date.
 FSTime()         Gets or sets the file server time.
 FSDown()         Downs the file server.
 FSName()         Returns the file server name.
 FSPrefID()       Returns or sets the prefered fileserver.
 FSPrimID()       Returns or sets the primary fileserver.
 LoginEnab()      Enables/disables file server login.

    Messaging services

 MsgConsole()     Sends a message to the file server console.
 MsgGet()         Returns a message from other users.
 MsgLogNet()      Logs a network message.
 MsgMode()        Returns or sets the workstation's message mode.
 MsgUser()        Sends a message to a specified connection number.

    File Services

 Purge()          Purges the workstation's erased files.

    Semaphores

 SemClose()       Closes the specified semaphore.
 SemCount()       Returns number of users with specified semaphore open.
 SemDec()         Decrements the specified semaphore value by 1.
 SemInc()         Increments the specified semaphore value by 1.
 SemOpen()        Opens the specified semaphore.
 SemValue()       Returns the value of the specified semaphore.

    TTS

 TTSAbort()       Aborts a TTS transaction.
 TTSAppThr()      Returns or sets the TTS application thresholds.
 TTSAvail()       Verifies that TTS is available. [286]
 TTSBegin()       Begins a TTS transaction.
 TTSCurrTrn()     Returns the number of current TTS transactions. [286]
 TTSEnable()      Enables/disables TTS. [286]
 TTSEnd()         Ends a TTS transaction.
 TTSLevel()       Returns the file server TTS level.
 TTSMaxTrn()      Returns the maximum number of TTS transactions. [286]
 TTSPeakTrn()     Returns the peak number of TTS transactions. [286]
 TTSSpace()       Returns the space currently used by TTS. [286]
 TtsTotBo1()      Returns the number of TTS backouts by system    [286]
 TtsTotBo2()      Returns the number of TTS backouts by workstat. [286]
 TTSTotTrn()      Returns the total number of TTS transactions. [286]
 TTSVolume()      Returns the volume number used for TTS workfiles. [286]
 TTSWSThr()       Returns the TTS workstation thresholds.
 TtsWTotTrn()    Returns the number of TTS made by workstations  [286]

    Volume and disks

 VolBlAvail()     Returns number of blocks available on specified volume.
 VolBlkSize()     Returns the size of each block on a specified volume.
 VolBlocks()      Returns the total number of blocks on specified volume.
 VolName()        Returns the name of the specified volume.
 VolNumber()      Returns the volume number of a specified volume.
 VolRemove()      Verifies that the specified volume is removable.
 PDChannel()      Returns the physical disk channel number. [286]
 PDCont()         Returns the physical disk controller number. [286]
 PDContDrv()      Returns the physical disk controller drive number. [286]
 PDContType()     Returns the physical disk controller type. [286]
 PDCyls()         Returns the number of cylinders on a physical disk. [286]
 PDDrvSize()      Returns the physical disk size. [286]
 PDDrvType()      Returns the physical disk type. [286]
 PDHeads()        Returns the number of heads on a physical drive. [286]
 PDHfxAvail()     Returns No. of Hot Fix redirection blocks available. [286]
 PDHfxEnab()      Verifies that Hot Fix redirection is enabled. [286]
 PDHfxSize()      Returns the size of Hot Fix redirection table. [286]
 PDHfxStart()     Returns Hot Fix redirection table starting block. [286]
 PDIOErrors()     Returns the number of physical disk I/O Errors. [286]
 PDName()         Returns the physical disk name. [286]
 PDRemove()       Verifies that the physical disk is removable. [286]
 PDSectors()      Returns the number of sectors on a physical disk. [286]
 PhyDrives()      Returns number of physical drives in the fileserver. [286]
 PhyRDErrs()      Returns the number of disk read errors.         [286]
 PhyRDReqs()      Returns the number of disk read requests.       [286]
 PhyWtErrs()      Returns the number of disk write errors.        [286]
 PhyWtReqs()      Returns the number of disk write requests       [286]
 ReadReqs()       Returns the number of dos disk read requests    [286]
 WriteReqs()      Returns the number of dos disk write requests   [286]

    Quite long, isn't? I was quite impressed saw it first time. Functionality
seems also very good. Documentation in .NG format is coming as common
standard, but is missing general comments (about linking), list of functions
per library, overlaying of library functions.