Preface

This document was revised for WGM-DMS version 3.3.

WGM-DMS software copyright (c) 1988, 1990 Wayne G. Maas, All rights reserved.

This document copyright (c) 1988, 1990 Wayne G. Maas, All rights reserved.

Any specific hardware/software names used in this documentation are trademarks of specific manufacturers.

Introduction

WGM-DMS is the one utility that will take care of most of your needs with respect to PCBoard directory files. WGM-DMS will create and color headers for your PCBoard file directories, conference directory files, a bulletin of specified conferences, and up to 99 master file listings that you can make available to your users for downloading.

I wish to extend a special thanks to all of the Sysops who have helped me in the testing and locating the scattered bugs in the software. You all know who you are.

System Requirements

To run WGM-DMS software, you will need the following:

1.	IBM PC/XT/AT, PS/2 or 100% compatible machine.

2.	Color or Monochrome Graphics adapter

3.	MS-DOS 3.1 or higher

4.	PCBoard Version 12.0 or later.

To ensure 100% data integrity and efficiency, all of your system's nodes must be down. As of this writing, WGM-DMS has about 75% of its I/O routines written with network support. In future updates, this will be expanded upon so that WGM-DMS can run while your system is in use.

Installation

To install WGM-DMS software, create a sub-directory of your choice on your hard drive and copy the files from the distribution disk into that directory.

Consult your DOS manual if you need any further help.

Configuration

By now you are probably anxious to start WGM-DMS. Before you can run WGM-DMS utility, you must create and configure a text file that will contain all the necessary parameters WGM-DMS needs to operate correctly. The distribution disk contains an example of the configuration file needed by WGM-DMS. With your favorite text editor, simply load this file and edit it to reflect your system requirements. You can rename this file if you wish. If you do, it must be a valid DOS filename.

In the following sections, the configuration file will be discussed in detail and the configuration file parameters explained. There are five areas that will need to be discussed.

They are:

1.	System Parameters

2.	Conference Directory Parameters

3.	Bulletin Parameters

4.	Master File Listing Parameters

Please note that 3 and 4 are only available in the "/D" (Deluxe) version. This can be obtained by sending in the order form that is available within the ZIP file.

System Parameters

The parameters discussed in this section are the items that WGM-DMS needs to know in order to operate. This is general information that is shared by all the functions of this program.

BBSNAME=

This parameter is the name of the BBS running WGM-DMS. This will be used in conjunction with the serial number to determine if the software has been registered correctly.

ie: BBSNAME=Your BBS Name goes here

SERIAL=

This parameter is the serial number that is supplied to you when your registered WGM-DMS. This can be 5 or 6 characters in length.

ie: SERIAL=123456

CNAMES=

This parameter is the location and name of the CNAMES file used by your system. This lets WGM-DMS know where PCBoard's conference data files reside so it can retrieve the information it needs to process the directory files. This must be a valid DOS filename and can include an optional drive and/or path.

ie: CNAMES=C:\PCB\MAIN\CNAMES

BACKUP=

This parameter tells WGM-DMS whether or not to backup all files that it processes. This is a safety feature so if something does happen, you have backups to rely on. This is specified by either a YES or NO.

ie: BACKUP=YES

LOGFILE=

This parameter tells WGM-DMS where to record all of the programs activity. If any errors occur, they will be logged to this file so you can investigate them after WGM-DMS has completed it's processing. This must be a valid DOS filename and can include an optional drive and/or path.

ie: LOGFILE=C:\PCB\DMS\WGM-DMS.LOG

The options that will be discussed next are required to take full advantage of WGM-DMS directory header coloring capabilities. These parameters are used to determine the colors for the various outputs the program generates. These options require the knowledge of PCBoard '@X' color codes.

The parameters for the color options are in a fixed format that must be followed. The format is:	@Xyz

y	represents the background color. This is a single hexadecimal digit in the range of 0 to F.

z	represents the foreground color. This is a single hexadecimal digit in the range of 0 to F.

Below is a chart indicating what values represent what colors.

BACKGROUND (first digit)	FOREGROUND (second digit)

Black	= 0	Black	= 0

Blue	= 1	Blue	= 1

Green	= 2	Green	= 2

Cyan	= 3	Cyan	= 3

Red	= 4	Red	= 4

Magenta	= 5	Magenta	= 5

Yellow	= 6	Yellow	= 6

White	= 7	White	= 7

BACKGROUND with Blinking	High Intensity Foregrounds

Black	= 8	Black	= 8

Blue	= 9	Blue	= 9

Green	= A	Green	= A

Cyan	= B	Cyan	= B

Red	= C	Red	= C

Magenta	= D	Magenta	= D

Yellow	= E	Yellow	= E

White	= F	White	= F

HDRFRAME=

The color values that you assign to this option will determine the color that will be used for the frame in the directory header.

ie: HDRFRAME=@X1F >High intensity white on a blue background.

HDRBOARD=

The color values that you assign to this parameter will determine the color of the BBS name within the directory header.

ie: HDRBOARD=@X1E >High intensity yellow on a blue background.

HDRDESCR=

The color values that you assign to this parameter will determine the color of the file directory description within the directory header.

ie: HDRDESCR=@X1E >High intensity yellow on a blue background.

HDRUPDAT=

The color values that you assign to this option will determine the color of the time and date stamp within the directory header.

ie: HDRUPDAT=@X4F >High intensity white on a red background.

HDRTEXTS=

The color values that you assign to this option will determine the color that will be used for all the text in the directory header (excluding the numeric values).

ie: HDRTEXTS=@X1B >High intensity white on a black background.

HDRSTATS=

The color values that you assign to this option will determine the color that will be used for the numeric statistics in the directory header.

ie: HDRSTATS=@X1F >High intensity white on a blue background.

Conference Directory Parameters

The parameters discussed in this section are the items that WGM-DMS needs to know in order to create the conference DIR (conference directory) files. These are the files that are displayed when a (F) is entered at the Main Board Command prompt.

DIRFILE=

This parameter lets you tell WGM-DMS what conferences to create the conference DIR files for. The way you specify the conferences is by placing the conference number after the equal sign. If you are specifying more than 1 conference, just place a comma after the number. If you want to create a conference DIR for all your conferences, place the word ALL after the equal sign. If you do not wish to create any DIR files, place the word NONE after the equal sign.

ie: DIRFILE=0,1,2,3,4,5

The above example tells WGM-DMS to create conference DIR files for the Main Board and the first five conferences.

ie: DIRFILE=ALL

The above example tells WGM-DMS to create conference DIR files for all of the conferences.

ie: DIRFILE=NONE

The above example tells WGM-DMS not to create any DIR files.

DHEADER=

This parameter is the valid DOS filename of a text file that will be inserted the in the header of the conference DIR (conference directory) files.

This file can contain the PCBoard '@X' color codes.

If a filename is specified but not found, an appropriate message will be posted to the log file.

ie: DHEADER=C:\PCB\GEN\DHEADER.TXT

Bulletin Parameters

The parameters discussed in this section are the items that WGM-DMS needs to know in order to create the bulletin file.

BLTFILE=

This parameter lets you tell WGM-DMS what conferences to create conference BLT file for. The way you specify the conferences is by placing the conference number after the equal sign. If you are specifying more than 1 conference, just place a comma after the number. If you want to create a bulletin for all your conferences, place the word ALL after the equal sign. If you do not wish to create a bulletin, place the word NONE after the equal sign.

ie: BLTFILE=0,1,2,3,4,5

The above example tells WGM-DMS to create a bulletin file for the Main Board and the first five conferences.

ie: BLTFILE=ALL

The above example tells WGM-DMS to create a bulletin file for all of the conferences.

ie: BLTFILE=NONE

The above example tells WGM-DMS not to create a bulletin file.

BHEADER=

This parameter is the valid DOS filename of a text file that will be inserted the in the header of the BLT (bulletin) file.

This file can contain the PCBoard '@X' color codes.

If a filename is specified but not found, an appropriate message will be posted to the log file.

ie: BHEADER=C:\PCB\GEN\BHEADER.TXT

BLTNAME=

This parameter tells WGM-DMS the name of the file to store the bulletin information. This must be a valid DOS filename and can include an optional drive and/or path.

ie: BLTNAME=C:\PCB\GEN\BLT99

Master File listing Parameters

There are three parameters needed to create one downloadable master file listing. These three parameters are MASTERxx, REPORTxx, and DIRECTxx. The xx in the parameter names reflect the number of the master listing your are creating. These can range from 01-99 and must start with 01. For example, suppose you want to create two separate files that a user can download. For two master file listings, you will need two sets of the three parameters. They would be as follows:

MASTER01=

REPORT01=

DIRECT01=

and:

MASTER02=

REPORT02=

DIRECT02=

MASTERxx=

This is the first of the three parameters. This tells WGM-DMS which conferences you want to include when it creates the master listing file. The way you specify the conferences is by placing the conference number after the equal sign. If you are specifying more than one conference, just place a comma after the number.

ie: MASTER01=0,1,2,3,4,5

The above example tells WGM-DMS to process the directories for the Main Board and the first five conferences.

REPORTxx=

This is the second of the three parameters. This tells WGM-DMS the file name to create when processing the conferences specified in the MASTERxx parameter.

******* DO NOT specify an extension on this file. ********

WGM-DMS will attach its own extension to this filename. This must be a valid DOS filename and can include an optional drive and/or path.

ie: REPORT01=C:\PCB\UPDIR\ALLFILES

DIRECTxx=

The last of the three parameters tells WGM-DMS the name of the PCBoard DIRxx file to scan so that the file created above will have the correct number of bytes and the current system date. This was implemented so you don't need to put 12-31-99 as a file date just so it appears when users do a "N S A".

ie: DIRECT01=C:\PCB\MAIN\UPDIR

To create more then one master listing report, just use the same format as above with the exception of the two digit value in the parameter. You would just increment the number from 01 to 02.change the 01 to 02. You can do this for up to 99 separate master file listings. The next three parameters are needed so WGM-DMS can format those master listing files correctly.

PAGELEN=

This parameter tells WGM-DMS at what point to put page breaks in the report.

ie: PAGELEN=58

PHEADER=

This parameter tell WGM-DMS what to use as a header line in the master listing reports.

ie: PHEADER=This will appear at the top of every page.

PFOOTER=

This parameter tell WGM-DMS what to use as a footer line in the master listing reports.

ie: PFOOTER=The will appear at the bottom of every page.

There are two parameters left that are essential to the creation of the master file listings. These two parameters are described in the following.

COMPEXT=

This parameter tells WGM-DMS the method of the compression utility you are using. Since the extension for each utility is unique, I use this to determine the correct command line parameters to pass to the utility when compressing the master listings. WGM-DMS currently supports ZIP, LZH, PAK, ZOO, and ARC(the PKPak version.)

ie: COMPEXT=ZIP

COMPFIL=

This parameter tells WGM-DMS the valid executable DOS filename of the compression utility that you use on your system. This is the utility that will compress the master listings that WGM-DMS creates. Some people, including myself, rename the files to save some keystrokes when using the utility. You can specify the drive, path, and filename if you wish but it isn't necessary if the filename is in your DOS path.

ie: COMPFIL=PKZIP

Starting WGM-DMS Deluxe

After editing and creating a configuration file for your system, you are now ready to execute WGM-DMS. To have WGM-DMS process all the conferences on your system, enter the following at the DOS prompt:

C> WGM-DMS [configuration file]

where [configuration file] is the valid DOS filename of the configuration file for WGM-DMS.

Now you must be saying to yourself, "Self, why am I going to process all my directories every night when only my upload directories are going to change?" Well, execute the following:

C> WGM-DMS [configuration file] /U

where [configuration file] is the valid DOS filename of the configuration file for WGM-DMS.

Notice the /U parameter in this example. This tells WGM-DMS to process only the upload directories to the conferences specified in the WGM-DMS configuration file.

Although WGM-DMS only re-creates the headers in the upload directories, it will still process the conference file directories, bulletin file and master listings.

Technical Support

All purchasers of WGM-DMS will receive unlimited technical support on Innovative Computer Services BBS in Lindenhurst, NY. The data line telephone number is 516-226-3727. All owners of WGM-DMS will receive access to the WGM Software conference setup specifically for technical support. The latest updates and releases will also be made available for downloading. I will be setting up my own BBS in the future. All registered users of WGM-DMS will receive notification when it has been put on-line.

Software Updates

All purchasers of WGM-DMS software will be able to receive minor updates and bug fixes from the technical support conference on Innovative Computer Services BBS for a period of 1 year (see technical support section above). Major updates will be made available at an additional charge to all users. Anyone who purchases the WGM-DMS software 6 months prior to a major update will receive the update free of charge.

Future

As time goes on, there will be more features that will be added to WGM-DMS to ease the job of the PCBoard sysop. If there are any comments or suggestions that you would like to see implemented in WGM-DMS, call Innovative Computer Services BBS and leave a message to WAYNE MAAS in the WGM conference (#3). If you wish to contact me by mail, write to:

Wayne G. Maas

880 Farmington Avenue, #202

West Hartford, CT 06119

License

WGM-DMS is not a Public Domain or Shareware program.

WGM-DMS software is copyrighted by Wayne G. Maas and retains the title and ownership of the WGM-DMS software.

This license grants to you a nonexclusive, transferable license to use WGM-DMS software on a single central processing unit at any one time. You may not electronically transfer WGM-DMS software from one computer to another over a network, nor transfer, sell, assign, rent, or distribute copies of WGM-DMS to others.

You may not modify WGM-DMS, in any way, including but not limited to, decompiling-compiling, patching, disassembling or reverse engineering the program.

This license is effective until terminated. You may terminate the license at anytime by destroying the software and its documentation together with all copies or modifications in any form. Wayne G. Maas has the right to terminate the license immediately if you fail to comply with any term or condition of this Agreement. You agree upon any such termination that you will destroy the software and its documentation together with all copies or modifications in any form.

Wayne G. Maas makes no warranties or representation of any kind, expressed or implied, with respect to WGM-DMS Deluxe, or its quality, reliability, or performance, or its merchantability or fitness for any particular purposes. WGM-DMS is licensed "as-is". You assume the entire risk as to the quality, reliability, and performance of the software and documentation.

In no event shall Wayne G. Maas be liable to you for any consequential, special, incidental, direct, or indirect damages of any kind arising from a failure of this program to operate in a manner so desired by the user.