-= The Ultimate Batch Util 6.0 =-
Over 250 functions, including compression,
graphics, sounds, video, detection,
keyboard, files, archive listing, system
manipulation, plus hundreds more.
This thing blows away ALL OTHER BATCH
file utils!

TOOLBOX 6.0
(c) 1993



Over 200 Functions to assist you in
batch files, or just everyday use
















ULT or ULT /? FOR HELP SCREEN

If you need a help screen, type ULT or ULT /? and the following
help screen appears:







TOOLBOX 6.0
(c) 1993



/25 Set 25 Line EGA /CLEANUP Cleanup appl /ENVU Used environment
/43 Set 43 Line EGA /CODE Show scan code /ERRLOCK Fake disk error
/AMPM Is it AM or PM? /COLD Cold Boot System /EXISTD Dir exist?
/ANS Is Ansi loaded? /COMP Compress File /EXISTF File exist?
/APPEND Is APPEND? /CURS+ Turn cursor on /FILDAY File's day
/ARCH Attribute Arch /CURS- Turn cursor off /FILL Screen w/ char/clr
/ASSIGN Is ASSIGN? /DAYSTAT Stats on a day /FILMON File's month
/BIOS Bios version /DESQ Desqview installed? /FILYER File's year
/BLOCK Block cursor /DIAL Autodialer /FKEY Funct key assign
/BORDER Change border /DOSVER Major DOS version /FLOP Number floppies
/BOX Write box /DRIVE Get current drive /FREE Space on drive
/BREAK Is BREAK on? /EMS Ems driver exist? /GAME Port available?
/C+ Capslock on /ENVF Free environment /GETKEY Get a key
/C- Capslock off /ENVG Environment graph /GETMODE What video mode?
/CHKSUM Checksum file /ENVT Total env. space

/HEX Convert to binary /N+ Numlock on /PUTS Write to screen
/HIDDEN Change attr Hidden /N- Numlock off /RDONLY Attr Rd Only
/INWIN Windows installed? /NOBUF Clear key buffer /REN Rename dir
/KB Keyboard data /NOWDAY Current day /REST Restore screen
/NOWHOUR Current hour /S0 Star Wars sound
/KIL Totally Del File /NOWMON Current month /S1 Arcade sound
/LEVEL Set errorlevel /NOWYER Current year /S2 DeadBird sound
/LOCK Lock up computer /NUMBAS Convert #s /S3 Echo sound
/LOOP Repeat program /OFFMOUSE Disable mouse /S4 Fire sound
/MAP Map disk /PAGE Set video page /S5 High pitch sound
/MATH Math Coprocessor? /PATH Locate file on path /S6 Siren effect
/MAX Max keyboard rate /PRINT PRINT.COM installed? /S7 Bomb sound
/MONTH Show calendar /PRNF Form feed to PRN /S8 Phone ring
/MOUSE Ms. drvr installed? /PRNL Line feed to PRN /S9 Pulse sound
/MULT Run many commands /PRSCR Print screen /SAVE Save screen

/SCRD Scroll screen down /TIME Interval timer
/SCRU Scroll screen up /TODAY Show today's files
/SEARCH Srch for text /UNCOMP Uncompress File
/SETD Set file date /VEREMS EMS version?
/SHAKE Shake screen /VERIFY Is VERIFY used?
/SHARE Is SHARE used? /VIEW Read text file
/SOUND Make noise with delay and tones /VOL Create volume name
/SSCUR Cur scan lines
/STOP Delay /WARM Warm Boot System
/SYS Change atr System /WEEKDAY Day of the week?
/TD Show date/time /WND Wind Chill

Registration for ULTRA ToolBox is $10.00, or get
the entire set of Dave Utils for only twenty dollars.
That's over 3 megabytes of VGA graphic effects,
file finding, PATH control, sound fx, martial arts,
batch file enhancements, plus dozens more!

To order, send $20.00 to:
David Smith
1104 Mason Dr
Hurst TX 76053










The ULTRA ToolBox has an easy command line usage. The initial
option is one of the many contained below.
For example, ULT /TD

The remainder of the options depend on the initial one. The
option /TD needs no other information, however, the option
/COMPRESS requires a filename after it. See the option
information below for individual details.


Usage:

ULT [option] [option] [option] ...


I have completely re-written this .DOC file and optimized ULT.EXE
for speed. It has grown so much that I had to split it into two
separate files:
ULT.EXE main batch utils
ULTENV.EXE environment utils

ULT.EXE consists of 112 functions that detect hardware, create
graphics, boxes, plus hundreds more. When it detects something,
it sets the DOS errorlevel upon exit.
ULTENV.EXE has 138 functions that get a filespec, pick a file
from a menu, etc. Many of these functions set the ULT environmental
variable upon exit. That means that when you use ULTENV, you mostly
affect the environmental ULT rather than the errorlevel.

The options are now alphabetized:









======= Options: ===========================================================



/43 SET LINES TO 43 EGA MODE

Sets the current screen to 43 line EGA mode.
NOTE: You must have EGA or above to enable this.
To return the screen to normal, use /25

EX: ULT /43


/25 SET LINES TO 25 TEXT MODE

Sets the current screen to 25 line EGA mode.
NOTE: You must have EGA or above to enable this.
To return the screen to high intensity, use /43

EX: ULT /25



/AMPM IS IT BEFORE OR AFTER NOON?

Returns 1 or 2, dependent upon if the current time is before
or after twelve noon.

RETURNS: 1 Current time is before twelve noon
2 Current time is after twelve noon

EX: ULT /AMPM



/ANS IS ANSI.SYS CURRENTLY LOADED?

Shows if ANSI.SYS is currently loaded in memory.

RETURNS: 1 Ansi.sys loaded
0 no ansi driver found

EX: ULT /ANS



/APPEND IS APPEND CURRENTLY LOADED?

Shows if APPEND is currently loaded in memory.

RETURNS: 1 Append.com loaded
0 no Append.com driver found

EX: ULT /APPEND



/ARCH TURN ON ARCHIVE ATTRIBUTE

Turns on the archive attribute of a file. If you are unsure of
attribute meanings, consult your DOS manual.

EX: ULT /ARCH file
ULT /ARCH list.com



/ASSIGN IS ASSIGN CURRENTLY LOADED?

Shows if ASSIGN is currently loaded in memory.

RETURNS: 1 Assign.com loaded
0 no Assign.com driver found

EX: ULT /ASSIGN



/BIOS SHOWS VERSION OF ROM BIOS

Displays version of ROM BIOS.

EX: ULT /BIOS



/BLOCK MAKE A BLOCK CURSOR

Makes the cursor a block cursor. This is great for laptop users
who cannot see their cursor, or anyone else who wants a block
cursor instead of the normal one. You can set the cursor back
to normal using the /SSCUR, or /CURS+ options.

EX: ULT /BLOCK



/BORDER CHANGE THE BORDER COLOR

This changes the color of your screen's border.

USAGE: ULT /BORDER color

whereas color = 0 BLACK
1 BLUE
2 GREEN
3 CYAN
4 RED
5 MAGENTA
6 BROWN
7 LTGRAY
8 DKGRAY
9 LTBLUE
10 LTGREEN
11 LTCYAN
12 LTRED
13 LTMAGENTA
14 YELLOW
15 WHITE

EX: ULT /BORDER 5
ULT /BORDER 12



/BOX PUT A BOX ON THE SCREEN

Places a box on screen using the following arguments:

1) starting column
2) starting row
3) ending column
4) ending row
5) border attribute
6) box attribute
7) Title (optional)

EX: ULT /BOX 10 10 20 20 15 05 " My main menu "

Places a small, black box with shading and a white border
on the screen. This combined with /PUTS can create boxed
and bordered text in batch files.
To determine the colors of /BOX and /PUTS, see the section
called HOW TO MAKE CUTE LITTLE BOXES! below.



/BREAK IS BREAK CHECKING CURRENTLY ON?

Shows if BREAK checking is currently on. This is usually altered
by typing "BREAK ON" or "BREAK OFF" on the command line.

RETURNS: 1 Break checking on
0 Break checking off

EX: ULT /BREAK



/C+ TURN ON CAPSLOCK

Turns on Capslock. This is equivalent to pressing the CAPSLOCK
key on the keyboard.

EX: ULT /C+



/C- TURN OFF CAPSLOCK

Turns off Capslock. This is equivalent to pressing the CAPSLOCK
key on the keyboard.

EX: ULT /C-



/CHKSUM SHOW CHECKSUM OF A FILE

A CheckSum is merely all of the bytes in a file added together.
It is useful to determine if a file is an EXACT REPLICA of another
file, or to virus check a program.
If a file has been altered in ANY WAY, the checksum will be
different.

EX: ULT /CHKSUM list.com
ULT /CHKSUM q.exe



/CLEANUP CLEAN UP APPLICATION

ULT normally leaves many things undone when it closes. A window
may remain open (consuming memory), text colors may change, the
border may be a different color, or the cursor may be invisible.
/CLEANUP fixes these things by:

a) Closing all open files
b) Closing all windows
c) Clearing the screen
d) Setting border to black
e) Setting the video PAGE to zero
f) Returning to 25 line text mode
g) Setting cursor to underscore



/CODE SHOW KEYBOARD CODES

This displays the keycode, scancode, and ASCII codes for
any key pressed. The prompt: 'PRESS ANY KEY:' is shown,
then once one is pressed, the information is given.

ULT /CODE presents: "Press Any Key:"
and pressing "g" gives:

keycode=0x2267 scancode=34 ASCII code=103



/COLD COLD BOOT SYSTEM

This reboots and resets the computer (a memory check is done
also).

EX: ULT /COLD



/COMP COMPRESS

Compress a file using LZW method. This replaces the file
with the newly compressed file, without renaming it.
This is useful for modem communications where you want to
transmit a secret file, or you want to compress a file
and NOT use the popular compression programs. It will
be impossible to read a text file that has been compressed
using this, or uncompress it unless you have this util.

EX: ULT /COMP myfile
ULT /COMP secret.txt



/CURS+ TURN ON CURSOR

Restores cursor to its original state. This is useful if a program
has turned off your cursor, or you have temporarily used
ULT /CURS- to manually turn off the cursor.

EX: ULT /CURS+



/CURS- TURN OFF CURSOR

Turns off the cursor. It can be easily restored using the
ULT /CURS+ option.

EX: ULT /CURS-



/DAYSTAT STATISTICS ON ANY GIVEN DAY

This tells what day a given date falls on and which week in the
year it is.

EX: ULT /DAYSTAT 4 18 1993 (tells stats on April 18, 1993)
ULT /DATSTAT 9 14 1922 (tells stats on September 14, 1922)



/DESQ IS DESQVIEW INSTALLED?

Returns the results of a DESQVIEW test.

RETURNS: 0 Desqview is NOT installed
1 Desqview is installed

EX: ULT /DESQ



/DIAL DIAL THE PHONE

This is absolutely the greatest thing you will ever see!

I use this constantly, everyday to dial friends up. My modem
is hooked into the phone line, and I must manually reach for
the phone everytime I want to talk with someone.

This solves this by dialing a phone number, then prompting you
to press a key to release the computer from the phone. That way,
you can just press the space bar when someone answers.

It is best to create a batch file with different people's phone
numbers in it. IE: FRED.BAT would include the following command:

ULT /DIAL 1 555-4353 (this dials the number 555-4353 on COM 1)

From any place on my computer, I can just type: FRED to dial up
my friend Fred, then press a key when he answers, and pick up the
phone to talk with him.

As a default, /DIAL uses tone dialing, however, if you have a pulse
phone, include /P after the phone number.

EX: ULT /DIAL 1 555-1836 /P (dials 555-1836 on COM 1, using pulse)
ULT /DIAL 3 555-9023 (dials 555-9023 on COM 3, using tone)



/DOSVER WHICH DOS VERSION?

Returns the major DOS version number.

RETURNS: Major DOS version number (3, 4, 5, etc...)

EX: ULT /DOSVER



/DRIVE NUMBER OF CURRENT DRIVE?

Returns the number of the current drive
IE: A: is 1
B: is 2
C: is 3
etc...

RETURNS: Number of the current drive found

EX: ULT /DRIVE



/EMS IS EMS DRIVER PRESENT?

Determines if an EMS driver is present.

RETURNS: 0 EMS driver exists
1 none found

EX: ULT /EMS



/ENVF SHOW FREE ENVIRONMENT

Shows free environment space.

EX: ULT /ENVF



/ENVG ENVIRONMENT GRAPH

Show a graph of current environment. This shows active environment
beginnings, and used/total/free bytes.

EX: ULT /ENG



/ENVT SHOW TOTAL ENVIRONMENT

Shows total environment space.

EX: ULT /ENVT



/ENVU SHOW USED ENVIRONMENT

Shows used environment space.

EX: ULT /ENVU



/ERRLOCK SIMULATE A HARD DISK ERROR

Prints "Hard disk error" on the screen, beeps, then locks
the computer. Requires a warm or cold boot.

RETURNS: nothing


EX: ULT /ERRLOCK



/EXISTD DOES DIRECTORY EXIST?

This determines if a directory exists on the current or
any other drive.

RETURNS: 0 Directory exists
1 No such directory found

EX: ULT /EXISTD \utils
ULT /EXISTD c:\wp51\data



/EXISTF DOES A FILE EXIST?

This determines if a file exists. Wildcards are NOT accepted.
NOTE: If you only want to know if a file can be started, use
/PATH instead. This will tell you if a file is on the path,
and can be started from the command line without changing
directories.

RETURNS: 0 File exists
1 No such file found

EX: ULT /EXISTF list.com
ULT /EXISTF \wp51\wp.exe



/FILDAY DAY OF FILE?

Returns the day of a file. Extracts the file's date, then
sets the errorlevel to the file's day.

RETURNS: Day of the file's month (1 - 31)


EX: ULT /FILDAY myfile.txt
ULT /FILDAY list.com



/FILL FILL THE SCREEN WITH CHAR/COLOR

This fills the screen with any character you choose, and any
color.

USAGE: ULT /FILL character color

Character can be any of the 255 ASCII chars, and color can be
any valid color.

EX: ULT /FILL 49 80 (fills screen with colored ones)
ULT /FILL 30 44 (fills screen with green/red triangles)



/FILMON MONTH OF A FILE?

Returns the month of a file. Extracts the file's date, then
sets the errorlevel to the file's month.

RETURNS: Month of the file (1 - 12)


EX: ULT /FILMON myfile.txt
ULT /FILMON list.com




/FILYER YEAR OF A FILE?

Returns the year of a file. Extracts the file's date, then
sets the errorlevel to the file's year.

RETURNS: Year of the file (last two digits)


EX: ULT /FILYER myfile.txt
ULT /FILYER list.com



/FKEY ASSIGN COMMANDS TO FUNCTION KEYS

On the command line, you usually have no use of your function keys.
This is a shame, considering pressing F5 could give me a DIR /W,
or pressing F8 could activate LIST.COM.
This would greatly save typing!

To assign a function key, use the following format:

ULT /FKEY keynumber command

Again, please remember if your command includes spaces, enclose
the command in quotes.

EX: ULT /FKEY 3 "DIR /W" (makes a dir /w when the F3 key is pressed)
ULT /FKEY 8 LIST.COM (activates LIST.COM when the F8 key is pressed)



/FLOP NUMBER OF FLOPPY DRIVES?

Returns the number of floppy drives installed.

RETURNS: Number of floppy drives intalled
0 If no floppy drives are present

EX: ULT /FLOP



/FREE SHOW FREE SPACE ON CURRENT DRIVE

Shows free space on current drive, as well as bytes per cluster
and sectors per cluster.

EX: ULT /FREE



/GAME IS A GAME PORT INSTALLED?

Determines if a game port is installed. If you want to check
for a joystick in a batch file, this is the way to go!

RETURNS: 0 Game port installed
1 none found

EX: ULT /GAME



/GETKEY GET A KEY FROM THE KEYBOARD

This allows the user to press a key, then sets the DOS
errorlevel to the scancode of the key pressed.

======================= Function Keys =====================

F1-F10unshifted59-68
F1-F10shifted84-93
F1-F10control94-103
F1-F10Alternate104-113

======================= Keypad Keys ========================

Unshifted Control

Home-71119
Up-72
PgUp-73132
Left-75115
Right-77116
End-79117
Down-80
PgDn-81118
Ins-82
Del-83

======================= Alternate + Regular Keys ============

QWERTYUIOP16-25
ASDFGHJKL30-38
ZXCVBNM44-50
1234567890-=120-131

EX: ULT /GETKEY



/GETMODE GET CURRENT VIDEO MODE

Gets the video mode using an ASM call 10h, function 00h, then
set the DOS errorlevel accordingly.

Mode # Type Resolution Colors Video Subsystem
0, 1 Text 40 x 25 16 CGA, EGA, MCGA, VGA
2, 3 Text 80 x 25 16 CGA, EGA, MCGA, VGA
4, 5 Graphics 320 x 200 4 CGA, EGA, MCGA, VGA
6 Graphics 640 x 200 2 CGA, EGA, MCGA, VGA
7 Text 80 x 25 Mono CGA, EGA, MCGA, VGA
8, 9, 10 PCjr only
11, 12 Used internally
13 Graphics 320 x 200 16 EGA, VGA
14 Graphics 640 x 200 16 EGA, VGA
15 Graphics 640 x 350 Mono EGA, VGA
16 Graphics 640 x 350 16 EGA, VGA
17 Graphics 640 x 480 2 MCGA, VGA
18 Graphics 640 x 480 16 VGA
19 Graphics 320 x 200 25 MCGA, VGA

EX: ULT /GETMODE



/HEX BINARY CONVERSION

Shows the binary equivalent to any number entered.
You are prompted to enter a decimal number, which
is then converted and displayed.
To stop this sequence, press CTRL-BREAK.

EX: ULT /HEX



/HIDDEN CHANGE THE HIDDEN ATTRIBUTE

Turns on the hidden attribute of a file. If you are unsure of
attribute meanings, consult your DOS manual.

EX: ULT /HIDDEN file
ULT /HIDDEN list.com



/INWIN CHECKS IF WINDOWS IS RUNNING

This peeks at the current memory to see if Microsoft Windows(tm)
is currently running, then sets the errorlevel accordingly.

RETURNS: 1 if Windows is running
0 nothing found

EX: ULT /INWIN



/KB KEYBOARD STATUS

This shows the status of the keyboard by displaying either
1 or 0, depending on if the keys are currently in use.

The keys are:

RIGHT SHIFT DOWN
LEFT SHIFT DOWN
CONTROL KEY DOWN
ALT KEY DOWN
SCROLL LOCK ON
NUM LOCK ON
CAPS LOCK ON
INSERT ON
FILLER
CONTROL NUMLOCK
SCROLL LOCK DOWN
NUM LOCK DOWN
CAPS LOCK DOWN
INSERT DOWN

EX: ULT /KB



/KIL TOTALLY ERASE A FILE

This totally erases a file, making it unable to be recovered.
Even the popular recovery programs (Norton, PCTools, etc)
cannot recover it.

** PLEASE BE CAREFUL **

It erases a file by doing the following:
1. Setting the time, date, year to 0
2. Change it to hidden/system
3. Deleting it

EX: ULT /KIL myfile
ULT /KIL list.com



/LEVEL SET ERRORLEVEL

This sets the DOS errorlevel. Many times in batch files, it
is necessary to change the errorlevel. This allows you to do
it effortlessly.

EX: ULT /LEVEL 4 (sets errorlevel to 4)
ULT /LEVEL 0 (sets errorlevel to 0)



/LOCK LOCKS THE COMPUTER

Locks up the computer. Requires a warm or cold boot.

RETURNS: nothing


EX: ULT /LOCK



/LOOP LOOPS A PROGRAM SEVERAL TIMES

Many times, you may want to loop through a particular program
more than once. /LOOP allows you to repeat a program up to
65,000 times. If the program needs an argument, then include
the entire command line usage in quotation marks. For instance,
if you want to DIR /W instead of DIR, then use: ULT /LOOP "dir /w"

EX: ULT /LOOP dir 4 (shows a directory 4 times)
ULT /LOOP cd.. 3 (changes three directories up)


/MAP MAKE A MAP OF DRIVE

This maps out the current drive, showing a variety of file and
directory information. This would be useful to quickly find a
file using a text editor, or making a quicky-backup of filenames
for a particular directory.
You can also quickly find duplicate files by loading
the MAPPED file into a text editor, and searching for particular
names. It is best to use the piping symbol ">" to store the
information in a file, rather than watching it scroll across
the screen.

EX: ULT /MAP > mapfile (maps out the current drive, and stores
it in mapfile)


/MATH IS A MATH COPROCESSOR INSTALLED?

Determines if a math coprocessor is installed in the machine.

RETURNS: 0 Math coprocessor found
1 none

EX: ULT /MATH



/MAX SET KEYBOARD REPEAT RATE

Sets your keyboard repeat rate to the maximum allowable. It will
GREATLY increase the speed of your keyboard when scrolling through
a menu or typing.

EX: ULT /MAX



/MONTH SHOW A CALENDAR

This shows a quick calendar of any given month and year.

EX: ULT /MONTH 4 1993 (shows calendar of April, 1993)
ULT /MONTH 9 1973 (shows calendar of September, 1973)



/MOUSE DETERMINES IF MOUSE IS PRESENT

This does a quick check to see if a mouse driver is installed.

RETURNS: 0 Mouse is present
1 NO mouse driver found

EX: ULT /MOUSE



/MULT MULTIPLE DOS COMMANDS

This allows multiple commands on the command line. It is very
similar to a batch file, only it allows it all on one line.
If your command has any spaces in it, ie: DIR /W, then please
surround it with quotes.
IE: DIR /W would become "DIR /W"

EX: ULT /MULT CLS "DIR /W" "DIR /P" PAUSE LIST.COM

would clear the screen, show a wide directory, show a directory
with page breaks, pause, then activate LIST.COM.



/N+ TURN ON NUMLOCK

Turns on Numlock. This is equivalent to pressing the NUMLOCK
key on the keyboard.

EX: ULT /N+



/N- TURN OFF NUMLOCK

Turns off Numlock. This is equivalent to pressing the
NUMLOCK key on the keyboard.

EX: ULT /N-



/NOBUF CLEAR KEYBOARD BUFFER

Clear the keyboard buffer.

EX: ULT /NOBUF



/NOWDAY CURRENT DAY?

Returns the current day. Gets the system date, and sets
the errorlevel to the current day.

RETURNS: Current day of the month (1 - 31)


EX: ULT /NOWDAY



/NOWHOUR WHAT IS CURRENT HOUR?

Returns the current hour in military time.

RETURNS: Current hour (0 - 24)

EX: ULT /NOWHOUR



/NOWMON CURRENT MONTH?

Returns the current month. Gets the system date, and sets
the errorlevel to the current month.

RETURNS: Current month (1 - 12)

EX: ULT /NOWMON



/NOWYER CURRENT YEAR?

Returns the current year. Gets the system date, and sets
the errorlevel to the current year.

RETURNS: Current year (last two digits)

EX: ULT /NOWYER



/NUMBAS CONVERT DECIMAL TO BASE 2 - 16

This converts a decimal number to any number based 2 - 16.

To convert the number 43 to binary, just use: ULT /NUMBAS
Then when prompted for number and base, type: 43 2

EX: ULT /NUMBAS

You are then prompted for a number, and the base you
want it converted to.
IE: 15 2 would convert the number 15 to binary (base of 2)
321 8 would convert the number 321 to a base of 8)
725 10 would convert the number 725 to a base of 10
(which would not change it, since the numbers
we use are already based at 10)



/OFFMOUSE TURNS OFF THE MOUSE AND DISABLES MOUSE DRIVER

This simply turns off the mouse cursor, and disables the
mouse driver.

EX: ULT /OFFMOUSE



/PAGE CHANGE VIDEO PAGE

This changes the video page of the screen. DOS normally operates
on video page 0.
NOTE: This effectively clears the screen, and saves the original
one. Changing to PAGE 1 will bring a blank screen to view,
then changing back to PAGE 0 restores the original screen.

EX: ULT /PAGE 0
ULT /PAGE 3


/PATH SEARCH THE PATH?

Determines if a program is on the Path. DOS normally searches
the "PATH" for a file. This determines if a specified file is
in one of the path directories.
This can be used in batch files to determine if a program
is available to be run. IE: If your batch file needs LIST.COM
to view a file, you can run this to find out if LIST.COM
exists on the user's path.

RETURNS: 0 if file is on the path
1 no file found

EX: ULT /PATH list.com
ULT /PATH q.exe



/PRINT IS PRINT.COM INSTALLED?

Returns the results of a PRINT.COM test. PRINT.COM comes with
DOS versions. Please consult your DOS manual for a further
explanation of PRINT.COM.

RETURNS: 0 PRINT.COM was NOT found
1 PRINT.COM is currently in memory

EX: ULT /PRINT



/PRNL SEND A LINE FEED TO PRINTER

Sends a line feed and carriage return to printer (PORT 1)

EX: ULT /PRNL



/PRNF SEND A FORM FEED TO PRINTER

Sends a form feed to printer (PORT 1). This is GREAT if you
have a laser printer. I have a HP LaserJet II, and everytime
I hit the [PrintScreen] key, nothing happens because the printer
does not receive a FORM FEED. So then I must start up Word Perfect,
and print a blank page just to get my [Printed screen]!

EX: ULT /PRNF



/PUTS PUT A STRING

Places a string on the screen using the following format:

ULT /PUTS X Y color "STRING"

This puts the word string at an X and Y coordinate, using
a specific color.

EX: ULT /PUTS 10 10 10 "This is a test string, dude!"

places the string "This is a test string, dude!" at 10,10 and uses
bright green on black.
Experiment with different colors, and add 128 to any number to
obtain a blinking effect.



/RDONLY CHANGE FILE TO READ ONLY ATTRIBUTE

Turns on the read only attribute of a file. If you are unsure of
attribute meanings, consult your DOS manual.

EX: ULT /RDONLY file
ULT /RDONLY list.com



/REN RENAME A DIRECTORY

Renames a directory using a simple "RENAME" call in Turbo C++.
Since DOS will not allow you to rename a directory, and you
must have a full fledged shell to do it, this solves the
problem. You do not need to load a major shell just to rename
a directory.

EX: ULT /REN oldir newdir (renames oldir to newdir)



/REST RESTORE THE SCREEN

This restores the screen from a file. To save a text mode screen,
use ULT /SAVE option.

EX: ULT /REST filename


/S# MAKE A PARTICULAR SOUND

This makes a particular sound, from 0 to 9.
Experiment with the different pre-set sounds and find
which ones you like the best.

1 arcade2
2 deadbird
3 echos
4 fire
5 high
6 siren
7 bomb
8 ringing
9 pulse
0 wars

EX: ULT /S1 (plays arcade2 sound)
ULT /S5 (plays high sound)



/SAVE SAVE THE SCREEN

Save a text mode screen in a file, which can be restored to the
screen using ULT /REST option.

EX: ULT /SAVE filename (saves the current text mode screen in filename)



/SCRD SCROLL SCREEN DOWN

This is exactly the same as /SCRU, except it scrolls the screen
down.

EX: ULT /SCRD 4 (scrolls the screen down four spaces)
ULT /SCRD 25 (clears the screen very quickly)



/SCRU SCROLL SCREEN UP

This scrolls the screen up. It can scroll up one to 30
spaces, and can be used to quickly clear the screen, or
clear only the bottom portion.

EX: ULT /SCRU 4 (scrolls the screen up four spaces)
ULT /SCRU 25 (clears the screen very quickly)



/SEARCH SEARCH FOR TEXT IN A FILE

This searches for particular text in a file. It can be used for
text or binary files, and uses the BRUTE ALGORITHM to find your
text.

NOTE: Text search is case sensitive.

So to find the word "Yesterday" in a file called NEW.DAT, you
would use:

ULT /SEARCH new.dat Yesterday


EX: ULT /SEARCH new.dat February
ULT /SEARCH docs.001 PrintScreen


/SETD SET DATE IN A FILE

Set the date in a file. It accepts the arguments: MONTH DAY YEAR,
and makes those changes in the file.

EX: ULT /SETD filename 12 21 92 (sets filename's date to December 21, 1992)



/SHAKE SHAKE THE SCREEN

Shake the screen. This is fun.

EX: ULT /SHAKE



/SHARE IS SHARE ENABLED?

Determines if SHARE is enabled. For more information about
SHARE, consult your DOS manual.

RETURNS: 1 SHARE is enabled
0 not enabled

EX: ULT /SHARE


/SOUND MAKE A SOUND

Makes a sound using different tone frequencies specified on
the command line.

You specify the delay in milliseconds between sounds, then
the frequencies you want played.

EX: ULT /SOUND 100 20 30 40 50 60 100 400 500
^ ^ ^ ^ ^ ^ ^ ^ ^
different tones played



delay between tones

plays 20,30,40, etc frequency tones, and pauses 100 milliseconds
between each note.


/SSCUR SET CURSOR START/STOP LINES

The cursor is composed of start and stop lines, and can be made into
several different shapes, depending on which figures you specify
as the start/stop lines.
Play with the numbers and create many different looking cursors!

EX: ULT /SSCUR 1 1 (creates an upside down, thin cursor)
ULT /SSCUR 12 12 (creates a thin, normal cursor)
ULT /SSCUR 10 1 (creates a block cursor)
ULT /SSCUR 3 9 (creates a 1/2 blinking, block cursor)



/STOP PAUSE

This pauses operation of the computer for a specified time in
milliseconds. Instead of using DOS' PAUSE command, which requires
you to press a key, this simply pauses everything for a specified
time, without requiring the user to press a key.
This is great for batch files, in case you want to display
a box or menu of some kind, and pause a few seconds.

EX: ULT /STOP 112 (pauses 112 milliseconds)
ULT /STOP 10 (pauses 10 milliseconds)



/SYS TURN ON SYSTEM ATTRIBUTE

Turns on system attribute of a file. If you are unsure of
attribute meanings, consult your DOS manual.

EX: ULT /SYS file
ULT /SYS list.com


/TD TIME AND DATE

Shows time and date information, without prompting you
for a new one. Whenever you type: TIME on the command line,
it prompts you for a new time. This is annoying when you
just want to check what time it is.
This util solves this by simply providing you with
the information.

EX: ULT /TD



/TIME ACCURATE INTERVAL TIMER

This program shows time elapsed from one period to another.
Time is computed accurately, even if the computer is turned off.

ULT /TIME /S TIME.DAT saves current time in a file named TIME.DAT,
then exits. You are shown the starting time/date.

ULT /TIME /R TIME.DAT retrieves information in file TIME.DAT, and
calculates elapsed time.

To remember options-->

/S stands for "START"
/R stands for "RESTORE"

To time how long it takes your wife to quit complaining:

ULT /TIME /S WIFE.DAT when she opens his mouth and begins
ULT /TIME /R WIFE.DAT after she says no more

To see how long you are logged onto Compuserve:

ULT /TIME /S CIS.DAT before logging on.
ULT /TIME /R CIS.DAT after you log off and return to DOS.

NOTE: You can time unlimited intervals, and keep them all in separate
files. The only limit to your timings is how many files your
disk can handle. The files created by this program are VERY SMALL
(around 24 bytes).

There is a limit of 9,999 years of timing. Not that it really matters,
but if you live forever or something like that, you must re-run the program
after 9,999 years.

If you do live that long, please write me a letter, and if I'm alive,
I'll be glad to make a new program that supports Centuries...

SAMPLE USAGES:
-------------------------------------------
1) Place a "timer" file onto each backup diskette you own. That way, you can
run the program, and find out how old your diskette is.
Possibly, a REALLY old diskette would be a good object to replace with
a newer one !!

2) Time your log-ons to BBS'.

3) For people who run BBS' themselves, you may use this to time how
long your computer has been on.

4) For burning in a new computer, use this instead of watching the
clock, checking ocassionally for that 48 hour mark.

5) Put it in your autoexec.bat file, and determine how long your
computer has been turned off. (for you SERIOUS compu-maniacs)

6) Time how long it takes for more bills to roll in. (because it seems
like I get another bill every day !)



/TODAY SHOW FILES DATED TODAY

Shows files in current directory that have been changed today.
This is useful for backup purposes, or to get a summary of what
an "INSTALL" program has done. Output can be redirected to a file

For redirection, use: ULT /TODAY > myfile

EX: ULT /TODAY



/UNCOMP UNCOMPRESS

Uncompress a file using LZW that has been compressed using
the /COMP switch.

EX: ULT /UNCOMP myfile
ULT /UNCOMP secret.txt



/VEREMS EMS VERSION?

Sets the DOS errorlevel to the version of the current EMS driver.

RETURNS: EMS driver version

EX: ULT /VEREMS



/VERIFY IS VERIFY ENABLED?

Checks to see if DOS's VERIFY is enabled. For more information
about VERIFY, check your DOS manual. (basically, verify makes
sure data is written correctly to the disk)
You can alter VERIFY by using: VERIFY ON or VERIFY OFF

RETURNS: 1 VERIFY is enabled
0 not enabled

EX: ULT /VERIFY



/VIEW VIEW A TEXT FILE

Did you ever want a text-file reader for your batch files?
Here it is. Simply type: ULT /VIEW file

The usual keys are in effect: PgUp PgDn Arrows Esc-exits

EX: ULT /VIEW file
ULT /VIEW ult.doc



/VOL CHANGE VOLUME LABEL

This changes the volume label of a floppy disk.
NOTE: Does not work on a hard disk, only a FLOPPY.
Simply change to a floppy disk, then type:

EX: ULT /VOL Momma (changes label to "Momma")
ULT /VOL My_Disk (changes label to "My_Disk")



/WARM WARM BOOT THE COMPUTER

This reboots the computer, but does not check the system memory
upon entrance. You can get the same effect by pressing
CTRL-ALT-DEL keys simultaneously.

EX: ULT /WARM



/WEEKDAY WHAT IS THE DAY OF THE WEEK?

This sets the DOS errorlevel to the value of the day of the
week (Sunday, Monday, etc)

RETURNS: 0 Sunday
1 Monday
2 Tuesday
3 Wednesday
4 Thursday
5 Friday
6 Saturday

EX: ULT /WEEKDAY



/WND CALCULATE WIND CHILL

Calculates wind chill from the temperature and wind speed. The
actual formula is:

(((10.45 + (6.686112 * sqrt((double) wind speed))
- (.447041 * wind_speed)) / 22.034 * (temperature - 91.4)) + 91.4)

but since it is so complex, I made it as easy as:

ULT /WND wind-speed temperature

EX: ULT /WND 20 31
(The wind is blowing at 20 mph and the temp is 31 degrees)














================== HOW TO MAKE CUTE LITTLE BOXES! ============================

Making cute boxes and writing text to them is tricky. The X
coordinate is on the horizontal axis, and the Y coordinate
is vertical.

The screen looks like this:

0,0
<----------- X axis ------------->
|
|
|
Y axis
|
|
|

79,24

The upper left corner is coordinate 0,0 and the lower right
corner is 79,24.

So to make a box filling the entire screen, you would say:

ULT /BOX 0 0 79 24 12 24 " My Window "

The first two numbers is the coordinate of the upper left corner.
The second two numbers is the lower right coordinate of our box.
The fifth number is the border attribute (the color of the box
outline and the title).
And the last number is the attribute of the inside box.






HOW DO I MAKE COLORS ?


To determine the colors you use for number five and six, do
the following:

Look at this chart (or print it!):

--------------------+--------------------
Color Value Color
--------------------+--------------------
0 Black
1 Blue
2 Green
3 Cyan
4 Red
5 Magenta
6 Brown
7 Light Gray
8 Dark Gray
9 Bright Blue
10 Bright Green
11 Bright Cyan
12 Bright Red
13 Bright Magenta
14 Yellow
15 Bright White
--------------------+--------------------

These are the foreground colors you can use. The text you
print inside the box are the foreground.


--------------------+--------------------
Color Value Background Colors
--------------------+--------------------
0 Black
16 Blue
32 Green
48 Cyan
64 Red
80 Magenta
96 Brown
112 Light Gray


Now to get a White foreground with a Blue background, you
would add the two digits.

WHITE FOREGROUND = 15
BLUE BACKGROUND = 16
-------------------
31 Total

To get a Red foreground on a Light Gray background, add
those two digits.

RED FOREGROUND = 4
LIGHT GRAY BACKGROUND = 112
---------------------
116 Total

Do you follow? Try some different colors out and see how they
look on your system. And if you really want to get advanced...
Suppose I have a box with 49 as the border color and 22 as
the inside box color.
Can you translate that? What colors will those numbers produce?

Look at the background colors first, and find the largest number
that is smaller or equal to 49. Looking at the chart, you'll find
CYAN. Now that leaves 1, which has to be BLUE as the foreground
color.
What about 22? Look at the background chart first. 16 is the
biggest number that's smaller than 22. That is BLUE. Once you
subtract 16 from the 22, you get 6. Now look at the foreground
colors, and notice that BROWN is a 6. So 22 would be BROWN ON BLUE.

Experiment and tell me how you like it.







This is the ShareWare version of ULTRA ToolBox

To register yours send $10.00 to:

David Smith
1104 Mason Dr
Hurst TX 76053

or $20.00 gets you all of my utils and
lifetime registration plus free upgrades


Register the toolbox once, and you never have to register
again. All future upgrades are free!


I have reached my goal!

My goal was to have 250 total options for the toolbox. You
will never have to look for batch utilities again!

See the enclosed ULTENV.EXE for more utilities ...


Please send a cheque or money For VISA/MasterCard order, call
order of US$10 to 1-800-2424-775 or 1-713-524-6394

David Smith Public (Software) Library
1104 Mason Drive P.O.Box 35705
Hurst TX 76053 Houston, TX 77235-5705
USA































Support for this program is available in the following ways:





User ID: 71441,2723
I usually log on every other day and check my mail.






Drop me a line on the Hogard Systems Bulletin Board
David Smith (214) 641-6292








Write to:

David Smith
1104 Mason Dr.
Hurst TX 76053