Liren Large Software Subsidy 16

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

/ Liren Large Software Subsidy 16 / 16.iso / t / t272 / 1.img / TMES30.DOC < prev next >

Wrap

Text File | 1993-11-05 | 34.8 KB | 815 lines

TMES 3.0 The Master Environment Set Copyright 1992, 1993 by Tee Roper All Rights Reserved Price ~~~~~ Licensed as FREEWARE for individual use, however, all Corporations and Institutions must Register their use for $50. WHAT DOES TMES DO? ~~~~~~~~~~~~~~~~~~ TMES sets environment variables using current system values. You should use TMES in BATCH files - most of the time. This Version has Forty (40) Functions. DISCLAIMER: Tee Roper cannot be held responsible for TMES' improper use. TMES is a tool that only a Computer Programmer or Professional should use. TMES may have bugs (...but, I hope not...) and future versions WILL BE MADE to correct any bugs made known to me AND to add new features to it. It is up to you to see if TMES will suit your needs and work correctly in your PC "system." I hope that it will. Try it out. Let's get more of the legal stuff out in the open. TMES is copyrighted software. It is offered to you as Shareware. Shareware allows you to try it before you buy it. If you use it you have to pay for it just like you would have to if you had bought a commercial software, shrink-wrapped package. The difference is that the Shareware method allows distribution legally by copying first and then paying for it. You don't get stuck if it doesn't work for you like you want! GOOD NEWS if you use TMES at home for personal use. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you are using TMES for personal use at home, not at your business office, then the registration fee is waived. That means it's free if you use it at home in a non-commercial way. You don't have to register TMES if you are using it ONLY at your home AND for non-commercial use. WHAT'S THE CATCH? HOW DO I MAKE ANY MONEY LIKE THAT? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you are using TMES at work (which I hope TMES will help there) then there is a registration fee which will register your entire company for TMES use on every machine for one low price. The registration fee for corporations, businesses, schools, universities, hospitals, and all Local, State, and Federal Governmental institutions is only $50. Fill out the registration file after you print it, then send it with your company's check for $50 to make it legal. I will send you the latest version and a printed, and signed license so you can show the software auditors and lawyers at your business site. You cannot use TMES at work without registering it. Oh, I know you are ABLE, it's just not LEGAL since it's copyrighted material and I'm explaining the copyright to you now. A site license enables you to use TMES on any and all computers that you want to use it on - at your business address on the check or business envelope. That makes it easy for you and easy for me. I will keep on file the name of the individual at the company which will be given support by CIS, or by US mail (letters). I cannot provide phone support because I have an "8 to 5" job myself. I will provide support to only ONE computer professional at your company. If your company likes to use PURCHASE ORDERS, you can send me one and I will send you everything except the signed agreement for the site license. When your Accounts Payable section sends me the check, I'll remit your license that makes it all legal. Fair enough? If you have special arrangements, write me and we'll figure it out. I'll be happy to work with you. TMES has been made as FREEWARE for your testing purposes as to its suitablilty, therefore you take all the responsibility for its use and I will not be held liable for its improper use. Make sure that TMES is useful to you and that you know how to use it on a computer. It is NOT a program for the beginner. Its highest use is among batch file programmers. You can supply the whole TMES package if you want to use it in a shareware package that you are selling to others. You can supply TMES in a commercial package that you are selling to others. You do NOT have to be a registered user to supply TMES in your own package, but you must supply the whole package (as a ZIP file) even if you have a separate copy of TMES.EXE for instant use in your batch file that you're selling or offering. That's a pretty liberal policy. You must include the whole TMES package which includes the following four, 4, files (ZIP them or ARJ them or LHA them): TMES.EXE (the main file to run) TMES.DOC (this DOCumentation, maybe with version # in it) TMES.REG (REGistration form for a Site license) TMESDEMO.EXE (Some TMES DEMO Batch files, self extracting) What is TMES? ~~~~~~~~~~~~~~ TMES was developed to set MASTER ENVIRONMENT VARIABLES to different values so that batch file programming can be more flexible and powerful to use. This is one that DOS forgot. TMES will give a lot of power that you need for use with BATCH files. With TMES, you can INPUT strings and use them in a BATCH file like in any other programming language, for instance. There are FORTY (40) functions for you to use. You can use any environment variable, called JJ for example, in your batch file by using "percents" around it, as %JJ%. Naturally, if your environment is not large enough, TMES will not work because there is no room to SET any variables to use. Normally, you will have enough room to SET a few Variables to use. If you want to use a lot of Environment Variables now that TMES makes it easy, then check out your DOS manual to see how to increase your Environment Space. I use 1000 bytes for instance. You probably will want a LOT, now that TMES exists. ***************************************************************** Try this right now before you read anymore. Use an editor or use COPY CON TRYTHIS.BAT to make this file. Then run it. Echo off TMES F /Free TMES D /Drv echo You have %F% bytes free on drive %D%: It should say this when you run the BATCH program: "You have 156433 bytes free on drive A:" (only if you have that many bytes free of course!) That's real Batch file programming, isn't it? Easy to use. ...and it's easier than writing and compiling a small "C" utility. ***************************************************************** WILL IT WORK with my DOS version? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Run the DEMO program named TMESDEM1.BAT supplied for you as one of the programs in the little "TMESDEMO.EXE" package. It will self-extract when you run it. The DEMOs are inside. You can then study how the DEMOs work and they should give you ideas on the power you have using TMES in BATCH files. TMES works in DOS versions through 6.0, and has been tested in a WINDOWS 3.1 environment, and the DOS box of OS/2v2 and also in a NETWARE 3.11 environment. It's written in Borland's C++ and Assembly, FYI. Assume here, just for a minute, that it's June 18th, 1992 at 11:45pm at night. With TMES you can, both, Name and Set environment variables to one of the following values: the Year, 92; and then the Month, 06; and the Day of the month, 18; then the Hour, like 23; and finally the Minute, like 45. But first, let's do something simple to understand. Try to run TMES by itself and you get a cheat sheet. Like this: A:\>TMES How do you use one of the switches? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Here's how you would set a Variable named, let's say, DD to be the System Date's Day of the month (now, pretend it's December 25th, 1992) TMES DD=/DOM If you type SET at the DOS prompt you will see that the variable called DD is now set to the number 25 (pretend it's Christmas, remember?) This is what you would see in DOS if you did a SET command: DD=25 If you referred to %DD% in a BATCH file, it would be worth the string value "25" - are you getting ideas? The "/DOM" switch told TMES to set DD = to that value 25. How do I use it to backup a file named NAMES.DBF daily? Create a batch file like this: I will call it: BU-DBF.BAT ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ========== Here's what's in it: TMES DD=/DOM : this sets DD to be the day of the month like 25 COPY C:\DBF\NAMES.DBF C:\DBF\NAMES%DD%.DBF : this just does a plain vanilla COPY "from" "to" Here's what happens: When you run your BAT file (ie the BU-DBF.BAT) it sets the variable DD to be the DATE (ie 25). That's the first line of the Batch file. The switch "/DOM" is special because it tells TMES to find the day of the month from the system date. (It was December 25th, remember?) Then it copies the NAMES.DBF file to be backed up to be a new file called NAMES25.DBF because the %DD% is really a "25" to DOS. Again, the NAMES%DD%.DBF becomes NAMES25.DBF ~~~~ ~~ IMPORTANT! This is a pretty neat way of saving SERIALIZED backups of files without having to name the things each time by 'hand'. One simple BATCH file "changes" each day for you when you run it. Each day that you run BU-DBF.BAT, you get a new file name. Tomorrow, you would get NAMES26.DBF, then on the next day, the 27th, you would get NAMES27.DBF, etc. The only limit is your imagination. TMES is powerful! Let's get Complicated... ~~~~~~~~~~~~~~~~~~~~~~~~ Here's using four more of the special switches in BU-DBF.BAT: Notice that the "=" mark is optional, thus TMES Y=/YEAR2 and TMES Y /YEAR2 mean absolutely the same thing. Use the equals mark if you want to use it for clarity and understanding. The equals mark is ignored anywhere on the command line. "Y" would be equal to "92" if it were the year 1992 in your system date. Again.... the equals mark is optional for you to use!!!!!!! So, these next examples do NOT have the equals mark. I'm lazy. TMES Y /YEAR2 TMES M /MONTH TMES D /DOM TMES H /HOUR :then COPY C:\DBF\NAMES.DBF C:\BAR\NA%Y%%M%%D%.%H% ~ ~ ~ ~ %Y% would be equal to the value 92 (ie it's 1992) %M% would be equal to 12 (ie it's December) %D% would be equal to 28 (the date, ie the 28th of December) and %H% would be equal to 23 (ie at 11pm) If it were December 28th 1992, at 11:33pm, then this is what you would get for the file name (11pm is 23 in military time): __ __ NA921228.23 ~~ ~~ __ __ 92 is the year, 12 is the month, 28 is the day, 23 is the hour. ~~ ~~ ARE THERE MORE SWITCHES? ~~~~~~~~~~~~~~~~~~~~~~~~ Yes, to see them simply type TMES without any command line parameters. Some of my favorites are /INPUTUP which allows a word (it's Capitalized for you) to be input and then immediately used in your batch file. Hooray! No more difficult ERROR CODES to remember or ASCII codes to translate. Here's how to use it to input a character and use it in your batch file. This batch file is called MY_MENU.BAT. Look at it, here. :start ECHO OFF CLS ECHO My MENU ECHO ~~ ~~~~ ECHO A - SpreadSheet ECHO B - DataBase ECHO C - Word Processing ECHO D - Communications ECHO X - eXit Menu ECHO ________________________ ECHO enter your choice : TMES ANS /inputUP : the above line gets an INPUT letter to use in the next lines if '%ANS%'=='' goto start : goto %ANS% goto start : :A cd\SprSheet 1233 goto start : :B cd\DB DeeBASE goto start : :C cd\WP51 WurdPreference goto start : :D cd\COMM prucom243 goto start : :ennd : this menu is just the beginning of TMES uses Notice how TMES allows easy to understand BATCH file to be written since those ErrorLevel Codes are cryptic and often difficult to remember. ANOTHER GOOD USE ~~~~~~~~~~~~~~~~ If you send a filespec to TMES, it will parse it and set each section of it to a separate VAR for you to use. You supply the "base" variable name, such as Z below. such as this long example: TMES Z /parse Z:\DBF\TEETEST.DBF Z:\DBF\TEETEST.DBF might be represented by %1 in a batch file like TMES Z /parse %1 TMES Produces four Master ENVIRONMENT Vars for use to use which are Z plus an added "D or P or N or E" as below. %ZD% %ZP% %ZN% %ZE% such that parsing "Z:\DBF\TEETEST.DBF" we get %ZD% is the DRIVE from the filespec, or equal to Z %ZP% is the PATH from the filespec, or equal to \DBF %ZN% is the NAME from the filespec, or equal to TEETEST %ZE% is the EXTENSION from the filespec, or equal to DBF Note that the "dot" between the filename and the extension gets lost on purpose. You can add it later - only if you want to use it. The colon of the drive is missing , too. This should be very valuable for those of you who write batch files to copy files, move files, etc. then you could use the parsed parts like this: COPY %1 f:\backup\%ZN%.%ZE% | this is the dot to add back between the original filename and extension %ZN% is TEETEST %ZE% is DBF so the above really means this, to DOS: COPY Z:\DBF\TEETEST.DBF F:\BACKUP\TEETEST.DBF It takes the filename and extension out of %1 and uses it in the destination path F:\BACKUP\TEETEST.DBF Some of the variables set will take the number of minutes in an hour and change the digits to a single letter so you can use it in a filename. Thus, the 60 minutes, 0,1,2,3,4...58, and 59, get converted to alphanumerics. They will be ASCII sortable, that is, the numbers before any alphabetical characters. You can erase several TMES or regular Master Envirnment Variables by issuing one command TMES DEL JJ DD xxx yyy Zz or TMES DEL ZD ZP ZN ZE ================================================================== Here are some more examples of how to use TMES properly. Use these as examples to get you started. using the function to get the environment size such as TMES JJ /esize or for Boolean Functions like /eq, /ne, etc. TMES VariableNAME function value resultINTOthisVAR such as TMES DSK /eq 362496 ISEQUL or for Math Functions like /add, /mod, etc TMES VariableNAME /function value such as TMES X /add 100 TMES DD /DOW or TMES DD 4 For purposes of illustration, pretend it's Christmas day during the year 1993 for these examples, 12/25/1993 Here's a chart of Switches you can use. The Switches are on the left of the chart and the explanation is on the right. ========== ================================================== /SWITCHES DESCRIPTION OF WHAT IT PRODUCES. EXAMPLE VALUE placed in the Environment from example ========== ================================================== /365 produces the day of the year, 1 to 366 if it's a leap year TMES DD /365 359 /DATE produces the /DATE as environment variable It's in "YearMonthDay" in case you must Sort later. TMES DD /date 931225 /DOW produces the day of the week (Sunday=0, Monday=1, Tuesday=2, etc.,... to Saturday=6) Thursday=4 here. TMES DWK /dow 4 /DOM produces the day of the month. Here, it's 25 TMES DMNTH /dom 25 /DEC DECrements the value of the environment variable DD by 1 TMES DD /dec 24 /DEL deletes variables all at once so you don't have to use the "DOS SET=" on many lines. Let TMES delete them all on one line for you - and all at one time. TMES /DEL DD JJ KKKK UU YAG /DRV finds the current drive and makes that equal to the Variable used. Here we're on drive C: (with no colon!) TMES KK /drv C /ESIZE shows the total environment size currently available. TMES DD /esize /ELEFT shows environment size left prior to this variable being set (as the variable DD below) TMES DD /elen /ELEN shows the amount of environment space used prior to this variable being set. See above. /FREE assigns the free space (in bytes) on the disk in the current drive. (There's 555K on this one.) Then use the boolean switch to check the value. TMES FF /free 555308 /INC INCrements the variable used. For instance, the variable named DD was 24, then we perform the /inc switch and it increments the 24 to 25 for you. It adds +1. TMES DD /inc 25 (See also, /dec, for a contrasting function which decrements or decreases a value by 1.) /INPUT allows input (up to 128 characters) from the keyboard and makes the Environment assignment without Uppercasing anything. Spaces ARE allowed. See /INPUT below, also. TMES X /input whatever you type will NOT be changed to UpperCase. /INPUTUP allows input (same as above) except the string typed in is UPPERCASED so you don't have to check but for ONE CASE in your batch file. Spaces ARE allowed so be careful. /MONTH the month number becomes a variable. December = 12. TMES M /month 12 /PARSE FILESPEC This /switch is different. It takes two parts: i.e., (1)-the switch AND (2)-the filespec that follows the switch. It takes the FILESPEC you give it and parses it and returns the pieces as this: (notice that * represents the variable like the "X" in the example below) *D = drive (no colon) *P = path (no trailing slash) *N = filename *E = extension where "*" is the variable you give it, such as X in this example of using C:\ACCTG\MYNAMES.DBF Take a look how this one is done for you..... TMES X /parse C:\ACCTG\MYNAMES.DBF which makes these four variables for you to use: equivalence what it means ======================= ========================= XD = C (XD is the Drive) XP = \ACCTG (XP is the Path) XN = MYNAMES (XN is the Filename) XE = DBF (XE is the Extension) notice that the dot, (the period,) which was between the filename and the extension is now LOST. You can add it later in your batch file if you need to. Also, the colon with the drive is stripped for your use. It's easy enough to add it back if you need to. /RAND the hundreths portion of the system clock's seconds. These numbers run from 00 to 99. TMES C /rand This is NOT really a random number generator but since you can't predict when you press a key within any one second, it's pretty good and easy. The next set of functions deals with Boolean Functions They all begin with the slash like /eq for instance. Syntax: TMES existingVAR /booleanFunc Value resultVAR IMPORTANT!! existingVAR is a variable as seen in the Environment existingVAR is not surrounded by %'s; hardly ever! IMPORTANT!! The Value is an actual NUMBER, not a variable IMPORTANT!! The resultVAR is a variable which will be created and will contain a 0 or a 1, 1=true, 0=false example: TMES DD /eq 4 JJ which means: if DD = 4 then JJ is set to 1, else JJ is set to 0 example: TMES CLASSSIZE /LE 30 TRUEFALSE which means: if Classsize <= 30 then TRUEFALSE = 1 else TRUEFALSE = 0 You need to be able to check whether a variable in the environment is greater than, less than, or equal to a value. /LT If the existingVAR is less than the Value, the resultVAR is set to 1 else the resultVAR is set to 0 /GT If the existingVAR is greater than the Value, the resultVAR is set to 1 else the resultVAR is set to 0 /LE If the existingVAR is less than or equal to the Value, the resultVAR is set to 1 else the resultVAR is set to 0 /GE If the existingVAR is greater than or equal to the Value, the resultVAR is set to 1 else the resultVAR is set to 0 /EQ If the existingVAR is equal to the Value, the resultVAR is set to 1 else the resultVAR is set to 0 /NE If the existingVAR is not equal to the Value, the resultVAR is set to 1 else the resultVAR is set to 0 The next set of functions do integer math on a variable and place the results into the SAME VARIABLE. That way you can even have counters, totals, etc. They all begin with the slash, also. If you expect to use the original value AFTER you perform math on it, you MUST save it BEFORE you change its value! Syntax: TMES var /mathfunc value ~~~ ~~~~~ IMPORTANT!! var is the VARiable as seen in the Environment. ~~~ IMPORTANT!! It does NOT take %'s around it, like %var%, hardly ever! IMPORTANT!! The Value must be a number that you are comparing to such as 256 or 360000 or %NUM%, etc. example: TMES DD /add 5 which means: add 5 to the variable DD. if DD does not exist, then DD=5 (ie, DD = 0 + 5) /ADD Adds value to var. example (if NUM were set to 77 already) TMES NUM /add 11 results in NUM having a value of 77+11 or 88 afterwards /DIV Divides var by value. Result is an integer. Look! Here's some integer math 21/2 = 10 22/2 = 11 55/2 = 27 example (if MM had a value of 33) TMES MM /div 2 results in MM having a value of 16 afterwards. /MOD Yields the Remainder after dividing var by a value. Here's some modulo math: 21 mod 2 = 1 21 mod 3 = 0 21 mod 6 = 3 21 mod 8 = 5 example (if UU had a value of 10) TMES UU /mod 3 results in UU having a value of 1 afterwards (save the value beforehand if you need it later) /MUL Multiplies var by value. If WW had a value of 56 then TMES WW /mul 3 results in WW having a value of 168 afterwards /SUB Subtracts value from var. If PPP had a value of 50 then TMES PPP /sub 6 results in PPP having a value of 44 afterwards The next set of functions deal with TIME and DATE of the PC. Assume in this example, that it's 1:44pm in the afternoon, which is 13:44 in MILITARY TIME. Actaully it's 56 seconds after 1:44pm and it's almost 57 seconds after 1:44pm (ie actually 56.88 seconds, which is pretty close to 57.) /TIME assigns the military time 13:44 to a variable TMES Q /time 1344 /THOUR assigns the hour of the time, the 1pm part (13:) TMES Z /thour 13 if you need AM and PM, check to see if value is /GT 12 and if it is then subtract 12, so that a value like 13 would yield 1 for 1PM. /TMIN assigns the minute of the time, the 44 part TMES P /tmin 44 /TSEC assigns the seconds of the time, the 56 part TMES U /tsec 56 /THUN assigns the 100ths of the second of the time, the .88 TMES W /thun 88 It must be noted here that "/tHUN" COULD be used as a "poor man's" random number generator if you needed numbers from 00 to 99 since it is unlikely you could press a key precisely enough using the keyboard to stop the PC's internal timer on the same "hundreth" of a second at any particular time of day. /YEAR2 assigns the year as a two digit year. as in 1993 TMES R /year2 93 /YEAR4 assigns the year as a four digit year, as in 1993 TMES N /year4 1993 These next set of functions also deal with TIME and DATE but they return the value in a single character suitable for including in a filename (ie correct sorting order via ASCII codes). /D converts the day of the month (ie 1 to 31) to a single character. Mainly used in naming source files so versions can be kept day to day. /M converts the month of the year (ie 1 to 12) to a single character. Mainly used in naming source files so versions can be kept day to day. /TH converts the hour of the day (ie 0 to 23) to a single character. See reasons above. /TM converts the minutes of the hour (ie 0 to 59) to a single character. This value of 0 to 59 is divided by 2 and then made into an integer. The results will be in the range of 0 to 29 which means it's only accurate to save source files using this trick every two minutes of the day. But then again, how many source files are made that close together? /TS converts the seconds of the time as above (0 to 59 are changed into 0 to 29) The same reasons are appropriate as the above reasons for /tm The CODES are sorted in ASCII fashion so that sorts will be made correctly if used in filenames. The problem is evident when you think of 60 minutes in an hour and when the number 24 is needed (because it's 3:24pm, or so.) The minutes portion of the number is first divided by 2 and then made into an integer so that 12 is obtained. Incidentally, the time 3:25pm (ie 25) will return the same value - which means that minutes of the hour are accurate to ONLY the lowest integer value that can be obtained. A "59" yields "29", etc. Hopefully, you won't have backups or sources that close in time to each other. If you do, then don't use this Coded Value Function, use the real minutes as above (ie /min). If the number of minutes was 12, then TMES uses the 12th character which is "B" in this string of 31 values: Thirty-one, 31, is the maximum number to be coded by TMES. 0123456789ABCDEFGHIJKLMNOPQRSTU * | * *| 1 10 | 20 30| there are 31 values here 12 31 Stars are located at the 10's places just in this illustration. The 12th position is a "B", while the 31st position is the "U". If you are a programmer, having "A" for the eleventh item seems wrong because "A" in HEX is decimal "10," not "11" - However, the zero must reside as the first character to take care of "0" values. These numbers are in ASCII order so that they can be used in file names and they will "stay Sorted" for you. For the days in a month like the 24th of July, the actual 24th character will be used, which is "N" Only with SECONDS and MINUTES will be number value will be divided by 2 so that a number less than 30 can be obtained. Thus, 0/2 = 0. And 1/2 = 0. While 2/2 = 1, etc. etc. If you have other needs or ideas for TMES to try, send them in and wait for the next version. Thanks for trying TMES. I hope you like it enough to use it in your office at work. TMES is FREEWARE for individual use. Registration is required ONLY for institutions and businesses, not home use. Thanks. Do you need something that TMES needs to do? Have Ideas? Great! Send them to me and I will include the good ones in the next version. Send a SASE if you want a response from me. The Latest, Unregistered Upgrades are always available to anybody unregistered (ie the vast masses) for the cost of $10, which covers the postage for mailing and a diskette and my lunch - currently only $10 - send a check or Money Order. No cash will be accepted. It tends to get "lost" in the mail. You will get a 3.5" disk if you don't specify differently. I'l also include some other programs of mine on it for you. ***************************************************************** Registered owners will be NOTIFIED BY MAIL EACH TIME a new version is developed, even if it's a minor version. You can THEN order the new version for a fraction of the cost. ****** IMPORTANT ****** Registered Owners get the latest version, always NEWER than any version which is released via the FREEWARE and SHAREWARE route, ie BBS, Mail order, Compuserve, etc., etc. The Registered Version will not ever be allowed to be Shareware and it will never be put on a BBS legally. Please do not do so. If you have "stumbled across" the Registered Version, please do not continue to use it against my copyright. Thanks. ***************************************************************** TMES is FREEWARE, which means that no registration is necessary for an individual's use at home... ...but, (and a big-g-g but) TMES is SHAREWARE with a registration fee REQUIRED for use in an institution or business. The Current Fee is $50, payable by check, money order, or by purchase order. Registered owners always get a newer, Registered version, different from the Shareware version. Individuals using TMES at home for personal use MAY register also just to get the newer version sent to them, but there is NO requirement to do so. You will receive the same special attention that corporations receive when you register. But, it's not necessary. But IF YOU DO, THANK YOU and ENJOY TMES. Thanks for just trying TMES even if you don't use it at work. Send Praise, Problems, Purchase Orders, Checks, and Ideas to: Tee Roper 215 Devin Dr Garner, NC 27529 ---------------------------- eof ----------------------------