
*******************************************************************
*******************************************************************

             HOW TO USE THE FLOPPY UTILITY PROGRAM
                         - FLOPPY.BAS

*******************************************************************
 15-MAR-76                                  PROGRAMMER: R.SZEWCZYK
*******************************************************************
*******************************************************************

                             ABSTRACT
                             ********
FLOPPY.BAS IS A PROGRAM, SIMILAR IN OPERATION TO PIP, WHICH ALLOWS
MULTIPLE FILES TO BE SAVED ON A FLOPPY DISK UNDER RSTS/E.

FILES ARE STORED IN A FORMAT COMPATABLE WITH STANDARD FLOPPY STOR-
AGE UNDER RT11, ENABLING EASY TRANSFER OF FILES BETWEEN THESE TWO
SYSTEMS.

OPTIONS INCLUDE:   INITIALISATION OF FLOPPY
                   FILE TRANSFERS TO AND FROM FLOPPY
                   LISTING THE DIRECTORY
                   FILE DELETION
             AND   COMPRESSION OF FILES INTO ONE CONTIGUOUS AREA.

******************************************************************

TO RUN FLOPPY
*************
 NOTE:  TO PREVENT OTHER USERS FROM WRITING TO YOUR FLOPPY
WHILE YOU ARE USING IT, IT MAY BE WISE TO ASSIGN THE FLOPPY
UNITS TO YOUR TERMINAL BEFORE RUNNING.


            TYPE:    RUN$FLOPPY
        RESPONSE:    ENTER COMMAND ?
                     ---------------

YOU CAN NOW GO AHEAD AND ENTER ONE OF THE COMMANDS.

*****************************************************************

COMMANDS AVAILABLE
******************

(1) TO INITIALISE YOUR FLOPPY
*****************************

           TYPE:     DXN:/Z       (WHERE N IS THE FLOPPY UNIT NO.)
                                      I.E.  =1 FOR UNIT 1
                                            =0 FOR UNIT 0
       OR  TYPE:     DX:/Z         ( ASSUMES UNIT ZERO )

       RESPONSE:     INITIALISE FLOPPY UNIT N, ARE YOU SURE ?
                     ----------------------------------------
           TYPE:     Y FOR YES   OR    N  (FOR NO)

E.G.    DX1:/Z     - INITIALISE FLOPPY ON UNIT 1


(2) TO COPY A FILE TO FLOPPY DISK
*********************************

          TYPE:     DXN:FILENAME2<FILENAME1

COPIES FILE FILENAME1 FROM RSTS DISK ONTO FLOPPY IN UNIT N,
WHERE IT WILL BE NAMED FILENAME2.

IF FILENAME1=FILENAME2 THERE'S NO NEED TO TYPE BOTH IN; THE
EQUIVALENCE IS ASSUMED WHEN EITHER ONE IS MISSING.

       E.G.   DX1:FRED<

COPIES FILE FRED.BAS FROM RSTS FILES TO FLOPPY ON UNIT 1
(NOTE EXTENSION .BAS ASSUMED BY DEFAULT)

THE FOLLOWING COMMANDS ARE EQUIVALENT:
            DX1:FRED<
            DX1:FRED.BAS<FRED.BAS
            DX1:<FRED.BAS
            DX1:<RK:FRED

(3) TO COPY A FILE FROM FLOPPY DISK
***********************************

          TYPE:      FILENAME2<DXN:FILENAME1

COPIES FILE FILENAME1 FROM FLOPPY UNIT N ONTO THE RSTS
SYSTEM, GIVING IT THE NEW NAME FILENAME2.

        E.G.    TEST.DAT<DX0:

COPIES THE FILE TEST.DAT FROM FLOPPY UNIT 0 ONTO RSTS.

(4) TO LIST THE FLOPPY DIRECTORY
********************************

          TYPE:    DXN:/L

LISTS THE DIRECTORY OF FLOPPY UNIT N.

      E.G.       DX:/L

LISTS THE DIRECTORY OF FLOPPY UNIT 0 (BY DEFAULT)

THE LISTING GIVES  FILENAMES AND FILE LENGTHS

      E.G.      FILENAME      BLOCKS
                 FRED.BAS        8
                 <UNUSED>      472

INDICATING FILE FRED.BAS IS 8 BLOCKS LONG
(WHERE EACH BLOCK= 512 CHARACTERS)
AND THE REST OF THE FLOPPY IS UNUSED.
(480 BLOCKS TO A FLOPPY)

(5) TO DELETE A FILE FROM FLOPPY
********************************

         TYPE:    DXN:FILENAME/D

DELETES THE FILE FROM FLOPPY ON UNIT N BY MARKING IT
AS UNUSED IN THE DIRECTORY.

(6) TO COMPRESS THE FILES ON FLOPPY
    INTO ONE CONTIGUOUS AREA
***********************************

        TYPE:     DXN:/S

THIS ELIMINATES GAPS OF UNUSED SPACE ON FLOPPY
UNIT N LEAVING MORE SPACE AFTER THE LAST FILE
WHERE IT CAN BE USED.

(7) TO TERMINATE THE PROGRAM AND RETURN TO RSTS MONITOR
*******************************************************

       TYPE:      EX


******************************************************************
******************************************************************
