Piper's Pit BBS/FTP: ibm 0210

home *** CD-ROM | disk | FTP | other *** search

/ Piper's Pit BBS/FTP: ibm 0210 - 0219 / ibm0210-0219 / ibm0213.tar / ibm0213 / CNAV_320.ZIP / CNAV.DOC < prev next >

Wrap

Text File | 1994-07-11 | 16.0 KB | 295 lines

┌─────────────────────────────────────────────────────────────────────────────┐ │ [CNAV] Custom Node Activity Viewer PPE [CNAV] │ └─────────────────────────────────────────────────────────────────────────────┘ Custom Node Activity Viewer PPE (c) 1993-94 by Midnight Slasher Version: 3.20 Modified / Freeware - 07/11/94 - ─────────────────────────────────────────────────────────────────────────────── ─────────────────────────────────────────────────────────────────────────────── <mslasher@io.org> ─────────────────────────────────────────────────────────────────────────────── [ FILES INCLUDED ] ···························································· ─────────────────────────────────────────────────────────────────────────────── CNAV.ACT ····· The Activity Line Configuration File (Optional) CNAV.COL ····· The Color Configuration File (Optional) CNAV.DOC ····· Documentation and Installation Guide CNAV.DAT ····· The Data Configuration File CNAV.EXC ····· The Exclusion List File (Optional) CNAV.HLP ····· The Online Help File CNAV.HST ····· The Revison History/Whats.New File CNAV.OPT ····· The Options File (Optional) CNAV.PPE ····· The Node Activity Viewer PPE CNAV.STA ····· The Statistics Display Screen (Optional) FILE_ID.DIZ ·· Description Identification File ─────────────────────────────────────────────────────────────────────────────── ─────────────────────────────────────────────────────────────────────────────── [ PROGRAM SUMMARY ] ··························································· ─────────────────────────────────────────────────────────────────────────────── This PPE (*PCBoard Programming Language Executable*) installs as a replacement or addition to your CMD.LST file. PCBoard v15.1+ is required to run this program. Its purpose is to replace the stock WHO command with a program that can display such information as: node number, who is online their city/state or affiliations, their current board usage function (via the USERNET file), connect speed and time, security level, transferred and transferring files and more! It also supports a 'Fully Active' mode for BBSs with 18 nodes or less (explained later in this file). The best way to see if this program is for you is to test it out. Follow the installation instructions and try it out ... ─────────────────────────────────────────────────────────────────────────────── ─────────────────────────────────────────────────────────────────────────────── [ INSTALLATION ] ······························································ ─────────────────────────────────────────────────────────────────────────────── 1. Load PCBSETUP 2. Press B ( File Locations ) 3. Press B ( Configuration Files ) 4. Edit CMD.LST ( Press F2 at the CMD.LST File ) Command Security PPE ------- -------- ------------------ ┌- WHO ## DRIVE:\PATH\CNAV.PPE ┌─┼- SPY ## C:\PCB\PPE\CNAV.PPE /DEF=B │ └- CNAV ## C:\PCB\PPE\CNAV.PPE /VERBOSE │ └ Use whatever command you like .. Possible Command Line Parameters: /VERBOSE - Force Verbose Mode ( Include File Transfer Information ) /BRIEF - Force Brief Mode ( Do not include File Transfer Info ) /TINY - Force Tiny Mode ( Show minimal node information ... ) /ACTIVE - Force Active Mode ( interACTIVE Auto-Updating Mode .. ) /DEF=A - Allow user to choose display mode by asking them when they run the program. Default answer will be Active Mode. /DEF=T - Allow user to choose display mode by asking them when they run the program. Default answer will be a Tiny Display. /DEF=B - Allow user to choose display mode by asking them when they run the program. Default answer will be Brief Display. /DEF=V - Allow user to choose display mode by asking them when they run the program. Default answer will be Verbose Display. If no command line parameters are used, a /DEF=V is assumed. 5. Copy the CNAV.* file(s) to the SAME directory as CNAV.PPE 6. Edit the CNAV.* file(s) in a text editor for your board configuration and color preferences. (Instructions are contained in CNAV.* file(s)) NOTE: From my initial tests, this PPE requires about 63k free memory. If you look at your status line when you have logged onto PCBoard, you must have 63k available in the 'memory left' indicator on your status line (the red box). If you do not have the memory, try increasing the window size of your multi-tasker (assuming you are running one) or reduce the overlay size of your PCBoard executable (.EXE) with the OVLSIZE program that comes with PCBoard. ─────────────────────────────────────────────────────────────────────────────── ─────────────────────────────────────────────────────────────────────────────── [ EXTERNAL FILES ] ···························································· ─────────────────────────────────────────────────────────────────────────────── NOTE: You can delete all the files EXCEPT CNAV.PPE and CNAV.DAT. These are the only necessary files. Everything has a default built into the program (thats why its so damn big :) ) CNAV.HLP should also exist, but it isn't crutial. CNAV.DAT = Allows you to setup the number of nodes to monitor, the path and filename(s) to your DSZ.LOG files, and you can optionally setup Telephone Numbers/Modem Types to be displayed in the activity line of <Open Nodes>. A Default CNAV.DAT file has been included for you to follow. CNAV.HLP = The online help file to explain to the user what each mode means, providing you allow the user to choose the mode (ie: do not force a certain mode with a command line parameter). CNAV.ACT = The Activity Configuration File. If this file exits, CNAV will use it for configuration information for the Activity lines. Color codes are supported, and each line must be 38 uncolorized characters or less. Refer to the contained default CNAV.ACT file to see what each line should refer to. Delete this file if you want to use the defaults (when deleted, CNAV will load faster). CNAV.COL = The Color Configuration File. This file allows you to change any or all of the colors used in the program. If you wish to use the default colors, delete this file. It is theoretically faster to load the program if no CNAV.COL file is found and defaults are automatically used. Instructions are contained within this file. CNAV.OPT = The Options Configuration File. This file allows you to toggle the display of <Closed> and <Open> nodes with a Y/N toggle. A Default CNAV.OPT file has been included. If you wish to use the defaults of "Y" for both options, you can delete this file. CNAV.EXC = The Optional Exclusion List. This file allows you to list user names (one to a line) that you DO NOT want to be displayed in a node view if those users happen to be online. IE: CNAV.EXC ------------------ JOHN DOE JANE DOE ------------------ If John Doe is online and is on Node 3, Node 3 will NOT be displayed in a node view (in any mode). Etc. Delete this file if you don't want to exclude any user names. CNAV.STA = The active mode Statistics File. When a user runs CNAV in active mode and then chooses to display the extended information of another online user, this file will be displayed. Since many sysops don't want other users to view the statistics of other members of the BBS, you can edit this file and configure exactly what statistics you want included when a user displays the extended information of another user. This is accomplished by replacement codes. Think of replacement codes as PCBoard Macros (@???@). The following replacement codes are supported. They are the same length as the output fields will be once they are filled in. For example, %CONNECT_STRING will be replaced with the Connection Speed and Port Speed and automatically Left Justified and filled to the full 15 characters. %MIX_USER_FULL_NAME_FIELD = The User Name in Mixed Characters %CAP_USER_FULL_NAME_FIELD = The User Name in Capital Letters %MIX_USERCITYSTATE_FIELD = The User's City/State in Mixed Chrs %CAP_USERCITYSTATE_FIELD = The User's City/State in Capital Letrs %CONNECT_STRING = The Connect Speed & Port Speed %UPT_BYTES = Total Upload Bytes %DNT_BYTES = Total Download Bytes %LAST_SC = Last Directory Scan %LAST_DT = Date of Last Call %LTIM = Time of Last Call %TCAL = Total Number of Calls %UPTF = Total Upload Files %DNTF = Total Download Files %SL = Security Level The actual PCBoard @ codes only work for the current user online, (not for users on other nodes) so don't use those in this file. A sample CNAV.STA file has been included. If you wish to use the default status screen, DELETE the CNAV.STA file. It will be *MUCH* faster to display if it doesn't have to read in the CNAV.STA file. CNAV.STA can not contain any lines that exceed 36 uncolorized characters. This means, if you remove all the @X color codes from the file, it should not exceed 36 characters, starting from column one. This requirement is necessary since the file transfer information (if available) is displayed on the remaining characters on the right side of the screen. This file can not exceed 22 lines/rows. If you wish to display a blank line, include a color code on that line with no other information. The program sees a blank line as the end of the file. ─────────────────────────────────────────────────────────────────────────────── [ ACTIVE MODE ] ······························································· ─────────────────────────────────────────────────────────────────────────────── I thought I'd take a moment to explain Active Mode. The other 3 modes are completely straight forward and do not require any user input. Basically: Tiny Mode - Displays Node # / User Name / User Activity Brief Mode - Displays Node # / User Name / User Activity Security Level / User City / Login Time & Speed Verbose Mode - Same as Brief Mode, but if the user is transferring files it will display the files being transferred/in the users' queue. Active mode is a self-updating node view. You MUST have 18 nodes or less. (If you have 19+ nodes and attempt to run active mode, it will default to Tiny Mode.) When run in this mode, CNAV displays all available nodes to the user. It then will wait for input: either a node number to view extended information on, or the ENTER key or ESC key to exit the program. The input is hotkey activated (does not require the 'ENTER' key, unless you have more than 10 nodes and the user wishes to view node 1). NOTE: If you have 9 nodes or less, the display contains seperation lines. If you have 10-18 nodes, there are no seperation lines. (It was written this way so all nodes can fit on one screen.) During this time, CNAV is checking on the other nodes. If the activity of another node changes, CNAV will update the screen for that node only. For example, if Node 3 was Transferring Files and now is available for Chat, CNAV will only update Node 3 with the proper 'Available for Chat' activity. NOTE: If you have toggled the display of 'OPEN NODES', 'CLOSED NODES' or have 'EXCLUDED' any user names from the node display, CNAV will honor these options (ofcoarse), however, if one of these excluded nodes changes to a node that should be displayed, CNAV will rewrite the entire node display to include the node. (since there was previously no room for it on the display). For example. If you have toggled CNAV to NOT display 'CLOSED NODES' and Node 5 is closed, CNAV will not display node 5. However, if Node 5 is suddenly opened while someone is inside CNAV-Active Mode, the display will be completely updated to include Node 5. If you do allow Active Mode (ie: have 18 nodes or less, or do not force another mode with the /??? parameter), I suggest you delete the .OPT file and display both OPEN and CLOSED nodes (the default). Why? In PCBoard, when a user logs off the system, the node activity line for that node will first be 'CLOSED' while it recycles, and then 'OPENED' once it has recycled and waits for the next caller. Because of this, CNAV-Active Mode would be redrawing the entire screen each time a node recyles (if you toggle one of the options and not the other). Although this still would _not be_ that often, I thought I'd mention it anyway. (if you wondered why CNAV would sometimes redraw the entire active mode screen) :-) Once the user is in CNAV-Active mode, s/he can choose to view the stats or file transfer information of other online members. Open and Closed nodes can not be viewed (they have no stats!) so input will NOT be taken for these nodes (ie: If Node 4 is closed, and the user tries to press "4", nothing will happen). When the user selects to view another online user, the statistics of that user will be displayed. A default screen is included within CNAV, but if you wish to configure this screen, edit the CNAV.STA file. Instructions and further information are discussed above (EXTERNAL FILES - CNAV.STA). Delete the CNAV.STA file if you wish to use the default screen, it is MUCH faster this way. If the user selected is transferring files, their file transfer information will be displayed on the same screen. This is the same information that would be displayed in a VERBOSE node display. If the user aborts the display of the stats/file transfer information, s/he will return to the main Active Mode screen. The user can press ENTER or ESC to exit Active Mode and return to the BBSs main menu. o More to come ... ─────────────────────────────────────────────────────────────────────────────── How to contact the author: Yell real loud, perhaps I'll hear you. or: mslasher@io.org ─────────────────────────────────────────────────────────────────────────────── [EOF] ················································· [MS] / Midnight Slasher ───────────────────────────────────────────────────────────────────────────────