FUGUE UTILITIES #2 ================== The files included on this disk are mostly helpful utilities for use in batch files. The programs included are: BATCH UTILITIES =============== ACCEPT.COM ASK.COM BEEP.COM EDITENV.EXE EXCLUDE.COM RENAMED.COM SYSDATE.COM XQT.EXE YESNO.EXE OTHER UTILITIES =============== DOSH.COM ED.EXE REGISTRATION ============ If you find these programs useful, you are encouraged to send $25 to David Noakes P.O. BOX 942, WODEN ACT 2606, AUSTRALIA This helps me to continue to develop other programs. Feel free to give the programs away to friends, provided you also give them a copy of this READ.ME file. If you have any suggestions as to how these or other programs could be improved, write to me. If you are a registered user, then I will be happy to hear from you. DESCRIPTION =========== ACCEPT This program accepts information from the keyboard, terminated by a Carriage Return. It does not prompt, it is assumed that the batch file prompts by means of echo statements. It takes a string as a parameter, and appends the accepted information to the end of the string. This string is then displayed through the standard output device, allowing redirection to be used. eg: ECHO A - Accounts ECHO B - Basic ECHO C - Turbo C ECHO ECHO Enter the letter of your choice, followed by CR ACCEPT zz>zcmd.bat ZCMD or ECHO Enter date to back up files from (MMDDYY) ACCEPT BKUP > ZCMD.BAT ZCMD ASK This program is used for a similar purpose to ACCEPT, but it displays the string parameter as a prompt. It accepts only one character in reply, without the need to enter CR. Thus it is more suited to building a menu system from batchg files and prompts. It sets the batch file variable ERRORLEVEL to the numeric value represented by the ASCII code of the letter entered. eg: ECHO A - Accounts ECHO B - Basic ECHO C - Turbo C ECHO ASK Enter the letter of your choice (A,B,C) IF ERRORLEVEL 51 ACCOUNTS IF ERRORLEVEL 50 BASIC IF ERRORLEVEL 49 TC BEEP This program emits a half second beep through your computer's speaker. Useful for alerting you when a long job has finished eg: ARC U C-SOURCE *.C *.H *.OBJ *.EXE BEEP EDITENV There are times when you wish to set an environment variable from a batch file. The SET statement is not always useful for this purpose. Programs can interrogate the environment, but can only set values in their own copy of the environment. This program sets values in the master copy of the environment that all other copies are made from. If you are running batch files from a memory resident shell, you will probably find that you should exit the shell, since its environment may not be altered, but its parent will. Editenv will not only set variables to values, it will also replace substrings with new substrings, or delete substrings. The syntax is EDITENV [] /S for substitute /D for delete special search patterns ^ is start of string $ is end of string eg: set the variable PATH EDITENV PATH c:\dos;c:\lotus;c:\turbo-c;c:\;c:\wordstar; will result in path taking the value c:\dos;c:\lotus;c:\turbo-c;c:\;c:\wordstar; eg: to substitute a value assume path has the value c:\dos;c:\lotus;c:\turbo-c;c:\;c:\wordstar; to add a new value eg c:\pascal EDITENV PATH $ C:\PASCAL; /S will result in path taking the value c:\dos;c:\lotus;c:\turbo-c;c:\;c:\wordstar;C:\PASCAL; EDITENV PATH ^ C:\PASCAL; /S will result in path taking the value C:\PASCAL;c:\dos;c:\lotus;c:\turbo-c;c:\;c:\wordstar; EDITENV PATH c:\; C:\PASCAL; /S will result in path taking the value c:\dos;c:\lotus;c:\turbo-c;C:\PASCAL;c:\wordstar; eg: to delete an existing value EDITENV PATH c:\wordstar /D will result in path taking the value c:\dos;c:\lotus;c:\turbo-c;C:\PASCAL; EXCLUDE This program is used to exclude a list of files from any command. It does this by setting the hidden bit on the list of files, running the command, and then resetting the hidden bit. syntax: EXCLUDE eg EXCLUDE *.tpu dir *.* will result in a directory of all files except those with the extension TPU eg EXCLUDE HEL??.* ARC U P-SOURCES *.PAS *.ASM will hide say HELP1.PAS, and archive all other files with the extension PAS RENAMED This program is used to change the name of a directory. This saves having to move files out of a directory, deleting it and setting up again under the new name. syntax: RENAME [d:] eg: RENAMED C:\PASDIR PASCAL SYSDATE This program is useful for those people who dont have a battery backed clock. The program should be included in your autoexec file, and will remember the last date that you booted. It will allow you to use the arrow keys to change the date displayed. XQT Normally you cannot nest runs of batch files within other batch files - call the new batch file, and the old one terminates. XQT handles all of this - it takes the batch file name as a parameter, followed by any parameters to the batch file. It runs the batch file, and passes the parameters to it. It does require COMMAND.COM to achieve this. syntax XQT [d:] [...] eg XQT b:zcmd parameter another third will run the batch file b:zcmd.bat, and pass the parameters paremeter another third to it. YESNO This program is similar to ASK, except that it accepts only the letters Y,y,N or n. It displays a prompt, and waits till the user enters either Y or N. It sets the batch file variable ERRORLEVEL to 1 for Y or y, and sets it to 0 for N or n. syntax YESNO eg: YESNO Do you wish to backup the files if ERRORLEVEL 1 XQT BU ACCOUNTS where BU.BAT is a file that takes a parameter to tell it which files to backup. OTHER UTILITIES =============== DOSH ==== This comes under the category of yet another memory resident DOS handler (hence the name DOSH). Dosh keeps a circular queue of commands, and makes them available via the arrow commands. Up arrow for previous command(s), Down arrow for the commands from the other end of the queue. You can edit these commands using common editing commands: Home - start of command End - end of command INS - toggle insert mode Left Arrow - move cursor left Right Arrow - move cursor right Ctrl Home - delete from cursor to start of string Ctrl End - delete from cursor to end of string DEL - delete the character under the cursor, and shift characters left <= - Backspace delete the character to the left of the cursor, and shift characters left Ctrl Left Arrow - move cursor to the next word to the left Ctrl right Arrow - move cursor to the next word to the right With this implementation, the 10 or 12 function keys on most machines have their own functions. F1 change foreground color forward F2 change background color forward F3 utilise the editor ED (share ware available from me) F4 Browse F5 utilise the dos shell SR - share ware F6 copy F7 exclude - shareware available from me F8 arc - another shareware program F9 dir F10 CLS - this will handle EGA 43 line mode, and will set screen color to the default stored in DOSH F11 Backup - only if your DOS handles these keys F12 Restore " " " " " " " Shift F1 - change foreground color backwards Shift F2 - change background color backwards Function keys F3 to F12 are stored as pascal type strings (max length 32 characters, first character is string length). These can be hacked by any enterprising person to reflect new values - use Norton Utilities or Debug, and Work from a COPY! If the string ends in a carriage return, it will be sent to Dos, otherwise it will appear on the screen for editing. The Dosh functions are available to all programs that use the Dos get input function (interupt 21h function 0Ah) to obtain input. It is memory resident, but does not interfere with programs such as Sidekick and Smartkey etc. ED == This is a simple editor with WordStar like commands. It edits files in ascii. The largest file is limited to 64K, and one window. If you prefer a more complex editor with multi windows, word processing functions and so on send me $30 for a copy of FRED (Friendly Editor) V3.01 Function Keys ============= F1 - Help F2 - Save - ^K^S F3 - Done - ^K^D WORDSTAR PC CURSOR MOVEMENTS: COMMAND KEY Character left Ctrl-S <- Character right Ctrl-D -> Word left Ctrl-A Ctrl <- Word right Ctrl-F Ctrl -> Line up Ctrl-E Up arrow Line down Ctrl-X Down Arrow Scroll up Ctrl-W Scroll down Ctrl-Z Page up Ctrl-R PgUp Page down Ctrl-C PgDn To left on line Ctrl-Q-S Home To right on line Ctrl-Q-D End To top of file Ctrl-Q-R Ctrl Pg Up To end of file Ctrl-Q-C Ctrl Pg Dn To beginning of block Ctrl-Q-B To end of block Ctrl-Q-K INSERT & DELETE COMMAND KEY Insert mode on/off Ctrl-V Ins Insert line Ctrl-N Delete line Ctrl-Y Delete to end of line Ctrl-Q-Y Delete right word Ctrl-T Delete char under cursor Ctrl-G Del Delete left character Ctrl-H <= BLOCK COMMANDS COMMAND KEY Mark block begin Ctrl-K-B Mark block end Ctrl-K-K Hide/display block Ctrl-K-H Copy block Ctrl-K-C Move block Ctrl-K-V Delete block Ctrl-K-Y Read block from disk Ctrl-K-R Write block to disk Ctrl-K-W Save File Ctrl-K-S MISC. COMMANDS COMMAND KEY Save & Exit Ctrl-K-D F3 Tab Ctrl-I |-> Repeat last find Ctrl-L Control character prefix Ctrl-P Find Ctrl-Q-F Find & replace Ctrl-Q-A Set marker 0 .. 3 Ctrl-K 0 .. 3 Go To marker 0 .. 3 Ctrl Q 0 .. 3 Toggle Auto indent mode Ctrl Q I Toggle fixed tabs Ctrl O T Restore Line Ctrl Q L Print Block Ctrk K P Search and Replace Options B Search and replace backwards, i.e. search and replace from the current cursor position towards the beginning of the text. G Global search and replace, i.e. search and replace in the entire text, irrespective of the current cursor position. n n = any number. Find and replace n occurrences of the search string, counted from the current cursor position. N Replace without asking, i.e. do not stop and ask Replace (Y/N) for each occurrence of the search string. U Ignore upper/lower case, i.e. regard upper and lower case alphabeticals as equal. W Search and replace whole words only, i.e. skip matching patterns which are embedded in other words. L Search and replace local to marked block only Examples N10 Find the next ten occurrences of the search string and replace without asking. GWU Find and replace whole words in the entire text. Ignore upper/lower case. W Search for whole words only, i.e. the search string 'term' will only match the word 'term', not the word 'terminal'. BU Search backwards and ignore upper/lower case, i.e. 'Block' will match both 'blockhead' and 'BLOCKADE', etc. Terminate the list of options with <_| (CR), and the search and replace starts. If the search string is found, the cursor is positioned at the end of it, and you must response to the question: Replace (Y/N)?. You may abort the search and replace ope- ration at this point with the Abort command (Ctrl- U). The search and replace operation may be re- peated by the Repeat last find command (Ctrl-L). A global search and replace with the N-option specified (Replace without asking) normally shows each replacement on the screen. This is suspended if you press any key, resulting in a faster opera- tion. Enjoy! David Noakes P.O. BOX 942, WODEN ACT 2606, AUSTRALIA