User's Level

(1)

BFISD 5084

Basic Four

^@

Level 4 Utilities

User's Guide

(2)

The information contained herein is proprietary to and considered a trade secret of Management Assistance Inc.

recorded or stored in a retrieval system, or transmitted, in any form or by any means, whether electronic, mechanical, photographic, or otherwise, without prior written permission of the Basic Four Information Systems Division of Management Assistance Inc.

SF/SD 5084

All specifications are subject to change without notice.

Basic Four and MAl are registered trademarks of Management Assistance Inc.

Printed in the United States of America

Basic Four Information Systems Division/Management Assistance Inc.

14101 Myford Road, Tustin, California 92680/(714) 731-5100

(3)

BASIC FOUR LEVEL 4 UTILITIES

USER'S GUIDE

BFISD 5084

(4)

(5)

TABLE OF CONTENTS

Page SECTION 1 - INTRODUCTION

Overview. ⁰ ^{• • •}^e ⁰ ^{e o} • • • • • • • • • • • • • • 1-1

Sea pe • ⁰ ⁰ ^• ^G ^C ^• ^• ^ct ^• ^• ^• ^• ⁰ ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 1-1

Contents . . ⁰ ^{• • • 0} • • • " • • • • • • • • • • • • 1-1 Related Publications. ^e ⁰ ⁰ • • • • • • • • • • • • • 1-2 Conventions . ⁰ ^• ^• ^• ⁰ ^• ⁰ ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ⁰ ^• ^• 1-2 Definitions of Terms. . . ⁰ ^• ^• ^• ⁰ ^• ^• ^• ^• ^• ^• ^• ^• ^• 1-3 SECTION 2 - STANDARD UTILITY PROCEDURES

Overview. ⁰ ^• ^• ^• ^• ⁸ ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 2-1 Accessing the Level 4 Utilities . . • • . • • • • . . 2-1 Assigning Memory. ⁰ ^{• •} ⁰ • • • • • • • • • • • • • 2-1 The Main Menu . . . ⁰ ⁰ ^• ⁰ ^• ^• ^• ^• ^• ^• ^• ^• ^• 2-1 Accessing a Utility Group ^e ⁰ ⁰ ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 2-2 Selecting Parameters . . . • . . . ⁰ ⁰ ^• 2-3 Control Key Functions . • . . . • • . • . . . 2-3 Carriage Return and Control Bar I . . . • . . • . • 2-4 Control Bar II. . . • . • . . . • . • . . . • 2-4 Control Bar III ⁰ ⁰ ⁰ ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 2-4 Control Bar IV. . . ^{e o . •} ^• ^• ^• ^• ⁰ ^• ^• ^• ^• ^• ^• ^• 2-4 Escape Key. . . ⁰ ⁰ ^• ⁰ ^.. ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 2-4 Question Mark . • . . . . ^G ^• ^• ^• ^• ^• ^• ^• ⁰ ^• ^• ^• ^• 2-4 Output Devices • . . . " ⁰ ^• ⁰ • • • • • • • • • • • • 2-5 Parameter File. ⁰ ^• ⁰ ^.. ^• ^.. ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 2-5 SECTION 3 - DISC UTILITIES

Overv iew . . . ^Q ⁰ ^• ^• ^• ^e ^• ⁰ ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 3-1 Accessing the Disc Utilities . • ⁰ • • • • • • • • • • 3-1 Display Directory utility ^Q ^• ^• ^• ^• ^• ^~ ^• ^• ^• ^• ^• ^• ^• 3-3

Purpose of the Utility. ⁰ ⁰ • • • • • • • • • • • • 3-3 How to Use the Utility . . • · · · · . ⁰ ^• ^• ^• ^• ^• ^• 3-3 Effects of the Utility. • ⁰ ^• ⁰ ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 3-6 Display/Edit Sectors Utility . • ⁰ ⁰ • • • • • • • • • 3-8 Purpose of the Utility. ^a ⁰ • • • • • • • • • • • • 3-8 How to Use the Utility . . . . • . • . . • • • ⁰ ^{• •}3-8 Effects of the Utility . . . • . . . • • . • . • 3-13 Copy Sectors Utility_ . . • • • • . . . • • • . • . • 3-15 Purpose of the Utility . . • . . • . • . • • • • . • 3-15 How to Use the Utility. ⁰ ⁰ • • • • • • • • • • • • 3-15 Effects of the Utility . . . • . . • . . • . . . 3-17 Maintain Directory Utilitye ⁰ • • • • • • • • • • • • 3-18 Purpose of the Utility • . . . • . • . . • • • • . • 3-18 How to Use the Utility • . • • . ⁰ • • • • • • • • • 3-18 Maintain Gap File Utility . • . . . . • • . • • . • . 3-23 Purpose of the Utility . . . • . . • . . 3-23 How to Use the Utility . . . . • . . . • . . • . • • 3-23 Effects of the Utility. . • . . . • . • • • . • 3-24

(6)

Page SECTION 3 - DISC UTILITIES, Cont.

Change Disc ID/Label Utilityo ⁰ ⁰ ^{• •} ^e ⁰ ⁰ ^{• •} ⁰ ^{• •}3-27 Purpose of the Utility. • ⁰ ⁰ ^• ^• ^• ^- ^• ^• ⁰ ^• ^• ^• ⁰ 3-27 How to Use the Utility •• ⁰ • • • • 0 • • • • • • • 3-27 Compact Disc Utility • • • • ⁰ • • • • • • • • • • • • 3-29 Purpose of the Utility •• ⁰ ⁰ ⁰ • • • • 0 • • • • • 3-29 How to Use the Utlity • • . • ⁰ ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 3-29 Effects of the Utility. ⁰ ⁰ ^{• •} ^e ⁰ ⁰ ⁰ • • • • 0 • 3-31 Error Analysis/Repair Utility . . ⁰ ^• ^• ^• ^• ^• ^• ^• ⁰ ^• 3-33

Purpose of the Utility • • • • • • • • • • • • • • • 3-33 How to Use the Utility • . • ⁰ ^• ⁰ ⁰ ⁰ • • • • • • • 3-33 Effects of the Utility • • • ⁰ ⁰ ⁰ ^{• •} ⁰ • • • • • • 3-36 Disc Backup Utility ⁰ ⁰ ^• ⁰ ^• ⁰ ^{• •} ⁰ • • • • • • • • 3-41

Purpose of the Utility • • • • ⁰ ⁰ ⁰ • • • • • 0 • 0 3-41 How to Use the Utility •• ^{e o} • • • • • • • • • • • 3-41 Effects of the Utility. • ^{e o . •} ^• ⁰ ^• ^• ^• ⁰ ^• ⁰ ⁰ 3-43 SECTION 4 - FILE UTILITIES

Overv i ew ⁰ ^• ^" ⁰ ^{e o .} ⁰ ^• ^• ⁰ ^• ^• ⁰ ^• ^• ^• ^• ^• ⁰ ^• ⁰ ^• 4-1 Accessing the File Utilities. • ^e ^.. ^G ^.. ^{e o . •} ^• ^• ^• 4-1 Rename Utility" ⁰ ⁰ . . . 0 . . . . 0 . . . 4-3

Purpose of the Utility" ⁰ ⁰ . . . 0 . . . 4-3 How to Use the Utility ... ⁰ ^{. . .} ⁰ ⁰ ^{• • • .}⁰ . . . 4-3 Effects of the Utility • . ⁰ . . . 4-3 Erase Utility ê ^.. ⁰ ^.. ⁰ ^• ^& ⁰ ^.. ⁰ ⁰ ^.. ^• ^.. ⁰ ^• ^• ^• ^.. ^.. 4-4 Purpose of the Utility. ê ^• ⁰ . . . 4-4 How to Use the UtilitYe ⁰ ^.. ⁰ ê . . . 4-4 Effects of the Utility ... ⁰ ⁰ ^{. . .} ⁰ . . . 4-4 Move Utility . . . ⁰ ^Q ^• ⁰ . . . 0 .4-5

Purpose of the Utility. ⁰ . . . 4-5 How to Use the Utility ... ⁰ . . . 4-5 Copy Utility . . . . ⁰ ^.. ⁰ ^.. ⁰ . . . 4-9 Purpose of the Utility . . . 4-9 How to Use the Utility.. ⁰ ^.. ^.. ^.. ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 4-9 Compare Utility ⁰ . . . 0 . . . 0 • • • • • 0 • • 4-13

Purpose of the Utility. ⁰ • • • • • • • • • • • • • 4-13 How to Use the Utility •• ⁰ ^• ⁰ • • • • • • • • • • 4-13 Effects of the Utility • • • ^Q ^• ⁰ • • • • • • • • • 4-14 File Analysis/Repair Utilityo ⁰ ^G ^• ^" • • • • • • • • 4-17 Purpose of the Utility •• ^e ^Q • • • • • • • • • • • 4-17 How to Use the Utility • • . • ⁰ ⁰ ⁰ • • • • • • • • 4-17 Effects of the Utility • • • ^e ^{• •} ⁰ • • • • • • • • 4-18 Examine Data/Keys Utility . . • . . • • • • • • • • • 4-23 Purpose of the Utilityo . • ^{e o} • • • • • • • • • • 4-23 How to Use the Utility. ⁰ ^• ⁰ ^• ⁰ ^{• •} ⁰ • • • • • • 4-23 Effects of the Util i ty. ⁰ ⁰ ⁰ ⁰ ^C ^• ^• ^• ^• ^{• • •} ^• ^• ^• 4-24 Sort Utility . . • • . . • ⁰ ^• ⁰ • • • • 0 • • • • • • 4-26 Purpose of the Utility. .. • • • • • • . • • • . • • 4-26 How to Use the Utility. ⁰ ^• ⁰ ^{e o . •} ^• ^• ^• ^• ^• ^• ^• 4-26 Effects of the Utility • • • ⁰ • • • • • • • • • • • 4-33

(7)

Page SECTION 5 - FILES UTILITIES

Overv iew ^Q ^G ^.. ^e ^G ^• ^• ^.. ^.. ⁰ ^.. ⁰ ⁰ ^• ^• ^• ^• ^• ^• ⁰ ^• ^• ⁰ 5-1 Accessing the Files Utilities . • ⁰ ^.. ^.. ^• ⁰ ^• ^• ^• ^• ^• 5-1 Define Utility.. ⁰ ^.. ^.. ^• ^• ^.. ⁰ ^• ^• ⁰ ^• ^• ⁰ ⁰ ^• ^• ^• ^• ^• 5-2

Purpose of the Utility . . . . ⁰ ê ⁰ ⁰ ^• ⁰ ^{• • • 0} ^{• •}5-2 How to Use the Utility. ⁰ ^.. ê ^• ⁰ ^• ⁰ ⁰ • • • • • • 5-2 Erase Utility ê ^.. ^.. ⁰ ^.. ⁰ ^• ⁰ ^• ^• ^• ^• ^• ⁰ ^• ⁰ ^• ^• ^• ^• 5-5 Purpose of the Utilitye ⁰ ^{• •} ⁰ ⁰ • • • • • • • • • 5-5 How to Use the Utility" ... ⁰ ⁰ ^• ⁰ . . . 5-5 Effects of the Utility. ⁰ ^.. ⁰ . . . 0 • • • 5-7 Move Utility.. .. ⁰ ^.. ^• ^.. ^• ^• ⁰ ^• ⁰ ^• ^• ^• ⁰ ^• ^• ^• ^• ⁰ ^• 5-8 Purpose of the Utility. ⁰ ^• ⁰ . . . 5-8 How to Use the Utility . . . . ⁰ • • • • • • 0 • • 0 0 5-8 Effects of the Utility .. ^G . . . 0 • • 5-10 Copy Utility ⁰ ⁰ ^.. ^.. ^• ^• ^• ⁰ ⁰ ^• ^.. ^• ^• ^.. ^• ^• ^• ^.. ^.. ^• ^.. 5-12 Purpose of the Utility. ^G ^.. ê ê . . . 5-12 How to Use the Utility_ .... ^& . . . 5-12 Effects of the Utility ... ⁰ ^.. ⁰ ^.. ê . . . 5-14 Compare Utility ... ê ⁰ ê . . . 5-15 Purpose of the Utility . . . 5-15 How to Use the Utility . • • ⁰ ⁰ . . . 5-15 Effects of the Utility . . . 5-17 Maintain Filelist Utility ⁰ ^.. ⁰ . . . 5-18 Purpose of the Utility ... ⁰ . . . 5-18 How to Use the Utility . . . . ⁰ . . . 0 • • 5-18 Effects of the Utility ... ⁰ . . . 5-21 SECTION 6 ⁼ PROGRAM UTILITIES

Overview.. .. . .. ^{e o . .} ^• ^• ⁰ ^.. ^.. ⁰ ^.. ^• ^• ^• ^• ^• ^• ^• ^.. ^• 6-1 Accessing the Program Utilities . . . 6-1 Define Program Files Utility . . . 6-2

Purpose of the Utility . . ⁰ ^• ^{e o} . . . e 6-2 How to Use the Utility. ⁰ ^• ⁰ ^• ^$ • • • • • • • • 0 6-2 Cross Reference Programs Utility . . . . ⁰ • • • • • 0 0 6-5 Purpose of the Utility. ⁰ ⁰ ⁰ ^{• • • 0} • • • • • 0 • 6-5 How to Use the Utility. ⁰ ^• ⁰ ^{• •} ⁰ • • • • • • • • 6-5 Effects of the Utility. ⁰ ⁰ • • • • 0 • • • 0 • • • 6-7 Display First Statement Utility ^G ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 6-11

Purpose of the Utility. ê ⁶ ^• ⁰ ^{• • • •}ê • • • • • 6-11 How to Use the Utility . . . ⁰ ^{e o} ^{• •} ⁰ • • • • • • 6-11 Effects of the Utility. ⁰ . . . 6-13 String Search and Replace Utility ⁰ ^• ^• ^• ^• ^• ^• ^• ⁰ ^• 6-14 Purpose of the Utility. ⁰ ⁰ . . . 6-14 How to Use the Utility ... ⁰ ⁰ ⁰ • • • • • • • • • • 6-14 Effects of the Utility. ⁰ ⁰ • • • • • • • 0 • • • • 6-17 Compare Programs Utilityo ⁰ ^• ⁰ • • • • • • • • • • • 6-19 Purpose of the Utility . . • . ê ^{• •} ⁰ • • • • • • • 6-19 How to Use the Utility . . . ⁰ ⁰ • • • • • • • • 6-19 Effects of the Utility. ⁰ • • • • 0 • • • • • • • • 6-21

(8)

Page SECTION 6 - PROGRAM UTILITIES, Cont.

Renumber Program Utility . . . 6-22 Purpose of the Utility. .. • • .. .. ^II ^• ^• ^.. ^.. ^• ^• ^• ^• 6-22 How to Use the Utility .... ^II . . . e .. 6-22 Effects of the Utility. • • • • • • • • • • • • • .. 6-24 Merge Program Files Utility • .. .. .. • • .. .. . .. • • • 6-26 Purpose of the Utility . . . 6-26 How to Use the Util it y. • • .. .. • • " • • .. • • • .. 6-26 Effects of the utility. .. • .. • .. .. .. • • • • .. • .. 6-27 SECTION 7 - SYSTEM L~ILITIES

Overview . . . ⁰ . . . 7-1 Accessing the System Utilities . . . " . . . . 7-1 Set Date and Time Utility ê ^.. ^• ^" ^.. ê ^.. ^.. ^• ^.. ^.. ê ^.. ^• 7-2

Purpose of the Utility.. .. .. • " • .. • .. • .. • .. .. .. 1-2

How to Use the Utility. .. • • .. .. . • • • ⁰ ^• ^• ^.. ^• 7-2 Display Configuration Utility " • . .. • .. .. .. • .. • • 7-3 Purpose of the Utility ^G ^.. ^" . . . " . . . " . . . 7-3 How to Use the Utility" .. • ê ^.. ^• ^.. â ^• ^• ^• ^" ^.. ^• ^• 7-3 Effects of the Utility. ⁰ . . . 7-3 Display Memory/Device Usage Utility • .. • • • .. . .. .. 7-5 Purpose of the Utility. ⁰ ^.. ^.. ^.. ^• ^• ^.. ^.. ^• ^" ^.. ^• ^• ^& 1-5 How to Use the Utility. .. .. ⁰ ^• ^.. ^.. ^• ^• ^{• .}ê ^.. ^• ^• ^.. 7-5 Effects of the Utility. ⁰ ^.. ê . . . Q e 7-5 Set Printer VFU Utility ^{G O G} ^.. ^.. ^• ^~ ^" ^• ^.. ^• ^• ⁰ ^.. ^• 7-8 Purpose of the Utility ... ⁸ . . . 7-8 How to Use the Utility. ⁰ ^• ^" . . . s • ~ ^• 1-8 Effects of the Utility.. .. • • .. " " • • .. • • " .. .. 7-9 BOSS Update Utility . . . 7-10

Purpose of the Utility . . . 7-10 How to Use the Utility. .. • • .. • • • .. • • • • • • 7-10 Effects of the Utility. ^{e o} . . . 7-11 Ghost Communication Utility •• " • • • ⁰ . . . 1-12

Purpose of the Utility. ⁰ . . . 0 • G • 7-12 How to Use the Utility. .. • • .. • .. • • .. • .. .. • .. 7-12 Set Parameter Defaults Utility . . . ~ " •• 7-14 Purpose of the Utility . . . ⁰ . . . 0 7-14 How to Use the Utility. ⁰ . . . " . . . " . . . 7-14 Spooling Control Utility. ⁰ ^• ⁰ ^• ^• ^• ^.. ^• ^• ^• ^• ^" ^• ^• 7-20 Purpose of the Utility. e o . . . 7-20 How to Use the Utility.. .. • • ^e ^.. ^.. ^• ^• ^• ^• ^• ^• ^• ^• 7-20 SECTION 8 - INFO UTILITY

Overv iew .. .. • ^Q ^" ^• ^{. .} ^{. .} ^• ^{. .} ^• ^• ^• ^• ^• ^• ^• ^• . . . • . . e 8-1 Accessing the Info Utility. ^D ^.. ^• ^• ^• ^• ^• ^• ^• ^• ^e ^• ^• ^8~1 How to Use the Info Utility . . • ⁰ . . . 0 • 8-1

(9)

SECTION 9 - UTILITY TOOLS Overview. . • • • • The Utility Tools • Requirements. • •

*ALOC • • • • • •

*CGAP . . . . • •

*DEFx • . • • • •

*ERAS • • • • • •

*FREE • • • • • •

*GAPS • • • • • •

*SPAC • • • • • •

*UFREE. • • • • •

• • •

SECTION 10 - ERROR HANDLING

•

Overv iew • • . • ⁰ ^• ^• ^• ^• ^• Error Handling Procedures •

Non-Resolvable Errors • • Resolvable Errors . • • •

• • •

• • • •

• • • ^•

• • • •

• •

Page

• 9-1

· 9-2

· 9-3

· 9-4

· 9-5

• 9-6

· 9-7

· 9-8

· 9-9

.10-1

.10-1 .10-1

.10-1

(10)

Figure 2-1 2-2 3-1 3-2 3-3 3=4 3-5 3-6 3-7 3-8 3-9

~-10

oJ

3-11 3-12 3-13 3=14 3-15 3-16 3-17

3~18

3-19 3-20 3-21 3-22 3=23

3~24

4=1 4-2 4=3 4-4 4-5 4-6 4-7 4-8 4-9 4-10 4-11 4-12 4-13 4=14 4-15 4-16 4-17 4-18 4-19 4-20

LIST OF FIGURES

Page Level 4 UTILITIES Main Menu ⁰ ⁰ ^{G O O} ⁰ ^• ^• ^• ^• 2-2

DISPLAY DIRECTORY Option Groups . . • ⁹ ⁰ ⁰ ^• ^• 2-3 Disc Roster and DISC UTILITIES Group Menu ⁰ ⁰ ê 3-2 DISPLAY DIRECTORY Option Screen ^Q ⁹ ⁰ ⁰ ⁹ ^• ⁰ ^• 3-3 Listing of Selected Program Files by Mask ⁰ ⁰ ^Q 3-5 DIRECTORY DISPLAY of Files by Location . . ê ⁰ ⁰ 3-6 DIRECTORY DISPLAY of Free Sectors ⁰ ⁰ ^Q ^G ê ⁰ ⁰ 3-7 DISPLAY/EDIT SECTORS Utility Option Screen. ⁰ ^• 3-8 EDIT SECTORS Screen Display ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ^• ⁰ ⁰ ^• 3-11 DISPLAY/EDIT SECTORS Screen Display ⁰ ~ ⁰ ⁰ ⁰ ^• 3-13 COpy SECTORS Utility Option Screen. ⁰ ⁰ ^• ⁰ ⁰ ⁰ 3-15 MAINTAIN DIRECTORY Menu ⁰ ⁰ ⁰ ^{c e o} ⁰ ⁰ ⁰ ^• ⁰ ⁰ 3-18 INITIALIZE DIRECTORY/DISC Option Screen ^G ⁰ ê ⁰ 3-19 MAINTAIN GAP FILE Utility Option Screen ⁰ ⁰ ⁰ ⁰ 3-24 MAINTAIN GAP FILE Display of Free Sectors ê ⁰ ^Q 3-25 Distribution Graph of Free Sectors on Disc. ê ê 3-26 Disc ID and Label Information ⁰ ⁰ ⁰ ⁰ ^{G a G} ⁰ ⁰ 3-27 COMPACT DISC Utility Option Screen . . ^Q ê ⁰ ⁰ ^• 3-29 COMPACT DISC utility Printout ⁰ ⁰ ⁰ ^{G O O} ⁰ ⁰ ⁰ 3-32 ERROR ANALYSIS/REPAIR Utility Option Screen ⁰ ^• 3-33 Display of EXAMINE DIRECTORY in BRIEF ê ⁰ ⁰ ⁰ ⁰ 3-37 Scatter Index Table Analysis. ⁰ ⁰ ⁰ ⁰ ^Q ^• ⁰ ^• ⁰ 3-38 Key Area Analysis Table ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ^• ⁰ 3-38 Removed Keys Analysis ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ^• ⁰ ⁰ ⁰ 3-39 Sector Error Analysis ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ 3-40 DISC BACKUP Utility Option Screen ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ 3-41 File ID and FILE UTILITIES Group Menu ⁰ ⁰ ⁰ ⁰ ⁰ 4-2 MOVE Utility Option Screen ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ 4-5 File Roster for NEW SIZE Option (MOVE)o ⁰ ⁰ ⁰ ⁰ 4-7 COpy Utility Option Screeno ⁰ ⁰ ⁰ ê ⁰ ⁰ ⁰ ⁰ ⁰ ^• 4-9 File Roster for NEW SIZE Option (COpy). ⁰ ⁰ ^• ⁰ 4-11

COMPARE Utility Option Screen ⁰ ⁰ ⁰ ⁰ ⁰ ⁰ ^• ⁰ ^.. 4-13 COMPARE FILES Display==Program Fileso ⁰ ⁰ ⁰ ^{• •}4-14 COMPARE FILES Display==Indexed Files. ⁰ ^• ⁰ ⁰ ^• 4-15 COMPARE FILES Display==Direct Files . ⁰ ^• ⁰ ⁰ ^• 4-16 FILE ANALYSIS/REPAIR utility Option Screen. ⁰ ^• 4-17 Display of FILE ANALYSIS/REPAIR in BRIEF . . ⁰ ^• 4-20 Scatter Index Table Analysis. ⁰ ⁰ ⁰ ⁰ ⁰ ^~ ^G ^e ⁰ 4-21 Key Area Analysis Table ⁰ ⁰ ⁰ ⁰ ^{G O .} ⁰ ⁰ ^• ^• ^• 4-21 Removed Keys Analysis ⁰ ⁰ ⁰ ⁰ ^{G O O} ^• ^• ^• ⁰ ⁰ ^• 4-22 EXAMINE DATA/KEYS Utility Option Screen ⁰ ^• ^• ⁰ 4-23 EXAMINE DATA/KEYS Display of Data ⁰ ^• ⁰ ⁰ ⁰ ^• ⁰ 4-25 EXAMINE DATA/KEYS Display of Keys. ⁰ ^{• • 0} ⁰ ⁰ ^• 4-25 SORT Utility Option Screen ⁰ ⁰ ⁰ ⁰ ^• ⁰ ^• ⁰ ^• ⁰ ^• 4-26 Defining a SORT Key by Record Fields. ⁰ ⁰ ⁰ ⁰ ^• 4-30 Defining a SORT Key by Byte Offset. ⁰ ⁰ ⁰ ⁰ ⁰ ^e 4-31

(11)

Figure 5-1 5-2 5-3 5-4 5-5 5-6 5-7 5-8 5-9 6-1 6-2 6-3 6-4 6-5 6-6 6-7 6-8 6-9 6-10 6-11 6-12 6-13 6-14 6-15 6-16 7-1 7-2 7-3 7-4 7-5 7-6 7-7 7-8 7-9 7-10 7-11 7-12 7-13 7-14 7-15 7-16 7-17 7-18 7-19 8-1 8-2

Page FILES UTILITIES Group Menu. ^{e o} • • • • • • • • 5-1 DEFINE FILES utility File Roster . • . • . • ⁰ ^• 5-2 ERASE FILES Utility Option Screen • • • • . • • 5-5 MOVE FILES Utility Option Screen • • . • • • • . 5-8 COpy FILES Utility Option Screen . • ⁰ • • • • • 5-12 COMPARE FILES Utility Option Screen . • • • • • 5-15 MAINTAIN FILELIST Utility Option Screen . . • • 5-18 DISPLAY FILELIST . . . ⁰ ⁰ • • • • • • • • • • • 5-21 FILELIST INVENTORY Display. • . . • • • . . 5-21 PROGRAM UTILITIES Group Menu • . . . • . • • 6-1 DEFINE PROGRAM FILE Roster . • ⁰ • • • • • • • • 6-2 CROSS REFERENCE PROGRAMS Option Screen . • . • • 6-5 Listing of Numeric Variables. ⁰ • • • • • • • • 6-8 Listing of String Variables • ⁰ ^• ^• ^• ^• ^• ^• ^• ^• 6-8 Listing of Arrays, Functions and

System Variables. . • . . • • • • ⁰ ^• ^• ^• ^• ^• 6-9 Listing of Statement Numbers. ⁰ ^• ⁰ • • • • • • 6-9 Listing of Directives . . • . ^e ^• ⁰ ^.. ^• ^.. ^• ^• ^• 6-10 DISPLAY FIRST STATEMENT Option Screen . • • . • 6-11 DISPLAY FIRST STATEMENT Display ⁰ ⁰ • • • • • • 6-13 STRING SEARCH & REPLACE Option Screen . . • • . 6-14 STRING SEARCH & REPLACE Report . • • • . • ⁰ ^{• •}6-17 COMPARE PROGRAMS Utility Option Screen • . • . ⁰ 6-19 COMPARE PROGRAMS Display . . . 6-21 PROGRAM RENUMBER Utility Option Screen . • . • • 6-22 MERGE PROGRAM FILES Utility Option Screen . . . 6-26 SYSTEM UTILITIES Option Screen. ⁰ • • • • • • • 7-1 DISPLAY CONFIGURATION Utility Option Screen • . 7-3 SYSTEM CONFIGURATION Display . . ⁰ ⁰ • • • • • • 7-4 MEMORY/DEVICE USAGE Display of Bank

Allocation. . . .. . ⁰ ^• ^• ⁰ ^C ^• ^• ^• ⁰ _• • • • 7-6 MEMORY/DEVICE USAGE Display of Tasks,

Devices and Discs . • • • . • • . • • • . . • 7-7 SET VFU Utility Printer Parameters • • . • ⁰ ^{• •}7-8 BOSS UPDATE Utility Option Screen . • • . • • . 7-10 BOSS UPDATE Display . . ⁰ ⁰ • • • • • • 0 • • 0 7-11 GHOST COMMUNICATIONS Display . • • • • • • • . • 7-12 SET SYSTEM DEFAULTS Utility Menu . • • • • . • . 7-14 SET PARAMETER DEFAULTS Option Screen • • • • • • 7-15 SYSTEM PARAMETERS Option Screen . • • . . • • • 7-16 TASK START-UP Display ^{G O} ^{• •} ^G ^{• • • G} ^{• • • •}7-18 SPOOLING Utility Menu ⁰ ^Q ⁰ ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 7-20 SPOOL QUEUE MAINTENANCE Menu . . • ⁰ • • • • • • 7-21 MAINTAIN SPOOLING DEFAULTS Screen Display • . . 7-25 ADD SPOOLING Screen Display ⁰ ⁰ ^• ^• ^• ^• ^• ^• ^• ^• 7-27 DROP SPOOLING Screen Display . . . . • • . • • • 7-28 Starting Despoolers . . ⁰ ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• ^• 7-30

. . .

. . . 8-1 INFO Utility Option Screen . .

INFO Utility Main Menu . • ⁰ ^{• • •}

.0.

^• ⁰ ^• ^• 8-2

(12)

(13)

OVERVIEW

SCOPE

CONTENTS

SECTION 1 ⁼ INTRODUCTION

The purpose of this manual is to describe the Business BASIC Level 4 utility programs and

procedures for operating them~ utilities are general purpose functions useful to operators at all levels₉ whether they be first=time users or experienced

programmers ⁰ This manual provides general

information on standard utility procedures as well as detailed information on each utility programo

This manual describes all utilities that are standard features of the Level 4 and later Business BASIC

systems~ except for the Magnetic Tape Utilitieso For information on the ~gMTC utili ty ~ see the Magnetic Tape utilities Reference Manual y BFISD 5052, and the Magnetic Tape utilities Quick Reference Guide, BFISD

50860 .

The information in this manual is organized into the following sections~

o Section ^2~ QQSTANDARD UTILITY PROCEDURES~ ~u

includes general information on Level 4

utilities ₉ including the main menu ₇ utility

groups~ selecting parameters and control key functions ⁰

o Section 3 ⁹ ~QDISC UTILITIES ⁹^gQ describes all utilities associated ^wi~hdisc operationso

o Section 4? UUFILE UTILr.cIES ^{9 V9} contains information on utilities which process an individual fileo o Section 5 ^~ QUFILES UTILITIES ~ uu contains

information on utilities which process a group of files, designated by individual file names~ mask or filelist ⁰

o Section 6 ~ UUPROGRAM UTILITIES~ iU describes utilities allowing an operator to create and maintain program fileso

o Section 7 ~ QU SYSTEM UTILITIES ~ U9 contains information on utilities involving system variables and parameters ⁰

o Section 8₉ QUINFO UTILITY? ^uv gives a brief description of the utility which displays or prints information on all the Level 4 utilitieso

(14)

o Section 9, "UTILITY TOOLS," contains information on three general-purpose programs used by

utilities and application programs.

o Section 10, "ERROR HANDLING," briefly discusses the standard procedures for handling error

conditions on Level 4 utilitiese

RELATED PUBLICATIONS The following Basic Four R publications contain additional information on the Level 4 Operating System:

CONVENTIONS

o Reference Manual for Business BASIC Levels 3 and 4, BFrSD 5085

o Magnetic Tape utilities Reference Manual, BFISD 5052

o Magnetic Tape Utilities Quick Reference Guide, BFISD 5087

o 610/730 Operatorvs Guide, BFISD 5042

o Operator~s Training Guide 200/410, BFISD 5045 o Synchronous Communications Reference Manual,

BFISD 5007

o Multi-level Directory Facility (MDF) Reference Manual, BFISD 5110

This subsection describes the conventions used in this manual for representing data to be entered at the terminal. In references to information to be entered at the terminal in this guide, "Press"

indicates that a function or control key is to be pressed, and "Enter" indicates that something is to be typed and frequently a Control Key (Carriage

Return, Control Bar, etcs) is to be pressedo Keys to be pressed are indicated in caps and

underlined, without any quotation marks, such as:

CTL-IV (for Control Bar IV) and RETURN or CR (for Carriage Return)

Information to be typed in is 'surrounded in single quotes, which are not themselves to be typed ₇ as in:

'm' (for the letter m) 'YESv (for the word YES).

(15)

DEFINITIONS

oP'

mRRS

The following terms appear frequently in this manual and are defined as follows:

Block Print - The format used when listing program files. Each part of a compound statement is listed on a separate line. FOR/NEXT loops and IF/THEN/ELSE groups are indented five spaces, resulting in a more readable format than an ordinary listingo

Filelist ~ A file containing the names of a group of files to be processed by a program ⁰ Any list of file names may be saved as a filelist and assigned a nameo Gap File - An indexed file containing information about available sectors for that disco The name of the file is vv*:XXXX" where the X's are the first four characters of the disc name. When a new file is

created, the program reads the gap file to determine the available sectors and then allocates the

appropriate space to that filee The gap file should be maintained regularly, either at load time or

through the utility program MAINTAIN GAP FILEo See Section 3 on the MAINTAIN GAP FILE utilityo

Hash - A 2~byte hexadecimal code used as a pointer to the Scatter Index Tableo This code is not unique to each string of characterso

Mask - Used to create a filelist by using a special cnaracter as a place-holder for any ASCII character.

On Level 4 systems, the special mask character is a CONTROL wzw (CTRL z)~ or holding the CONTROL key down while pressing

tzw

⁰ Utility programs consider the

CONTROL ^vzv a match for any ASCII character,

including blankso Thus the mask '*' ⁺ CTRL Z + 'BC' matches all file names beginning with an asterisk and with the letters

Be

in the third and fourth positions and containing any character? including a blank,

between the asterisk and the Be The mask 'ABCD' +

CTRL Z ⁺ CTRL Z matches all file names beginning with the letters WABCD' and ending with any two

characters, including blanks. The mask composed of five CTRL Zis matches all file n~mes containing five characters or lesso

Parameter File ⁼ The file named n*PARM" resides on the disc along with the utility programs and is

essential to the operation of the Level 4 utilities.

It contains all menus and the names of utility

(16)

parameters and printer information. All utilities must refer to this file at some point during program execution.

utility Tools - Programs used by both utility drivers and application programs. A utility tool (or PUBLIC TOOL) is used to allocate file space on disc, and is designed for general purpose use. There are twelve such programs on Level 4 systems. See SECTION 9 for detailed information on UTILITY TOOLS.