ftp.wwiv.com/ftp.wwiv.com.zip/ftp.wwiv.com/pub/MISC/PBAPI10.ZIP/APIDOCS.ZIP/SYSDAT1.DOC

Text File | 1998-02-21 | 35KB | 853 lines

Author....... : Gary Price
Copyrighted by: Freejack's Software 1997-98

SYSDAT1_DAT API Unit for TriBBS v10.x/11.x written in PowerBasic v3.5
---------------------------------------------------------------------------

The SYSDAT1_DAT functions are used to manipulate data in the SYSDAT1.DAT
data file found in Node 1's MAIN directory. The SYSDAT1.PBU Unit is declared
in PBAPI10.INC as follows:

Sysdat1.dat BitFields breakdown

 SysDat1Bit.bit1 BIT Assignment
    0 = PhoneNumberFlag                          0 = Non-US, 1 = US Format
    1 = TestUploadsFlag                          0 = No, 1 = Yes
    2 = AutoANSIDetectFlag                       0 = No, 1 = Yes
    3 = CheckForWaitingMessagesFlag              0 = No, 1 = Yes
    4 = ULDLRatioTypeFlag                        0 = Sec. Level, 1 = Download
    5 = PhoneOnHookDuringMaintenanceFlag         0 = Off Hook, 1 = On Hook
    6 = NoOneWordNamesFlag                       0 = Yes, 1 = No
    7 = NoBulletinMenuAtLogonFlag                0 = Yes, 1 = No

 SysDat1Bit.bit2 BIT Assignment
    0 = AllowAliasesFlag                         0 = No, 1 = Yes
    1 = ClearScreenBeforeMenusFlag               0 = No, 1 = Yes
    2 = ExactFileNameMatchingForDupesFlag        0 = No, 1 = Yes
    3 = DisableNewUserBirthdayPromptFlag         0 = No, 1 = Yes
    4 = DisableDetailedCallersLogFlag            0 = No, 1 = Yes
    5 = EnableRIPscripEmulationFlag              0 = No, 1 = Yes
    6 = UseAliasOrRealNamesFlag                  0 = Aliases, 1 = Real Names
    7 = ClearUploadsAndDownloadsFlag             0 = No, 1 = Yes

 SysDat1Bit.bit3 BIT Assignment
    0 = ClearPrivateMessageAreasFlag             0 = No, 1 = Yes
    1 = ClearPrivateFileAreasFlag                0 = No, 1 = Yes
    2 = DisableUploadedByFlag                    0 = No, 1 = Yes
    3 to 7 = 0 (Reserved)

 SysDat1Bit.bit4 to SysDat1Bit.bit10 - All bits are set to 0 (Reserved)

---------------------------------------------------------------------------

Sub Type Structure for 10 byte BitFields
 TYPE SysDat1Bit
    bit1  AS BYTE
    bit2  AS BYTE
    bit3  AS BYTE
    bit4  AS BYTE
    bit5  AS BYTE
    bit6  AS BYTE
    bit7  AS BYTE
    bit8  AS BYTE
    bit9  AS BYTE
    bit10 AS BYTE
 END TYPE

---------------------------------------------------------------------------

File Name: "SYSDAT1.DAT"
 TYPE SYSDAT1
    RegistrationCode                   AS STRING * 81
    BoardName                          AS STRING * 41
    SysopName                          AS STRING * 61
    DefaultArchiveExtension            AS STRING * 4
    SystemPassword                     AS STRING * 16
    VirusCheckerCommandLine            AS STRING * 81
    ZIPCompressCommandLine             AS STRING * 81
    ZIPUnCompressCommandLine           AS STRING * 81
    ARJCompressCommandLine             AS STRING * 81
    ARJUnCompressCommandLine           AS STRING * 81
    LZHCompressCommandLine             AS STRING * 81
    LZHUnCompressCommandLine           AS STRING * 81
    ARCCompressCommandLine             AS STRING * 81
    ARCUnCompressCommandLine           AS STRING * 81
    PAKCompressCommandLine             AS STRING * 81
    PAKUnCompressCommandLine           AS STRING * 81
    SDNCompressCommandLine             AS STRING * 81
    SDNUnCompressCommandLine           AS STRING * 81
    RARCompressCommandLine             AS STRING * 81
    RARUnCompressCommandLine           AS STRING * 81
    BoardStartDate                     AS STRING * 9
    TotalNodes                         AS INTEGER
    CallsToday                         AS INTEGER
    MessagesToday                      AS INTEGER
    UploadsToday                       AS INTEGER
    DownloadsToday                     AS INTEGER
    DefaultDailyTimeLimit              AS INTEGER
    DefaultDailyLogons                 AS INTEGER
    DefaultTimePerLogon                AS INTEGER
    MinimumSysopSecurityLevel          AS INTEGER
    NewUserSecurityLevel               AS INTEGER
    NewUserTimeLimit                   AS INTEGER
    UploadTimeCompensationRatio        AS INTEGER
    MinimumFileAttachmentSecurityLevel AS INTEGER
    MinimumAtVariableSecurityLevel     AS INTEGER
    FastLogonSecurityLevel             AS INTEGER
    TotalCalls                         AS LONG
    SysDat1BitFields                   AS SysDat1Bit
    ReservedDataArea                   AS STRING * 2625
 END TYPE

DIM SysDat1Bit AS SysDat1Bit
DIM SYSDAT1    AS SHARED SYSDAT1
DIM sys1       AS SHARED SYSDAT1 PTR

sys1 = VARPTR32(SYSDAT1)
LSET SYSDAT1 = SYSDAT1
---------------------------------------------------------------------------
FUNCTION's below are from the SYSDAT1.PBU Unit and DECLAREd in the
PBAPI10.INC.

FUNCTION SYSDAT1_DAT_Open()
FUNCTION SYSDAT1_DAT_Close()
FUNCTION SYSDAT1_DAT_Read()
FUNCTION SYSDAT1_DAT_Write()
FUNCTION SYSDAT1_DAT_OpenRead()
FUNCTION SYSDAT1_DAT_WriteClose()
FUNCTION SYSDAT1_DAT_OpenReadClose()
FUNCTION SYSDAT1_DAT_OpenWriteClose()
FUNCTION SYSDAT1_DAT_ClearIt()
FUNCTION SYSDAT1_DAT_Initialize()

FUNCTION SYSDAT1_DAT_GetRC() AS STRING
FUNCTION SYSDAT1_DAT_PutRC(s AS STRING)
FUNCTION SYSDAT1_DAT_GetBN() AS STRING
FUNCTION SYSDAT1_DAT_PutBN(s AS STRING)
FUNCTION SYSDAT1_DAT_GetSN() AS STRING
FUNCTION SYSDAT1_DAT_PutSN(s AS STRING)
FUNCTION SYSDAT1_DAT_GetDAE() AS STRING
FUNCTION SYSDAT1_DAT_PutDAE(s AS STRING)
FUNCTION SYSDAT1_DAT_GetSP() AS STRING
FUNCTION SYSDAT1_DAT_PutSP(s AS STRING)
FUNCTION SYSDAT1_DAT_GetVCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutVCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetZIPCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutZIPCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetZIPUCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutZIPUCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetARJCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutARJCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetARJUCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutARJUCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetLZHCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutLZHCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetLZHUCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutLZHUCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetARCCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutARCCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetARCUCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutARCUCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetPAKCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutPAKCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetPAKUCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutPAKUCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetSDNCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutSDNCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetSDNUCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutSDNUCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetRARCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutRARCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetRARUCCL() AS STRING
FUNCTION SYSDAT1_DAT_PutRARUCCL(s AS STRING)
FUNCTION SYSDAT1_DAT_GetBSD() AS STRING
FUNCTION SYSDAT1_DAT_PutBSD(s AS STRING)
FUNCTION SYSDAT1_DAT_GetTN() AS INTEGER
FUNCTION SYSDAT1_DAT_PutTN(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetCT() AS INTEGER
FUNCTION SYSDAT1_DAT_PutCT(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetMT() AS INTEGER
FUNCTION SYSDAT1_DAT_PutMT(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetUT() AS INTEGER
FUNCTION SYSDAT1_DAT_PutUT(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetDT() AS INTEGER
FUNCTION SYSDAT1_DAT_PutDT(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetDDTL() AS INTEGER
FUNCTION SYSDAT1_DAT_PutDDTL(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetDDL() AS INTEGER
FUNCTION SYSDAT1_DAT_PutDDL(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetDTPL() AS INTEGER
FUNCTION SYSDAT1_DAT_PutDTPL(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetMSSL() AS INTEGER
FUNCTION SYSDAT1_DAT_PutMSSL(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetNUSL() AS INTEGER
FUNCTION SYSDAT1_DAT_PutNUSL(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetNUTL() AS INTEGER
FUNCTION SYSDAT1_DAT_PutNUTL(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetUTCR() AS INTEGER
FUNCTION SYSDAT1_DAT_PutUTCR(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetMFASL() AS INTEGER
FUNCTION SYSDAT1_DAT_PutMFASL(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetMAVSL() AS INTEGER
FUNCTION SYSDAT1_DAT_PutMAVSL(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetFLSL() AS INTEGER
FUNCTION SYSDAT1_DAT_PutFLSL(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetTC() AS LONG
FUNCTION SYSDAT1_DAT_PutTC(n AS LONG)

FUNCTION SYSDAT1_DAT_GetPNSF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutPNSF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetTUF() AS INTEGER
FUNCTION SYSDAT1_DAT_GetTUF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetAADF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutAADF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetCFWMF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutCFWMF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetUDRTF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutUDRTF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetPOHDMF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutPOHDMF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetNOWNF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutNOWNF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetNBMALF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutNBMALF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetAAF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutAAF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetCSBMF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutCSBMF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetEFNMFDF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutEFNMFDF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetDNUBPF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutDNUBPF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetDDCLF() AS INTEGER
FUNCTION SYSDAT1_DAT_GetDDCLF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetEREF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutEREF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetUAORNF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutUAORNF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetCUADF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutCUADF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetCPMAF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutCPMAF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetCPFAF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutCPFAF(n AS INTEGER)
FUNCTION SYSDAT1_DAT_GetDUBF() AS INTEGER
FUNCTION SYSDAT1_DAT_PutDUBF(n AS INTEGER)

---------------------------------------------------------------------------
 MPORTANT: TBNode1sMainDirectory must be set to node 1's main directory
 before calling any function with the "Open" word.
---------------------------------------------------------------------------
SYSDAT1_DAT_Open()
 The SYSDAT1_DAT_Open function opens the SYSDAT1.DAT data file in node 1's
 main directory.

SYSDAT1_DAT_Close()
 The SYSDAT1_DAT_Close function closes the SYSDAT1.DAT data file in node 1's
 main directory.

SYSDAT1_DAT_Read()
 The SYSDAT1_DAT_Read function reads the contents of the SYSDAT1.DAT data
 file into memory.

SYSDAT1_DAT_Write()
 The SYSDAT1_DAT_Write function updates the contents of SYSDAT1.DAT from
 memory.

SYSDAT1_DAT_OpenRead()
 The SYSDAT1_DAT_OpenRead function provides the functionality of the
 SYSDAT1_DAT_Open and SYSDAT1_DAT_Read functions in a single function call.

SYSDAT1_DAT_WriteClose()
 The SYSDAT1_DAT_WriteClose function provides the functionality of the
 SYSDAT1_DAT_Write and SYSDAT1_DAT_Close functions in a single function call.

SYSDAT1_DAT_OpenReadClose()
 The SYSDAT1_DAT_OpenReadClose function provides the functionality of the
 SYSDAT1_DAT_Open, SYSDAT1_DAT_Read, and SYSDAT1_DAT_Close functions in a
 single function call.

SYSDAT1_DAT_OpenWriteClose()
 The SYSDAT1_DAT_OpenWriteClose function provides the functionality of the
 SYSDAT1_DAT_Open, SYSDAT1_DAT_Write, and SYSDAT1_DAT_Close functions in a
 single function call.

SYSDAT1_DAT_ClearIt()
 The SYSDAT1_DAT_ClearIt function sets the entire SYSDAT1_DAT data record
 to all zeros.

SYSDAT1_DAT_Initialize()
 The SYSDAT1_DAT_Initialize function is used to create a SYSDAT1.DAT data
 file if one doesn't exist. IMPORTANT: TBNode1sMainDirectory must be set
 before calling this function.

-----------------------------------------------------------------------------
POINTERS Uses a hidden variable I use called "@sys1". Any reference to this
is only for your information for discussion in this doc file. You will not
need to concern yourself trying to use this.. All calls are handled in the
main SYSDAT1.PBU Unit by my routines automatically. In other words, I am
trying to keep Pointers as easy as possible for your use. :)

Also, all calls to any Functions which gets data with the string routines
will auto-trim each string's extra spaces and the null terminator, CHR$(0),
off so printing will be easier for you to manipulate. When calling the string
routines to put data back into the string space, all string data will be
resized to fit the SYSDAT1.DAT type structure and will add the null terminator
back to the end of the string. Just remember, when working the data in memory
with the pointer calls, you still have to write the data back to the
SYSDAT1.DAT in order for the changes to become permanent.

-----------------------------------------------------------------------------
SYSDAT1_DAT_GetRC() AS STRING
 This form of the SYSDAT1_DAT_GetRC function returns a pointer to the sysop's
 registration code string.

SYSDAT1_DAT_PutRC(s AS STRING)
 This form of the SYSDAT1_DAT_PutRC function sets the sysop's registration
 code string to the string pointed to by "s". Note that the string pointed to
 by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetBN() AS STRING
 This form of the SYSDAT1_DAT_GetBN function returns a pointer to the board's
 name string.

SYSDAT1_DAT_PutBN(s AS STRING)
 This form of the SYSDAT1_DAT_PutBN function sets the board's name string to
 the string pointed to by "s". Note that the string pointed to by "s" can be
 no more than 40 characters in length.

SYSDAT1_DAT_GetSN() AS STRING
 This form of the SYSDAT1_GetSN function returns a pointer to the sysop's
 name string.

SYSDAT1_DAT_PutSN(s AS STRING)
 This form of the SYSDAT1_DAT_PutSN function sets the sysop's name string to
 the string pointed to by "s". Note that the string pointed to by "s" can be
 no more than 60 characters in length.

SYSDAT1_DAT_GetDAE() AS STRING
 This form of the SYSDAT1_DAT_GetDAE function returns a pointer to the default
 archive extension string.

SYSDAT1_DAT_PutDAE(s AS STRING)
This form of the SYSDAT1_DAT_PutDAE function sets the default archive
extension string to the string pointed to by "s". Note that the string pointed
to by "s" can be no more than 3 characters in length. "s" must be one of the
following values:

    ZIP      For ZIP.
    ARC      For ARC.
    ARJ      For ARJ.
    LZH      For LHA.
    PAK      For PAK.
    RAR      For RAR.
    SDN      For SDN.

SYSDAT1_DAT_GetSP() AS STRING
 This form of the SYSDAT1_DAT_GetSP function returns a pointer to the system
 password string.

SYSDAT1_DAT_PutSP(s AS STRING)
 This form of the SYSDAT1_DAT_PutSP function sets the system password function
 string to the string pointed to by "s". Note that the string pointed to by
 "s" can be no more than 15 characters in length.

SYSDAT1_DAT_GetVCCL() AS STRING
 This form of the SYSDAT1_DAT_GetVCCL function returns a pointer to the virus
 checker command line string.

SYSDAT1_DAT_PutVCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutVCCL function sets the virus checker command
 line string to the string pointed to by "s". Note that the string pointed to
 by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetZIPCCL() AS STRING
 This form of the SYSDAT1_DAT_GetZIPCCL function returns a pointer to the ZIP
 compression command line string.

SYSDAT1_DAT_PutZIPCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutZIPCCL function sets the ZIP compression
 command line string to the string pointed to by "s".  Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetZIPUCCL() AS STRING
 This form of the SYSDAT1_DAT_GetZIPUCCL function returns a pointer to the
 ZIP decompression command line string.

SYSDAT1_DAT_PutZIPUCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutZIPUCCL function sets the ZIP decompression
 command line string to the string pointed to by "s". Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetARJCCL() AS STRING
 This form of the SYSDAT1_DAT_GetARJCL function returns a pointer to the ARJ
 compression command line string.

SYSDAT1_DAT_PutARJCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutARJCCL function sets the ARJ compression
 command line string to the string pointed to by "s".  Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetARJUCCL() AS STRING
 This form of the SYSDAT1_DAT_GetARJUCCL function returns a pointer to the
 ARJ decompression command line string.

SYSDAT1_DAT_PutARJUCCL(s AS STRING)
 This form of the SYDAT1_DAT_PutARJUCCL function sets the ARJ decompression
 command line string to the string pointed to by "s". Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetLZHCCL() AS STRING
 This form of the SYSDAT1_DAT_GetLZHCCL function returns a pointer to the
 LZH compression command line string.

SYSDAT1_DAT_PutLZHCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutLZHCCL function sets the LZH compression
 command line string to the string pointed to by "s".  Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetLZHUCCL() AS STRING
 This form of the SYSDAT1_DAT_GetLZHUCCL function returns a pointer to the
 LZH decompression command line string.

SYSDAT1_DAT_PutLZHUCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutLZHUCCL function sets the LZH decompression
 command line string to the string pointed to by "s". Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetARCCCL() AS STRING
 This form of the SYSDAT1_DAT_GetARCCCL function returns a pointer to the
 ARC compression command line string.

SYSDAT1_DAT_PutARCCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutARCCCL function sets the ARC compression
 command line string to the string pointed to by "s".  Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetARCUCCL() AS STRING
 This form of the SYSDAT1_DAT_GetARCUCCL function returns a pointer to the
 ARC decompression command line string.

SYSDAT1_DAT_PutARCUCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutARCUCCL function sets the ARC decompression
 command line string to the string pointed to by "s". Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetPAKCCL() AS STRING
 This form of the SYSDAT1_DAT_GetPAKCCL function returns a pointer to the PAK
 compression command line string.

SYSDAT1_DAT_PutPAKCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutPAKCCL function sets the PAK compression
 command line string to the string pointed to by "s".  Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetPAKUCCL() AS STRING
 This form of the SYSDAT1_DAT_GetPAKUCCL function returns a pointer to the
 PAK decompression command line string.

SYSDAT1_DAT_PutPAKUCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutPAKUCCL function sets the PAK decompression
 command line string to the string pointed to by "s". Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetSDNCCL() AS STRING
 This form of the SYSDAT1_DAT_GetSDNCCL function returns a pointer to the SDN
 compression command line string.

SYSDAT1_DAT_PutSDNCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutSDNCCL function sets the SDN compression
 command line string to the string pointed to by "s".  Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetSDNUCCL() AS STRING
 This form of the SYSDAT1_DAT_GetSDNUCCL function returns a pointer to the
 SDN decompression command line string.

SYSDAT1_DAT_PutSDNUCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutSDNUCCL function sets the SDN decompression
 command line string to the string pointed to by "s". Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetRARCCL() AS STRING
 This form of the SYSDAT1_DAT_GetRARCCL function returns a pointer to the
 RAR compression command line string.

SYSDAT1_DAT_PutRARCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutRARCCL function sets the RAR compression
 command line string to the string pointed to by "s". Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetRARUCCL() AS STRING
 This form of the SYSDAT1_DAT_GetRARUCCL function returns a pointer to the
 RAR decompression command line string.

SYSDAT1_DAT_PutRARUCCL(s AS STRING)
 This form of the SYSDAT1_DAT_PutRARUCCL function sets the RAR decompression
 command line string to the string pointed to by "s". Note that the string
 pointed to by "s" can be no more than 80 characters in length.

SYSDAT1_DAT_GetBSD() AS STRING
 This form for the SYSDAT1_DAT_GetBSD function returns a pointer to the
 board's starting date string.

SYSDAT1_DAT_PutBSD(s AS STRING)
 This form of the SYSDAT1_DAT_PutBSD function sets the board's starting date
 string to the string pointed to by "s". Note that the string pointed to by
 "s" can be no more than 8 characters in length and must use the format
 "MM/DD/YY".

SYSDAT1_DAT_GetTN() AS INTEGER
 This form of the SYSDAT1_DAT_GetTN function returns the board's number of
 nodes.

SYSDAT1_DAT_PutTN(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutTN function sets the board's number of nodes
 to the value passed in "n". "n" must be in the range of 1 to 255.

SYSDAT1_DAT_GetCT() AS INTEGER
 This form of the SYSDAT1_DAT_GetCT function returns the board's calls for
 the day.

SYSDAT1_DAT_PutCT(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutCT function sets the board's calls for the
 day to the value passed in "n".

SYSDAT1_DAT_GetMT() AS INTEGER
 This form of the SYSDAT1_DAT_GetMT function returns the board's number of
 messages for the day.

SYSDAT1_DAT_PutMT(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutMT function sets the board's number of
 messages for the day to "n".

SYSDAT1_DAT_GetUT() AS INTEGER
 This form of the SYSDAT1_DAT_GetUT function returns the board's number of
 uploads for the day.

SYSDAT1_DAT_PutUT(n AS INTEGER)
 This form of the SYSDAT1_DAT_GetUT function sets the board's number of
 uploads for the day to "n".

SYSDAT1_DAT_GetDT() AS INTEGER
 This form of the SYSDAT1_DAT_GetDT function returns the board's number of
 downloads for the day.

SYSDAT1_DAT_PutDT(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutDT function sets the board's number of
 downloads for the day to "n".

SYSDAT1_DAT_GetDDTL() AS INTEGER
 This form of the SYSDAT1_DAT_GetDDTL function returns the board's default
 daily time limit.

SYSDAT1_DAT_PutDDTL(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutDDTL function sets the board's default daily
 time limit to "n".

SYSDAT1_DAT_GetDDL() AS INTEGER
 This form of the SYSDAT1_DAT_GetDDL function returns the boards default
 daily logon limit.

SYSDAT1_DAT_PutDDL(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutDDL function sets the board's default daily
 logon limit to "n".

SYSDAT1_DAT_GetDTPL() AS INTEGER
 This form of the SYSDAT1_DAT_GetDTPL function returns the board's default
 time per logon.

SYSDAT1_DAT_PutDTPL(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutDTPL function sets the board's default time
 per logon to "n".

SYSDAT1_DAT_GetMSSL() AS INTEGER
 This form of the SYSDAT1_DAT_GetMSSL function returns the board's minimum
 sysop security level.

SYSDAT1_DAT_PutMSSL(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutMSSL function sets the board's minimum sysop
 security level to "n". "n" must be in the range of 1 to 9999.

SYSDAT1_DAT_GetNUSL() AS INTEGER
 This form of the SYSDAT1_DAT_GetNUSL function returns the board's new user
 security level.

SYSDAT1_DAT_PutNUSL(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutNUSL function sets the board's new user
 security level to "n". "n" must be in the range of 1 to 9999.

SYSDAT1_DAT_GetNUTL() AS INTEGER
 This form of the SYSDAT1_DAT_GetNUTL function returns the board's new user
 time limit.

SYSDAT1_DAT_PutNUTL(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutNUTL function sets the board's new user time
 limit to "n".

SYSDAT1_DAT_GetUTCR() AS INTEGER
 This form of the SYSDAT1_DAT_GetUTCR function returns the board's upload
 time compensation ratio.

SYSDAT1_DAT_PutUTCR(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutUTCR function sets the board's upload time
 compensation ratio to "n".

SYSDAT1_DAT_GetMFASL() AS INTEGER
 This form of the SYSDAT1_DAT_GetMFASL function returns the board's minimum
 file attachment security level.

SYSDAT1_DAT_PutMFASL(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutMFASL function sets the board's minimum file
 attachement security level to "n". "n" must be in the range of 1 to 9999.

SYSDAT1_DAT_GetMAVSL() AS INTEGER
 This form of the SYSDAT1_DAT_GetMAVSL function returns the board's minimum
 @-variable security level.

SYSDAT1_DAT_PutMAVSL(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutMAVSL function sets the board's minimum
 @-variable security level to "n". "n" must be in the range of 1 to 9999.

SYSDAT1_DAT_GetFLSL() AS INTEGER
 This form of the SYSDAT1_DAT_GetFLSL function returns the board's fast
 logon security level.

SYSDAT1_DAT_PutFLSL(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutFLSL function sets the board's fast logon
 security level to "n". "n" must be in the range of 1 to 9999.

SYSDAT1_DAT_GetTC() AS LONG
 This form of the SYSDAT1_DAT_GetTC function returns the board's total calls.

SYSDAT1_DAT_PutTC(n AS LONG)
 This form of the SYSDAT1_DAT_PutTC function sets the board's total calls to
 "n".

-----------------------------------------------------------------------------
All BIT Field Flags below have been converted to Integers to allow easier
access and handling.
----------------------------------------------------------------------------
SYSDAT1_DAT_GetPNSF() AS INTEGER
 This form of the SYSDAT1_DAT_GetPN function returns the board's phone number
 style flag.

SYSDAT1_DAT_PutPNSF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutPNSF function sets the board's phone number
 style flag to "n". "n" must be in the range of 0 to 1 as follows:

    0 = Do not format phone number.
    1 = North American-style phone numbers.

SYSDAT1_DAT_GetTUF() AS INTEGER
 This form of the SYSDAT1_DAT_GetTUF function returns the board's test uploads
 flag.

SYSDAT1_DAT_PutTUF(n AS INTEGER)
 This form of the SYSDAT1_DAT_GetTU function sets the board's test uploads
 flag to "n". "n" must be in the range of 0 to 1 as follows:

    0 = Do not test uploads.
    1 = Test uploads.

SYSDAT1_DAT_GetAADF() AS INTEGER
 This form of the SYSDAT1_DAT_GetAADF function returns the board's auto ANSI
 detect flag.

SYSDAT1_DAT_PutAADF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutAADF function sets the board's auto ANSI
 detect flag to "n". "n" must be in the range of 0 to 1 as follows:

    0 = Do not auto detect ANSI.
    1 = Auto detect ANSI.

SYSDAT1_DAT_GetCFWMF() AS INTEGER
 This form of the SYSDAT1_DAT_GetCFWMF function returns the board's waiting
 message check flag.

SYSDAT1_DAT_PutCFWMF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutCFWM function sets the board's waiting
 message check flag to "n". "n" must be in the range of 0 to 1 as follows:

    0 = Do not check for waiting messages at logon.
    1 = Check for waiting messages at logon.

SYSDAT1_DAT_GetUDRTF() AS INTEGER
 This form of the SYSDAT1_DAT_GetUDRTF function returns the board's
 upload/download ratio type flag.

SYSDAT1_DAT_PutUDRTF(n AS INTEGER)
 This form of the SYSDAT1_DAT_GetUDRTF function sets the board's
 upload/download ratio type flag to "n". "n" must be in the range of 0 to 1
 as follows:

    0 = Use sliding security levels.
    1 = Ratios only effect download ability.

SYSDAT1_DAT_GetPOHDMF() AS INTEGER
 This form of the SYSDAT1_DAT_GetPOHDM function returns the board's phone on
 hook during maintenace flag.

SYSDAT1_DAT_PutPOHDMF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutPOHDMF function sets the board's phone on
 hook during maintenance flag to "n". "n" must be in the range of 0 to 1 as
 follows:

    0 = Take phone off hook during maintainance.
    1 = Do not take the phone off hook during maintainance.

SYSDAT1_DAT_GetNOWNF() AS INTEGER
 This form of the SYSDAT1_DAT_GetNOWNF function returns the board's no one
 word names flag.

SYSDAT1_DAT_PutNOWNF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutNOWN function sets the board's no one word
 names flag to "n". "n" must be in the range of 0 to 1 as follows:

    0 = Allow one word names.
    1 = Do not allow one word names.

SYSDAT1_DAT_GetNBMALF() AS INTEGER
 This form of the SYSDAT1_DAT_GetNBMALF function returns the board's no
 bulletin menu at logon flag.

SYSDAT1_DAT_PutNBMALF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutNBMAL function sets the board's no bulletin
 menu at logon flag to "n". "n" must be in the range of 0 to 1 as follows:

    0 = Display bulletin menu at logon.
    1 = Do not display bulletin menu at logon.

SYSDAT1_DAT_GetAAF() AS INTEGER
 This form of the SYSDAT1_DAT_GetAAF function returns the board's allow
 aliases flag.

SYSDAT1_DAT_PutAAF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutAAF function sets the board's allow aliases
 flag to "n". "n" must be in the range of 0 to 1 as follows:

    0 = Do not allow aliases.
    1 = Allow aliases.

SYSDAT1_DAT_GetCSBMF() AS INTEGER
 This form of the SYSDAT1_DAT_GetCSBM function returns the board's clear
 screen before menus flag.

SYSDAT1_DAT_PutCSBMF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutCSBMF function sets the board's clear screen
 before menus flag to "n". "n" must be in the range of 0 to 1 as follows:

    0 = Do not clear the screen before menus.
    1 = Clear the screen before menus.

SYSDAT1_DAT_GetEFNMFDF() AS INTEGER
 This form of the SYSDAT1_DAT_PutEFNMFDF function returns the board's exact
 file name matching for dupes flag.

SYSDAT1_DAT_PutEFNMFDF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutEFNMFD function sets the board's exact file
 name matching for dupes flag to "n". "n" must be in the range of 0 to 1 as
 follows:

    0 = Ignore the extension during duplicate file checking.
    1 = Do not ignore the extension during duplicate file checking.

SYSDAT1_DAT_GetDNUBPF() AS INTEGER
 This form of the SYSDAT1_DAT_GetDNUBPF function returns the board's disable
 new user birthday prompt flag.

SYSDAT1_DAT_PutDNUBPF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutDNUBPF function sets the board's disable
 new user birthday prompt flag to "n". "n" must be in the range of 0 to 1 as
 follows:

    0 = Display the birthday prompt to a new user at logon.
    1 = Do not display the birthday prompt to a new user at logon.

SYSDAT1_DAT_GetDDCLF() AS INTEGER
 This form of the SYSDAT1_DAT_GetDDCLF function returns the board's disable
 detailed callers log flag.

SYSDAT1_DAT_PutDDCLF(n AS INTEGER)
 This form of the SYSDAT1_DAT_GetDDCLF function sets the board's disable
 detailed callers log flag to "n". "n" must be in the range of 0 to 1 as
 follows:

    0 = Use a detailed callers log.
    1 = Do not use a detailed callers log.

SYSDAT1_DAT_GetEREF() AS INTEGER
 This form of the SYSDAT1_DAT_GetEREF function returns the board's enable
 RIPscrip emulation flag.

SYSDAT1_DAT_PutEREF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutEREF function sets the board's enable
 RIPscrip emulation flag to "n". "n" must be in the range of 0 to 1 as
 follows:

    0 = Do not enable RIPscrip.
    1 = Enable RIPscrip.

SYSDAT1_DAT_GetUAORNF() AS INTEGER
 This form of the SYSDAT1_DAT_GetUAORNF function returns the board's use
 alias or real names flag.

SYSDAT1_DAT_PutUAORNF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutUAORN function sets the board's use alias or
 real names flag to "n". "n" must be in the range of 0 to 1 as follows:

    0 = Uses the caller's alias for between node information purposes.
    1 = Uses the caller's real name for between node information purposes.

SYSDAT1_DAT_GetCUADF() AS INTEGER
 This form of the SYSDAT1_DAT_GetCUADF function returns the board's clear
 uploads and downloads flag.

SYSDAT1_DAT_PutCUADF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutCUADF function sets the board's clear
 uploads and downloads flag to "n". "n" must be in the range of 0 to 1 as
 follows:

    0 = Do not clear the user's upload and download counters when a user's
        subscription expires.
    1 = Clear the user's upload and download counters when a user's
        subscription expires.

SYSDAT1_DAT_GetCPMAF() AS INTEGER
 This form of the SYSDAT1_DAT_GetCPMAF function returns the board's clear
 private message areas flag.

SYSDAT1_DAT_PutCPMAF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutCPMAF function sets the board's clear private
 message areas flag to "n". "n" must be in the range of 0 to 1 as follows:

    0 = Do not clear the user's private message area flags when the user's
        subscription expires.
    1 = Clear the user's private message area flags when the user's
        subscription expires.

SYSDAT1_DAT_GetCPFAF() AS INTEGER
 This form of the SYSDAT1_DAT_GetCPFAF function returns the board's clear
 private file areas flag.

SYSDAT1_DAT_PutCPFAF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutCPFAF function sets the board's clear private
 file areas flag to "n". "n" must be in the range of 0 to 1 as follows:

    0 = Do not clear the user's private file area flags when the user's
        subscription expires.
    1 = Clear the user's private file area flags when the user's subscription
        expires.

SYSDAT1_DAT_GetDUBF() AS INTEGER
 This form of the SYSDAT1_DAT_GetDUBF function returns the board's disable
 uploaded by flag.

SYSDAT1_DAT_PutDUBF(n AS INTEGER)
 This form of the SYSDAT1_DAT_PutDUBF function sets the board's disable
 uploaded by flag to "n". "n" must be in the range of 0 to 1 as follows:

    0 = Put "Uploaded By:" lines in the file list when a file is uploaded.
    1 = Do not put "Uploaded By:" lines in the file list when a file is
        uploaded.