Disk Utilities 4.2

[atrax27407]

Does anyone have the full docs for Disk Utilities 4.2?

[sparkdrummer]

README

 

Documentation for DSKU is provided in three files: .

1) DSKU/DOCS
2) DSKU/REF
3) DSKUM-ADD


DOCS contains text while REF supplies figures (screen displays) for use
along with the text pages. .

DSKUM-ADD contains an addendum regarding vserion 4.2m .

No 'Formatter' commands have been included and the entire documentation
may be printed via any D/V 80 print utility and still provide room for
3-hole punching. .

Two instances of printer commands are imbedded in the REF file: One to
switch the printer to compressed mode and set left margin to 20, the
other to turn compressed off and return margin to 0. They are for Epson
compatible printers, i.e., CHR$(15) ESC 'l' CHR$(20) and CHR$(18) ESC
'l' CHR$(0), located in the REF file immediately preceeding and
following figure 2. If necessary, change (or delete) them. .

To receive the complete documentation for this program and to become a
REGISTERED user of Disk Utilities please send the requested FAIRWARE
amount of $15 to me at the above address. .

NOTE: Documentation is to be made available only to REGISTERED users. .

To those of you have already become REGISTERED users of Disk Utilities.



THANK YOU
John Birdwell

 

DOCS

 

****************************
* *
* DISK UTILITIES *
* *
* VERSION 4.2 *
* *
* John Birdwell *
* 1310 Kent Court *
* Wheaton, IL 60187 *
* *
****************************

DISK Utilities V 4.2 is distributed as FAIRWARE. If you use it, please
remit $15.00 to the author at the address shown above. Registered owners
send $5.00 (or disk, mailer and postage) to receive this version.

DSKU enables the user to access data stored on a diskette. It should be a
valuable tool for the serious student of disk data storage. For experts
it provides superior convenience in sector editing and file handling.
Those already familiar with DSKU will appreciate the many new features
and enhancements of this version.

A Super-Cart version of DSKU is available. However, due to limited memory
the SC version remains at the 3.0 level.



A. Equipment Required
---------------------

TI-99/4A console
32K Memory Expansion
Disk Drive(s)
Extended Basic, TI-Writer or Editor/Assembler Module
CHARA1 file on DSK1 for true lower case (optional)


B. Loading DSKU
---------------

Extended Basic:
1. Place disk in drive 1
2. Select Extended Basic
3. DSKU will auto-load
(Note: LOAD, LOADER, DSKU1, DSKU2 and DSKU3 must be on the
boot disk)

Editor/Assembler:
1. Place disk in drive 1
2. Select option 5 (Run Program File)
3. Enter DSK1.DSKU1
(Note: DSKU1, DSKU2 and DSKU3 must be on the boot disk)

TI-Writer:
1. Place disk in drive 1
2. Select option 3
3. Enter DSK1.DSKU1
(Note: DSKU1, DSKU2 and DSKU3 must be on the boot disk)


DSKU V 4.2 DOCS Page 1 of 11
..
C. Main Menu Selections
-----------------------

DSKU is entirely menu driven. Main menu selections are:

1) File Utilities
2) Disk Manager
3) Disk Utilities
4) Sector Utilities
5) Setup
6) Exit
7) Load FW

Each option is explained in detail on the following pages. On some
screens, default options are shown and only the <enter> key needs
to be pressed to make the selection.




D. Command Keys
---------------

1. Global Command Keys (always active while DSKU is running):

FCT-4 Return to Main Menu (also cancel print-out in progress)
FCT-8 Redo (repeat selected function)
FCT-9 Return to sub menu
FCT-+ Exit from DSKU
CTL-P Screen Dump


2. Input Screen Command Keys (active when an input screen is on display):

FCT-1 Delete character
FCT-2 Insert character
FCT-3 Delete all characters of a field
FCT-S/D Cursor left/right
FCT-E/X Cursor up/down in Disk Manager)
CTL-D/H Hexidecimal and decimal convertors

3. Editor Command Keys (active when using File or Sector Editor):

CTL-A (A)SCII display of sector
CTL-H (H)ex display of sector
CTL-N (N)ext sector
CTL-B (B)ack one sector
CTL-W (W)rite changes to sector
CTL-D (D)one, clear screen, enter a new sector number
CTL-R ®ead another sector
FCT-1 Delete character
FCT-2 Insert character
----> All arrow keys

This list is also included in the separate REF file. A print-out should
by kept near the keyboard for reference. Main editing keys are mnemonic
(CTL-A = ASCII, CTL-H = hex, etc.) and should be easy to remember.



DSKU V 4.2 DOCS Page 2 of 11
..
E. File Utilities
-----------------

Options are:

1) File Ops
2) File Recover
3) File Report
4) File Editor
5) Find String
6) File Compare
7) File Print


1) File Ops (Figure 2)

After selecting drive number, a disk catalog is displayed.
Information is presented as described above, i.e., page counter
at the upper right, program length in bytes, etc. Listed at the
bottom are the various commands for this mode. They are:

(A)ll - Puts a 'C' in the OP field of all files. If most of
the files are to be copied, the use of (A)ll followed
by pressing <enter> allows quick movement through all
files and pressing the spacebar will erase any C to
exempt files from being copied. (A)ll is also a most
convenient way to unfracture files onto a copy disk.

©opy - Places a 'C' in the OP field. The cursor moves to
the DEST field (right) and the file name is repeated.
At this point, a new file name may be typed over the
old one and the file will be copied under this new
name to the destination disk. For no change, press
<enter> to advance the cursor to the next line.
Note: A file of the same name on the destination disk
will be overwritten when ©opy is invoked.

(D)elete - Puts a 'D' in the OP field. If protected, input will
not be accepted. Inputting a 'P' will remove the 'D'.

(E)dit - Enters the File Editor function for the selected file

(M)ove - Puts an 'M' in the OP field. In contrast to ©opy,
'moving' a file will not overwrite an existing file
on the destination disk and a warning is displayed.

(P)rotect - Puts a 'P' in the PROT field. File will be protected.

®ename - Puts an 'R' in the OP field and cursor is moved to
the name field where the file name may be changed.

(U)nprotect - Puts a 'U' in the PROT field. Protection is removed.

(V)iew - This is an immediate command. The selected file (D/V
or D/F) is displayed on the screen or sent to the
printer. Scrolling is controlled by pressing the
space bar. Screen may be dumped to output device via
CTL-P. Current top and bottom line numbers are shown
at the lower left and right of the screen.

DSKU V 4.2 DOCS Page 3 of 11
..

Ctrl-X - Advances to next page (if any) of the file catalog.

Ctrl-E - Returns to previous page (if any) of the catalog.

Funct-6 - Executes the commands shown in the OP column. May be
invoked at any time, no need to move to the end of
a page. If C has been selected, the option for disk
initialization follows this command.
These functions operate on a file-name basis. When one of these options
is chosen, the next prompt is always for a file name.


2) File Recover

If, due to equipment failure or operator error, a file has been inad-
vertently deleted, it may be recovered. Successful recovery is not
likely if any files have been modified or copied onto the disk and
now utilize sectors of the file to be recovered. The numbers of any
sectors which have been corrupted will be displayed. At this point the
user may continue or abort the recovery. In any event, recovery is
only useful for text files and might result in two files occupying the
same sector. Use only under extreme circumstances.


3) File Report (Figure 3)

Provides the same information as 'Disk Report', but only for the named
file. Output is to the screen. The comment line (if any) is displayed
and may be edited. If there is no comment, one may be added.


4) File Editor (Figure 4)

Displays the first sector of the named file in hex. CTL-A & H will
toggle between hex and ASCII displays. All arrow keys are active and
the cursor can be moved to any byte location (shown in the lower right
in decimal and hex). FCT/1 will delete the character at the current
cursor location, a space in ascii or a null in hex will be placed at
the end of the sector to take the place of the deleted character.
FCT/2 will insert a space in ascii or a null in hex, at the current
cursor location, the last character in the sector will be lost. An
SOF or EOF displayed above the sector number indicates the starting
or ending sector of a file. A visible and audible (Honk) warning is
issued if CTL-B(ack) or N(ext) would exceed the file's boundaries.
The user may, however, choose to do so, in which case DSKU will
automatically revert to the Sector Editor. In the edit mode, any
changes are indicated by inverse video. Before going to another
sector, they must be written (CTL-W) or they will be voided. When
CTL-W is pressed, the entire sector display will reverse color as a
warning that a write is about to be performed. The cursor moves to
the disk number. Pressing <enter> for both disk and sector number
will write the sector back to its original location. Entering other
values provides the opportunity to write the sector to another disk
or sector location.






DSKU V 4.2 DOCS Page 4 of 11
..

5) Find String (Figure 5)

After entering the file name and drive number, the procedure is the
same as described under 'Find String' in Section F (Disk Utilities).
The search, however, is conducted only between the starting and ending
sectors of the named file. Once an occurrence is found, the sector
number in the file is displayed, and one of the options shown on the
screen may be exercised.

6) File Compare (Figure 6)

After entering the file name and drive number, the procedure is the
same as described under 'Compare Disks' in Section F (Disk Utilities).
Non-matching sectors may be listed to the output device or their
sector numbers (up to a maximum of 40) shown on the screen.

7) File Print

All sectors of the named file are listed to the output device in the
selected mode. If output is to disk, it is suggested that print size
be set to 'Standard' to obtain a D/V 80 file which is accessible with
TI-Writer. (Compressed will result in a D/V 132 file.)


F. Disk Manager
---------------

The disk manager provided with DSKU includes the following functions:

1) Initialize Disk
2) Copy (Backup)
3) Copy (Bitmap)
4) Validate Disk
5) Rename Disk
6) Reset Disk

1) Initialize Disk (Figure 7)

When this function is selected and the prompt for the drive number has
been answered, the screen appears as shown in 4a or 4b (depending on
whether a used or blank disk is found in the selected drive). A 'Yes'
answer to the 'Initialize Disk' prompt moves the cursor to the first
and subsequent fields as each entry is made.
The "Date" option is new and deserves an explanation: Date information
is stored in the VIB (Volume Information Block, sector 0) of the disk
starting at byte 20. This is an 8 byte area reserved for 'future
expansion' by TI.

*** NEW IN V 4.2 *** When formatting is completed you are prompted for
formatting another disk. If you chose Yes the parameters from the last
format will be used. This feature will allow you to quickly format
multiple diskettes.

CAUTION: INITIALIZATION ERASES ALL DATA PREVIOUSLY STORED ON THE DISK!

2) Copy (Backup) - Self-explanatory

3) Copy (Bitmap) - Copies only used sectors


DSKU V 4.2 DOCS Page 5 of 11
..

4) Validate Disk

Checks for bad sectors. Any that are found are listed to the screen.
When validation is complete, the disk's bit-map may be updated to
reflect the shortage of usable sectors. Validation is non-destructive
and can be done on a disk containing data files. An occupied bad
sector is identified by an asterisk.

5) Rename Disk - Self-explanatory. Can also be used to change date.


6) Reset Disk - Resets a disk to its initalized state wthout initializing


G. Disk Utilities
-----------------

Functions accessible from this option operate on a disk-wide basis, hence
their name. These functions are:

1) Disk Report
2) Directory/Comment
3) Find String
4) Compare Disks



1) Disk Report (Figure

Prints a disk catalog including information not normally obtained with
a disk manager/cataloger.

Information furnished by a DSKU Disk Report includes the following:

a) The length of a PGM file in bytes as well as sectors.
b) Starting and ending sector location for each file. If more than
one is shown, the file is fractured.
c) A comment line (see 'Directory/Comment' below).
d) The sector where the FDR (File Descriptor Record)
for the file is located.


2) Directory/Comment (Figure 9)

Essentially the same as Disk Report except:

a) Output is directed to the screen.
b) Starting/ending sectors are not shown.
c) Comments can be added, modified or deleted.
d) Fractured files are indicated by an asterisk.

Five files and their comment lines are shown at a time. Note that in
the upper right hand corner, the current and total number of pages of
the Directory/Comment are displayed. Pressing <enter> will advance to
the next page. If the last page is on display, then <enter> will loop
back to page 1. On each page the files are numbered from 1 to 5.
Selecting one of them will move the cursor to the file's comment line
and new information can be entered.


DSKU V 4.2 DOCS Page 6 of 11
..

--> A note regarding 'Comments':

DSKU uses the last 35 bytes of the FDR (file descriptor record) to
store comments. Normally, bytes 28 through 255 are reserved for the
data chain pointers. A badly fractured file might conceivably use
all of this area. This is highly unlikely unless a file gets changed
frequently and no effort is made to unfracture it. Also, disk managers
do not read data in this area beyond the data chain pointers. Only
when disks and files are copied with DSKU, will comments be read,
copied and displayed.


3) Find String (Figure 5)

Requires input of the disk drive and the starting and ending sectors
for the search. Total number of sectors is shown at the bottom of the
display. Input of the search string may be in ASCII (16 characters) or
hex (32 bytes). After the search string has been entered, a prompt for
a 'Replace String' shows the same string as a default. If desired, a
new string may be entered, however, its length may not exceed that of
the search string. If an occurrence of the search string is found, it
is shown highlighted (inverse video). If a 'replaced string' has been
entered, the 'R' and 'W' commands will make the change permanent.
See also File Edit in Section H for more detail on editing sectors.


4) Compare Disks

Does a sector-by-sector comparison of two disks. May be done for all
sectors or over a selected range of sectors only. If screen output has
been chosen, up to 40 non-matching sectors are listed by number(s).
Output to printer will print contents of the non-matching sectors.



H. Sector Utilities
-------------------

1) Edit Sector (Refer to figure 4)

Requires input of drive and sector number. See File Editor (Section E)
for details.


















DSKU V 4.2 DOCS Page 7 of 11
..

2) Print Sector

There are two formats available for printing sectors. (See Setup,
Section E.) The side-by-side format prints the sector contents in hex
on the left, 32 bytes per line, and the ASCII equivalents to the right
of the page. Option 2 prints the ASCII values first and their hex
equivalents on the two lines below. For example:

Sector # 0003

0 2 4 6 8 A C E 0 2 4 6 8 A C E ---ETC--->

0DSKU1 ..................&...
45453222220000020000000000002803
43B51000000010000000000000006008

In other words, the hex values must be read vertically, D=>44, >S=>53,
K=>4B, etc. In both modes, compressed printing is recommended for
unbroken lines across the page.

3) Copy Sectors
Copies a range of sectors to another disk. Inputs are input drive,
output drive, starting sector and ending sector.

4) Mark Sector
Marks the desired sector as used in the sector bit-map.

5) Free Sector
Frees a sector from the sector bit-map back to an available state.


I. Setup
--------

Provides for setting print device name, print modes (fonts & form feed),
screen colors and drive configuration.


1) Printer Setup

a) Select Printer Type: Default shown is PIO. If a serial printer is
to be used, up to 28 characters may be entered for RS232 port,
baud rate, data bits, parity, etc.

b) Formfeed after print Y/N: Enter Y or N depending on whether a form
feed is to follow print-out.

c) Print-out type: Option 1 prints the contents of a sector in hex to

the left of a page, the ASCII equivalents are shown on the right.
Option 2 prints a line of the ASCIIs first, followed by two lines
representing the hex values. See Print Sector (Section I).








DSKU V 4.2 DOCS Page 8 of 11
..

d) Printout Sizes: Choices are N (normal pica) C (compressed)
S (special) for Disk Report, Screen Dump, Sector Print and File.
(Compressed is preferred for Sector Print!)

Note: Printer commands incorporated in DSKU are for Okidata printers.
If selection of Compressed mode does not produce the desired
result, see Section J (User Notes).

Note 2: If you are using a printer other than an Okidata you MUST
change the Reset modes to power up state code as this is
sent to your printer upon completion of each print operation.
See Section J (User Notes).



2) Screen Colors

Enter values for foreground (text) and background (screen) colors as
listed on the screen. Colors change as keys are pressed. Return to
menu via Function-9.



3) Maximum disk drives

Enter highest number of drives available. This will be the maximum
allowed as valid input when disk drives are selected for copying or
editing operations.

Note: DSKU can be used with a single-drive system. If drive 1 is
entered as both the FROM (source) and TO (destination) drive,
prompts are displayed when disks must be switched.




























DSKU V 4.2 DOCS Page 9 of 11
..

J. User Notes
-------------

The following information is furnished for those who use printers other
than Okidata and those who wish to make 'Setup' defaults permanent. How
to direct output to a disk drive is described also.

1) Program Defaults

Shown below are the bytes which determine the defaults shown on the
'Setup' screen. They are located in the first sector of the DSKU1 file.
They may be changed to suit the user's system and preferences.

---- ---- ---- ---- ---- ---- ---- ----
---- --03 5049 4F20 2020 2020 2020 2020
2020 2020 2020 2020 2020 2020 2020 2020
1D00 1E00 0000 0000 0000 0000 0000 0000
0000 0000 0000 0000 1800 0CF4 0101 0001
---- --05 00-- --10 ---- ---- ---- etc.

Byte No. Contents Function
>13 03 Length of output device name. >03 = PIO.
>14-2F 5049 4F20 28 bytes for printer type, PIO default shown
>30-31 1D00 Compressed mode. >1D=Okidata, >0F=Epson
>32-33 1E00 Normal pica mode. >1E=Okidata, >12=Epson
>34-47 0000 Special print codes up to 20 bytes
>48-49 1800 Reset modes to power state >18=Okidata >1B40=Epson
>4A 0C Form feed. >0C=yes, >00=no
>4B F4 Screen colors (F=text, 4=screen).
>4C 01 Print mode, disk report (01=std, 00=comp., 02=spec)
>4D 01 Print mode, screen dump (" " , " " " " )
>4E 00 Print mode, sector print (" " , " " " " )
>4F 01 Print mode, file print (" " , " " " " )
>53 05 Maximum number of disk drives (01-09)
>54 00 Sector print mode (00 = side-by-side, 01 = vert.)
>57 10 Set key repeat speed (decrease to speed up)

NOTE: You must re-load DSKU for changes to take affect.


2) Output to disk

Output can be directed to disk by entering DSKn.filename instead of PIO
or other printer. (See Setup.) Printout sizes should be set to Normal
to obtain D/V 80 files. (Compressed will produce D/V 132 files.) Once a
file has been opened (the first time CTL-P is used), subsequent 'screen
dumps' will be appended to this file unless a new file name is entered
before CTL-P is used again. This feature could be employed to maintain
a commented and dated master disk catalog.











DSKU V 4.2 DOCS Page 10 of 11
..

3) Hex and Decimal Convertors

For your convenience a hex to decimal and a decimal to hex convertor
have been included. These convertors are availble any time keyboard
input is expected, except while in the sector/file editor. To utilize
these convertors press CTL/D for the decimal to hex convertor or CTL/H
for the hex to decimal convertor. Upon depression of these keys the
bottom 2 lines on the display are saved and you are presented with a
blank area with a cursor to input the desired number. After typing
this number press ENTER and its corresponding value will be displayed.
To turn the convertor off press CTL/H or CTL/D and the last two lines
of the display will be restored and ready for input. These convertors
are accurate up to 65535 decimal or >FFFF hex.


K. Conclusion
-------------

Before using DSKU be sure to make a backup of it. Since this program is
intended to read from and write to disk, an erroneous key press can have
disastrous results and render this disk useless. The same is true for
any program or file you may wish to edit: Always use a backup!

A special verson of Disk Utilities (4.1M) is available for use with
the Myarc Disk Controller. This is required to format a DS/DD disk
to 1440 sectors. If you are utilizing this program with either a
Geneve 9640 or have the 80 track Eprom installed in your disk
controller this version is not needed. If you are in need of this
version please indicate when requesting this program.


I hope you will find DSKU a worthwhile addition to your program library,
and enjoy using its multitude of utilities. If you have any suggestions
for improvement or - heaven forbid! - should you discover any bugs still
lurking in its innards, please let me know.

REFERENCE

****************************
* *
* FIGURES 1-9 *
* *
* FOR DISK UTILITIES *
* *
* Version 4.2 *
* *
* John Birdwell *
* 1310 Kent Court *
* Wheaton, IL 60187 *
* *
****************************






FIGURE 1 - COMMAND KEY LISTING



A. GLOBAL COMMANDS (always active when DSKU is running)


FCT-4 Return to Main Menu (also cancel print-out in progress)
FCT-8 Redo (repeat selected function)
FCT-9 Return to sub menu
FCT-+ Exit from DSKU
CTL-P Screen Dump



B. INPUT SCREEN COMMANDS (when responding to on-screen prompts)


FCT-1 Delete character
FCT-2 Insert character
FCT-3 Delete all characters in a field
FCT-S/D Cursor left/right
FCT-E/X Cursor up/down in Disk Manager)
CTL-H/D Hexidecimal and Decimal convertors


C. EDITOR COMMANDS (in either File or Sector Editor mode)


CTL-A (A)SCII display of sector
CTL-H (H)ex display of sector
CTL-N (N)ext sector
CTL-B (B)ack one sector
CTL-W (W)rite changes to sector
CTL-D (D)one, clear screen, enter a new sector number
CTL-R ®ead another sector
----> All arrow keys





DSKU V 4.2 REF Page 1 of 6
..

FIGURE 2 - FILE OPS



a) Screen display before commands are entered


DSKU4.2 Files 7 Date 04/25/88 1/1
Total 1438 Free 1183 Copy 0/0000
OP Source Type Size P Dest.
========================================
*READ-ME D/V 80 7
CHARA1 PGM 1024 5
DSKU/DOCS D/V 80 104
DSKU/REF D/V 80 49
DSKU1 PGM 8192 33
DSKU2 PGM 8192 33
DSKU3 PGM 5768 24




________________________________________
(A)ll (Copy) (D)elete (E)dit (Move)
(P)rotect ®ename (U)nprotect (V)iew
CTRL-X/E = Next/Back FCTn-6 = Execute





b) Screen display after commands have been entered


DSKU4.1 Files 7 Date 04/25/88 1/1
Total 1438 Free 1183 Copy 5/0219
OP Source Type Size P Dest.
========================================
D *READ-ME D/V 80 7 Delete file
CHARA1 PGM 1024 5 No action
C DSKU/DOCS D/V 80 102 DOCS Copy and change file name
C DSKU/REF D/V 80 27 REF " " " " "
C DSKU1 PGM 8192 33 DSKU1 Copy, retain file name
C DSKU2 PGM 8192 33 DSKU2 " " " "
C DSKU3 PGM 5768 24 DSKU3 " " " "




________________________________________
(A)ll (Copy) (D)elete (E)dit (Move)
(P)rotect ®ename (U)nprotect (V)iew
CTRL-X/E = Next/Back FCTn-6 = Execute







DSKU V 4.2 REF Page 2 of 6
..

FIGURE 3 - FILE REPORT


File Report
========================================
Filename DSKU1

Drive 1

File Type PGM 8192 FDR >0006

Sector
Size Start End Pro
=======================================
33 00C3 00E2 No




Comment
V 4.2 part 1




FIGURE 4 - FILE EDITOR (screen display)

File Editor EDIT
========================================
FFFF 2000 A000 0460 A914 0016 1100 8484 This is a typical hex
0000 0003 5049 4F20 2020 2020 2020 2020 display of the first
2020 2020 2020 2020 2020 2020 2020 2020 sector of DSKU1.
0F00 1200 00F1 0000 0000 0000 0005 000D Figure 5 shows the
07FA FF00 0800 000B 4453 4B31 2E43 4841 same sector in ASCII
5241 3100 01F0 0218 0240 8000 AA86 AAAE mode.
CA0A AAD6 EE4C D7EA D8FE DA4A B444 B68A
B878 B0B6 AAFE CCA8 CC3A CBFE CA4C CB92
D50E AC3E ABFC B91E BD04 BE48 BEE6 C262
BA4C 0800 AFEC 0900 AFB0 0A00 AF7E 0B00
AF9A 8100 B05A 8200 AE66 8400 B090 0600
B090 0F00 EE38 0200 AA20 8800 B07E 8E00
AE88 0D00 AE88 9000 B09C 9200 AF52 9700
AEBA 0000 A33D 0017 000A A354 0010 005A
A519 0016 00AD A52F 0016 00FD A4B1 0027
01E1 A4D8 0025 0231 A4FD 001C 0286 A5CF

SOF = Starting Sector
SOF (EOF = Ending Sector)
Drive 1 Sector # 0026 Byte 0 >00











DSKU V 4.2 REF Page 3 of 6
..

FIGURE 5 - FIND STRING - ASCII (screen display)

Find String
========================================
. . . . . . ` . . . . . . . .
. . . . P I O

. . . . . . . . . . . . . . . .
. . . . . . . . D S K 1 . C H A
R A 1 . . . . . . @ . . . . . .
. . . . . L . . . . . J . D . .
. x . . . . . . . : . . . L . .
. . . > . . . . . . . H . . . b
. L . . . . . . . . . . . ~ . .
. . . . . Z . . . f . . . . . .
. . . . . 8 . . . . . . ~ . .
. . . . . . . . . . . . . R . .
. . . . . = . . . . . T . . . Z
. . . . . . . / . . . . . . . '
. . . . . % . 1 . . . . . . . .


E)dit R)eplace C)ontinue Q)uit E

SOF Sector 2 <-- Sector # in file (File Find
Drive 1 Sector # 0026 Byte 72 >48 String Only)


Note: On the screen, all occurrences of the search string
are high-lighted (shown in inverse video).



FIGURE 6 - FILE COMPARE (output to screen)


File Compare
========================================
Filename UTIL1C

Drive 1
To

Filename UTIL1C

Drive 2


--> 01E1/00D3


Enter to Continue

--> : 01E1/00D3 are the non-matching sectors of file UTIL1C, with
>01E1 located in drive 1 and >00D3 in drive 2. Up to 40 non-
matches can be displayed.

Note: 'Compare Disks' uses the same display format if output to
screen is selected.

DSKU V 4.2 REF Page 4 of 6
..

FIGURE 7 - DISK INITIALIZATION



a) Used (previously initialized) disk


Initialize Disk
========================================

Drive 1 Files 7

Total Sectors 1438 Free Sectors 1183

Sides (S/D) D Density (S/D/Q) D

Diskname DSKU4.2 Date 04/25/88


CAUTION : INITIALIZATION ERASES ALL DATA
STORED ON THE DISK!



b) New (blank) disk


Initialize Disk
========================================

Drive 1 Files

Total Sectors 1438 Free Sectors 1438

Sides (S/D) D Density (S/D/Q) D

Diskname Date ________





Note: After information has been entered,
a prompt (Y/N) to validate the disk's
sectors will be displayed.















DSKU V 4.2 REF Page 5 of 6
..

FIGURE 8 - DISK REPORT (print-out, compressed mode)


. .l.
Diskname DSKU4.2 Total Sectors 1438 Free Sectors 1183 Date 04/25/88 Files 7
--------------------------------------------------------------------------------
Sector
Filename File Type Size FDR Start End Pro Comment
--------------------------------------------------------------------------------
*READ-ME D/V 80 7 0002 0022 0027 No General Information
CHARA1 PGM 1024 5 0003 0028 002B No True lowercase character set
DSKU/DOCS D/V 80 104 0004 002C 0092 No Documentation file
DSKU/REF D/V 80 49 0005 0093 00C2 No Illustrations
DSKU1 PGM 8192 33 0006 00C3 00E2 No V 4.2 part 1
DSKU2 PGM 8192 33 0007 00E3 0102 No V 4.2 part 2
DSKU3 PGM 5768 24 0008 0103 0119 No V 4.2 part 3

. .l.

Note: FDR = sector location of File Descriptor Record.
Mutliple start/end sectors signify that a file is fractured.



FIGURE 9 - DIRECTORY/COMMENT (screen display)



Directory/Comment 1/2
========================================
DSKU4.2 Files 7 Date 04/25/88
Total Sectors 1438 Free Sectors 1183
Filename Size File Type Pro
========================================
1 *READ-ME 7 D/V 80 No
General information________________

2 CHARA1 5 PGM 1024 No
True lowercase character set_______

3 DSKU/DOCS 104* D/V 80 No
Documentation file_________________

4 DSKU/REF 49 D/V 80 No
Illustrations______________________

5 DSKU1 33 PGM 8192 No
V 4.2 part 1_______________________


Enter to Continue or 1-5 to Update


Note: An asterisk after 'Size' signifies a fractured file.






DSKU V 4.2 REF Page 6 of 6

UPDATE

 

****************************
* *
* UPDATE INFORMATION *
* *
* FOR DISK UTILITIES *
* *
* Version 4.12 *
* *
* John Birdwell *
* 1310 Kent Court *
* Wheaton, IL 60187 *
* *
****************************


NOTE:
A special verson of Disk Utilities (4.12M) is available for use with
the Myarc Disk Controller. This is required to format a DS/DD disk
to 1440 sectors. If you are utilizing this program with either a
Geneve 9640 or have the 80 track Eprom installed in your disk
controller this version is not needed. If you are in need of this
version please indicate when requesting this program.


VERSION 4.12 CHANGES

1. File Utilities

a) File Ops

Added - (E)dit Option
Selecting E will enter the File Sector Editor.
Changed - (D)elete Option
If the file is protected, D will not be accepted.
Changed - (P) Option
Selecting P option will override a previously selected
delete.
Changed - (V)iew Option
View now displays any size Dis/Fix or Dis/Var file and
output can be directed to screen or printer.

b) Find String

Changed - Shows sector number wher match was found in respect to
the file as well as the disk sector number.

2. Disk Manager

Added - Copy (Bitmap)
Transfers all used sectors from source to copy disk.
Added - Reset Disk
Sets a previously initialized disk to its initialized
state without formatting.
Changed - Copy (Backup/Bitmap)
Skips disk initialization if destination disk is
formatted same as source disk.

3. Disk Utilities

Deleted - Setup Myarc Ramdisk

DSKU V4.12 Update Page 1 of 2
..

4. Sector Utilities

Added - Copy Sectors
Copies a range of sectors to another disk.
Added - Mark Sector
Marks a sector as used in the Volume Information Block.
Added - Free Sector
Marks a sector as unused in the VIB.

5. System Setup

Added - Printout size for File print
Changed - Printout Size Selections
N - Normal.Sets normal pica print mode.
C - Compressed. Sets compressed mode.
S - Special. Set any mode (see Special Print Code below).
Added - Special Print Code
Enter hex string (up to 20 characters) to set printer up
for any mode chosen by you. May include margin settings,
super-script or whatever.

NOTE: Output to the printer is always preceeded by a reset command before
other commands are sent. Except for the Special Print Mode, the
proper codes for standard pica, compressed and reset must be set
by editing sector 1 of file DSKU1. Defaults for those are set
for OKIDATA. See doc for default locations.

7. Load FW

Added - Return to Funnelweb's UTIL1 file (any drive).


OTHER CHANGES

Added - Support for GRAND RAM drives A-Z

Sector/File Editor

Added - Insert Key (FCTN/2)
Inserts a null (if in hex) or a space (if in Ascii) at the
current cursor position and drops the last character of the
sector being edited.
Added - Delete Key (FTCN/1)
Deletes the character at the current cursor location and
adds a null (hex) or space (ASCII) at the end of the sector.
Changed - Character highlighting
As characters are changed (edited), spaces between them are
highlighted also to aid in identification.

All Modes except during sector edit

Added - CTRL/D: Decimal-to-hex convertor
CTRL/H: Hex-to-decimal convertor
Either key toggles into the convertor mode with a blinking
cursor displayed near the bottom of the screen. Depending
on which mode was selected, enter a hex or a decimal number
and see its equivalent shown to the right. Pressing the
same control key again returns to point of orgin in the
program.

DSKU V4.12 Update Page 2 of 2

[+Schmitzi]

.

Hi,

 

maybe somebody has the 4.2 for me ? I only have 4.12..... Didn´t know about 4.2....(?) Is it from John Birdwell?

Or did I just not recognize that there exists a 4.12-DSK-file which contains the 4.20, and I am working with an old version ?

Since some month, I am making PDFs from all this /DOCs, coming from inside the DSK-files, but 4.1.2 was "too old" to post here, I thought

 

PS: And the 4.12M-version for my MyArc-controllers would be very nice
Edit2: Found an 42-ARK-file on my Geneve-HDD. Will play around

and, 4.2G, is it newer version "G" or german maybe ? (As there was a german version 3.31 of DSKU)

 

thx

xXx

Edited January 26, 2016 by schmitzi

[+Schmitzi]

.

ah OK, so I made a PDF from it now -I will post more if I find more, have to review 4.2 now

thx

 

DSKU420-DOCS--RMS01.pdf

 

(but I think it is the same as sparkdrummer posted here before)

[sparkdrummer]

Here you go - docs on dsk.

 

DISKU42.DSK

 

 

[+Schmitzi]

.

hmm, I have another version, with 2 programs. HexEdit tells me the 4.2 with an DSK6.-entry (your one here has DSK1 there, instead, maybe for RAMdisk)

AND it shows me an additional version 4.2M on it. I think this is the MyArc-version.

I try to check and compare that tonight

[+Schmitzi]

.

OK. There are 2 versions I found: 4.2 (from Sparkdrummer too, in V9T9-format) and a 4.2 including 4.2M (in PC99-format)

 

If I start "my" PC99-DSK (with the 4.2M in addition on it) in Classic99, then it stops after the loader,showing me an @-sign.

But it seems to run, blind only, as I can Press "Enter" for start + "6" for Exit" + "Enter" for Yes and the TI reboots proper.....

Very strange. If I start XB and press F4 to stop LOAD, I can OLD DSK1.LOAD/M for the 4.2M-version for MyArc-Controllers. This works fine...

So maybe the BlueScreen with the @ is a third version, withut GPL-Routines, for the Geneve ??? Or just on error on the Disk ?

 

Now I need to know if there are 3? versions of DSKU4.2, to differ and name that correct.

If this disk isn´t defective, so there are maybe 3 versions ?

1.) 4.2 for TI

2.) 4.2M for MyArc-FD-Controller (Geneve or TI ??)

3.) 4.2 for Geneve (without GPL-Routines) ?? -> or: just a defective disk ??

 

So I made a new DSK now, which loads 4.2 in XB (I just took the DSKU1-3-files from sparkdrummers DSK

and also holds the DSKUM1-4 files for MyArc-version (MyArc-Controller, NOT MyArc Geneve if I understand correct)

If this is correct, and there does not exist a "Geneve-version DSKU4.2 without GPL due to this was in 4.12 only maybe)

then all is correct. Otherwise I just have to step back to keep that @-version too

Maybe somebody knows about.....

 

"Non-Working" : -removed-

 

Working 4.2: -removed-

 

(Press F4 to interrupt LOAD (XB) and the LOAD DSK1.LOAD/M for the MyArc-version

 

Pls let me know, so that I have the chance to remove my wrong, "fiddled" OK-file from here

 

I think I have to check that @-version on my Geneve later

[+Schmitzi]

yes, on the Geneve this version runs, so there seem to be 3 versions of DSKU 4.2

I have removed this fiddle-file now

[atrax27407]

Thanks for all of the responses.

[Omega-TI]

.

ah OK, so I made a PDF from it now -I will post more if I find more, have to review 4.2 now

thx

 

DSKU420-DOCS--RMS01.pdf

 

 

 

Linked << HERE >>

[+Schmitzi]

.

ah, nice You can remove this "RMS01" from the file if you like, because this is my internal revision-nr. only

(Maybe I will reformat some of this DSK-PDF-docs later, so there may be a version 02 (but without any changes to contents))

 

I made a small XB-menu for the GPL-version and the M(yarc)-Version on one disk,

so you can choose which version to load at boot. Seems to work.....

I hope I did not destroy anything

 

 

DSKU4.2+M+Menue.dsk