Thu 11-December-2003

About TSUTLF in General                        (All rights reserved)
=======================

This is the sixth package  in  my  utilities  series.  TSUTLF  is  a
stand-alone  part  of  the  TSUTIL,  TSUTLB, TSUTLC, TSUTLD, TSUTLE,
TSUTLF and TSUTLG series.

   Ŀ
    Please do not distribute any part of this package separately. 
   

This package may be used and distributed freely for  NON-COMMERCIAL,
NON-INSTITUTIONAL,  PRIVATE  purposes, provided it is not changed in
any way. For ANY other usage, such as use at a  university,  contact
the author. Full business usage is not allowed.

The  programs  are  under  development. Comments and bug reports are
welcome.

The author shall not be liable to the user for any direct,  indirect
or  consequential loss arising from the use of, or inability to use,
any program or file howsoever caused. No warranty is given that  the
programs will work under all circumstances.

Timo Salmi
Professor of Accounting and Business Finance
Department of Accounting and Finance
Faculty of Business Studies
University of Vaasa
P.O. BOX 700, FIN-65101 Vaasa, Finland
mailto:ts@uwasa.fi WWW: http://www.uwasa.fi/~ts/


Timo Salmi UTiLities set F, release 1.7 includes the following
*    *     ** *          *          * *
utility-type programs:

TSUTLF17        Sixth set of Utilities, T.Salmi
Filename        Comment
--------        --------------------------------
ADVDATE.EXE     Advance system clock's date
CHOOSE.EXE      Ask questions in batch files
CHTEST.BAT      An example of using CHOOSE.EXE
DELEDIR.EXE     Generalized delete directory
FILE_ID.DIZ     Brief characterization of TSUTLF
GOTODIR.EXE     Generalized change directory
MAKEDIR.EXE     Generalized create directory
STRINGS.EXE     Find a file's embedded strings
STRMEMO.EXE     Find strings in your PC's memory
TSPROG.TXT      List of programs from Timo Salmi
TSUTLFIN.TXT    Document (a readme) for TSUTLF
TSUTLFNW.TXT    News announcements about tsutlf
VAASAINF.TXT    Info: Finland, Vaasa, U of Vaasa
----            ------             ------  -----
0013


ADVDATE.EXE (Ver 1.1)  Advance system clock's date
=====================

Usage: ADVDATE [numberOfDays]

If you have MS-DOS 3.3+ also the CMOS date is updated.

When run without any parameter, the program detects a Windows_NT OS
environment variable and notifies the user that the program is best
suited for the MS-DOS based environments.


CHOOSE.EXE (Ver 1.1)  Ask questions in batch files
====================

Usage: CHOOSE [/c[:]keys] [/?|/h] [/n] [/s] [/t[:]c,nn] [/x] [text]
    the prompt keys                                    
                      Help                              
No default prompt (only user text)                       
                 apply case Sensitivity                   
  default key after timeout (must be among keys)           
                                Timeout in seconds          
                          Output @set choose_=returnCode     
                                           user's text prompt 

MS-DOS 6.0 finally included a CHOICE command for making user choices in
batches. CHOOSE simulates CHOICE for the earlier MS-DOS versions reasonably
accurately. The idea is that if you have obtained a batch that uses
CHOICE, but you don't have MS-DOS 6.0, you can still utilize the batch.
The syntax is naturally based on MicroSoft's, except for the addition of
the help switch. The actual CHOOSE program is a Turbo Pascal 5.0 program
based the author's own, earlier ASK program for making choices in batches.
(Contrary to CHOICE, CHOOSE handles also the /t:c,0 timeout correctly.)

CHOOSE returns an errorlevel corresponding to the location of the
prompt keys in the /c switch. See CHTEST.BAT for an example of using
CHOOSE.EXE.

If the extra /x switch alternative is used, the default directory
needs to be writable. Else the needed auxiliary file CHOOSE_.BAT
can't be created by the program.


DELEDIR.EXE (Ver. 1.1)  Generalized delete directory
======================

Usage: DELEDIR [DirectoryName]

DELEDIR is an enhanced rmdir command. It can remove also directories
with blanks in the directory name. Double quotes can be used to
delimit the directory name. For example

 DELEDIR "My dir"

It is highly advisable to check with dir what directory name was
actually removed if you use special characters. MS-DOS can cause
unexpected results in some cases. Besides no advance error checking
is made for the directory name or syntax you use.

Long Windows 95/98/ME names are not supported. NT/2000/XP usage is
not recommended.


GOTODIR.EXE (ver. 1.1)  Generalized change directory
======================

Usage: GOTODIR [DirectoryName]

GOTODIR is an enhanced chdir command. It can also go to directories
with blanks in the directory name. Double quotes can be used to
delimit the directory name. For example

 GOTODIR "My dir"

The name will be capitalized.

Warning: Use this command with extra caution and at your own risk.
Writing to an unconventionally named directory can confuse some
programs, and you might even lose some data on your disk.

Long Windows 95/98/ME names are not supported. NT/2000/XP usage is
not recommended.


MAKEDIR.EXE (ver. 1.1)  Generalized create directory
======================

Usage: MAKEDIR [DirectoryName]

MAKEDIR is an enhanced mkdir command. It can create also directories
with blanks in the directory name. Double quotes can be used to
delimit the directory name. For example

 MAKEDIR "My dir"

The name will be capitalized.

It is highly advisable to check with dir what directory name was
actually created if you use special characters. MS-DOS can cause
unexpected results in some cases. Besides no advance error checking
is made for the directory name or syntax you use.

Long Windows 95/98/ME names are not supported. NT/2000/XP usage is
not recommended.


STRINGS.EXE (Ver 1.1b)  Find a file's embedded strings
======================

Usage: STRINGS
 [/b] [/m###] [/o] [/s] InputFileName
                  
                   Scandinavian (Finnish) character set
               Omit the offset information from the output
        Minimum number of characters considered a word (default 4)
    Batch mode, no headers or footers

Finds the strings embedded in a text or a binary file. A string is
defined as starting with a letter.  The body of the string can
contain letters, digits, and the special characters hyphen (-),
underscore (_), and apostrophe (').

If the output is redirected to a file with > redirection or piped
with |, the program's messages will still be written to the screen
(the standard output device). A < redirection is not allowed.

The Finnish character set adds the following to the English set:  
   .

Tip: Usage for preventing the results scrolling off the screen
  STRINGS MyFile | more
Better still
  STRINGS MyFile | list /s
where list is from Buerg's garbo.uwasa.fi:/pc/fileutil/list77a.zip
or whatever is the current version when you read this.

Another tip: You can sort the output using
  STRINGS MyFile | sort /+9


STRMEMO.EXE (Ver 1.1b)  Find strings in your PC's memory
======================

Usage:
STRMEMO [/b] [/m###] [/o] [/s] StartAddressInHex EndAddressInHex
                         
                          Scandinavian (Finnish) character set
                      Omit the offset information from the output
               Minimum number of characters considered a word (default 4)
           Batch mode, no headers or footers

Finds the strings embedded in the computer's memory. A string is
defined as starting with a letter.  The body of the string can
contain letters, digits, and the special characters hyphen (-),
underscore (_), and apostrophe (').

The starting address and the ending address must be given as
hexadecimals ranging from $00000 to $FFFFF.

If the output is redirected to a file with > redirection or piped
with |, the program's messages will still be written to the screen
(the standard output device).

For the Scandinavian characters and a tip see the STRINGS.EXE
information above.
