IIU Presents... - L o c a l v 0 . 3 0 - INTRODUCTION ------------ Local is a tsr utility for dos-based machines that provides access to "important information" while online. To install, copy the .dat and .doc files to a nice, safe directory where they can live unmolested. put the .exe files somewhere in your path and away you go. to execute, slip the program a path to the .dat files, such as: local c:\dos\data\ the trailing slash is important. to activate, press shift-f2. shift-f4 removes the tsr from memory. The following is a complete list of files for this archive: local.exe - tsr application program local.doc - doc file loc-util.exe - utilities dialdata.dat - data file for dialups sysident.dat - data file system types PROGRAM PURPOSE --------------- hopefully, this program will aid you in getting rid of your "bust-me" book. isnt it sorta silly to spend all our time on these damn machines, but still use paper and pencil to keep track of stuff? of course, those of you will real operating systems (x, amigados, etc) dont have the problems that dos users do, ie: its very hard to talk dos into doing two things of once. thats the whole point in this program running as a tsr. enough of the prelims, lets get down to the meat of the thing... DATA FORMAT ----------- heres the format for a dialup entry: |---- dialup npa (area code) 3 numbers | |--- dialup prefix 3 numbers | | |--- dialup suffix 3 numbers | | | |--- baud rate (30, 12, 24, or 96) | | | | |--- parameters (three chars, ie: 8n1 7e1 ???) | | | | | |--- caps indicator (C if system is upper case only) | | | | | | |--- emulation (tty, ansi, etc) NPA PRE SUFF BD PAR C EMULA SYSTEM_IDENT A S P C T LABEL | | | | | | |--- label for dialup | | | | | | (text 24 chars) | | | | | |--- accounts? (! == yes) | | | | |--- comments? (! == yes) | | | |--- privacy level (0-4) | | |--- security level (0-4) | |--- access level (0-4) |--- operating system (unix, vms, wang) user-definable, select from 240 types additionally, there are three text fields: response: 60 chars, text that dialup sends when first logging on comments: 60 chars, any text sets the ! char... see comments above accounts: 60 chars, any text sets the ! char... see accounts above a typical entry might look like this: NPA PRE SUFF BD PAR C EMULA SYSTEM_IDENT A S P C T LABEL 555 1212 96 7e1 unix 1 4 4 ! ! nsa central facility this system would be in the default npa (user-definable, npa will not print if same as default), and the phone # would be 555-1212. 9600 baud, 7e1 for parms, tty for emulation, (tty in the emulation field is not printed, due to the number of tty systems) and the operating sytem would be unix. access level is 1 (none), security level is 4(scary) and privacy level is 4 (mine). the !'s in the comment and account fields denote text in those fields. label text: figure it out THE APPLICATION --------------- After pressing shift-f2, the following menu will be presented: Add Dialups View/Modify Dialups View/Modify System Types Ascii Table Exit Add Dialups ----------- This creates an entry with default parameters and allows you to fill in the rest of the information. here are the defaults (note, only the default npa is changeable, all other defaults are hard-coded) npa: default npa baud: 2400 parms: 7e1 caps: mixed system_ident: unknown accounts: 0 security: 0 privacy: 0 all other fields blank also note that the access, security, and privacy fields are displayed in the dialup entry as 0-4, but when adding or editing an entry, the following choices are presented: access: untested none some more mine security: unknown none some more scary privacy: unrated none some more mine the leftmost choices are 0, while the rightmost are 4. if the field is set to 0, the number will not be displayed in the dialup entry. use of these fields is in no way required, and can be ignored if you wish. entering text into the comments or accounts text field causes a ! to appear on the dialup entry. View/Modify Dialups ------------------- this brings up a window that shows eight dialup entries at one time. the currently selected dialup will be shown in green. you may scroll around these entries with the arrow keys and change pages with pgup and pgdn. a page counter is located in the bottom right hand corner of the screen. Available options are: Enter-View: Shows the full record for the current entry. this is basically just the entry shown at the top of the screen, with the label, response, comments, and accounts text fields displayed. E-Edit: Very similar to the add function, but all information from the highlighted dialup entry is filled in, allowing you to change any information for the entry. AltD-Delete: Deletes the highlighted entry. F-Find: fill in any values you wish to find. the search starts at the dialup following the current one. simply hit enter for those fields you do not wish to search on. for text fields, substrings will be matched. (sorry, no wildcards) A-Again: searchs for the information last entered with the Find command L-Legend: displays brief explanation of the data format. T-Top: jump to start of dialup entries B-Bottom: jump to end of dialup entries View/Modify System Types ------------------------ allows you to add new system types or edit existing ones. to add a new entry, just keep hitting pgdn until you come to some blank entries. move to a blank entry and hit enter to assign text to this entry. a few system types have been provided with this archive, but youll undoubtedly want to add some of your own. the maximum number of entries is 240. Ascii Table ----------- something to trick the peons into using this program. displays ibm normal and extended ascii codes. UTILITIES --------- the loc-util program provides a variety of servies that were better implemented in a seperate program, rather than attempting to code them for use in a tsr. typing loc-util by itself will present the following options: 1 - initialize dialdata.dat 2 - sort sysident.dat 3 - sort dialdata.dat 4 - change default npa 5 - import toneloc data file Option 1 -------- this re-initalizes the dialdata.dat file. warning: any dialups you already have WILL be inaccessable after selecting this option. Option 2 -------- sorts the system types in sysident.dat into alphabetical order. good to run after adding new system types. Option 3 -------- sorts dialdata.dat (dialups) according to user specs. all sorts are ascending, and only the following fields may be sorted on: number (npa+pre+suff) system type label response comments accounts Option 4 -------- this patches local.exe with a new default area code. no tricks, npa must be a three digit number, not starting with 0. Option 5 -------- this accepts a toneloc .dat file as input and tacks all the dialups onto the tail end of dialdata.dat. the npa and prefix are also requested. toneloc imports are identified by the 'toneloc' entry under system_ident. other defaults: 300 baud, 7e1 parms, tty emulation, and mixed caps. SECURITY -------- for all practical purposes, this version of local is a joke security-wise. if this program is being used seriously, some animal cunning is required. one method would be to encrypt dialdata.dat with a third party program, such as pgp or vincrypt. remember: feds confiscate EVERYTHING. PROBLEMS AND PITFALLS --------------------- getting a tsr to run on some systems is a real hassle. if any tsrs give you memory problems, youll definately have trouble with this one. it uses an entire segment of memory (64K) and the manner it operates in may give some programs the heebee jeebies. ive tested with telix v3.20 and terminate v1.0 and had no problems whatsoever. YMMV. two programs that have problems for sure are gedit and the borland c compiler. they run fine with the tsr installed, just dont try to pop it up. also: dont try to deactivate the tsr when another program is running. exit to dos first. because of the limitations when writing a tsr, this program is extremely simple and at times can be very slow. while there is no practical limit on the number of dialup entries, it can get pretty slow going above 20 or 30 pages. (thats 160 entries) 486's and the like shouldnt have any problems, but lower grade machines will suffer. the delete function in view/modify dialups is particularly slow if you delete an entry near the beginning of the data file. and finally, i cant account for every situation. if you insist on doing something silly, like adding dialups during a file transfer, i REFUSE to take any flack for it. bug reports are appreciated, but use some common sense. CLOSING ------- 100% written in C, with tsr support functions confiscated from "the art of C" by herbert schildt, and based on an earlier program program of mine called telenet. hopefully, not too many people saw it. program suggestions, comments, etc welcome if youre proficient in coding to any degree. other- wise, shut the hell up. IIU 93 special thanx to: dr delam & maldoror greets to: pscream, GP, kaleidox, hannibal, el penga, uyi & krew