
readme.txt file for Windows programs
------------------------------------

                                        Last updated: Oct 9, 2006

This directory contains various Windows command-line programs
that you may find useful when working with the Sim390 mainframe
emulator and the MUSIC/SP operating system.

(c) Copyright Dave Edwards, 2001-2006. All rights reserved.

NOTICES:

   This software is provided on an "as-is" basis, without any warranty.
   Use it at your own risk.  The author is not responsible for any
   damages or losses that may occur from your use of this software,
   and no support is provided.  This software must not be used, sold,
   or distributed for profit, without the written permission of the
   author.  It is provided only for personal use by individuals.
   
For more info, Web links, and news, see the following Web pages:

   http://webpages.mcgill.ca/staff/group3/dedwar1/web

   http://www.geocities.com/sim390

Files described below as "Win cmd" are utilities that can be run
from a Command-line window in Windows.  Usually you can get a
short description by typing the program name with no parameters.
To open a Command-line window, use Start --> Run, and enter: cmd.exe
In some earlier versions of Windows (95, 98), you may need to enter
command.com instead of cmd.exe.  On some systems, you can also use
Start / Programs / Accessories / Command Prompt.
For frequent use, create a shortcut to cmd.exe on your desktop.
You can use Properties in the window's File menu to adjust the
window size (for example, try 43 x 80), screen buffer size, font, etc.

File                   Date         Notes
-------------          ---------    ----------

appendto.exe           21nov2004    Win cmd, appends files to the
                                    end of a file.

copyblks.exe           21nov2004    Win cmd, copies 512-byte blocks
                                    from one file to another.

copybyts.exe           16jan2004    Win cmd, copies bytes in files.

encpw.exe              05apr2006    Win cmd, encrypts a password for
                                    transmission to a server.
                                    See encpw.txt.

fixbinmu.exe           16jan2004    Win cmd, specialized file fix-up.

httpput.exe            09feb2006    Win cmd, uploads a file to a web
                                    server using an HTTP PUT request.

md5file.exe            30aug2004    Win cmd, calculates MD5 of a file.
                                    Updated 30aug2004.

md5pw.exe              21nov2004    Win cmd, gets MD5 digest of the
                                    concatenation of 2 strings, normally
                                    a challenge string and a password.
                                    Used for MUSIC/SP sign-on, to
                                    protect the password.

mycomp.exe             21nov2004    Win cmd, compares files.
                                    Wild characters (*) can be used.

sha1file.exe           30aug2004    Win cmd, calculates SHA1 digest of
                                    a file.

wipezero.exe           16feb2004    Win cmd, zeros part of a PC file,
                                    can enlarge it at the same time.
                                    Updated 16feb2004.  Can be used to
                                    enlarge a MUSIC/SP FBA volume.
