DISK SEARCH utility RP AUTOMATION INC. DEC 1988

Preliminary Documentation

1.0 Introduction

The programs in this file allow searching of a specified ASCII

string in files on the floppy diskette. All .PROGRAM names are

displayed on the CRT screen in addition to all matching strings.

2.0 Subroutine Description

Name Description

rp.disk.search This program initiates the search

for a specified ASCII string. This

is accomplished via PROMPTs for the

string to be found, and the filename

to be searched.

rp.flp.blkr These programs are not to be EXECUTE'd

rp.flp.comms by the user. They are used internally

rp.flp.dir for a variety of uses.

rp.flp.openr

rp.flp.setup

rp.flperr

rp.flpin

rp.flpout

rp.get.string

rp.get.string.upper

rp.type.string

3.0 Messages

*** Floppy error nn ***

If a floppy error occurs during the program, then this message

will get displayed, where 'nn' is a number which corresponds to

the internal floppy disk drive error code. The codes are:

2 = File already exists (creating new file with same name)

3 = File does not exist (opening file for reading)

4 = Communications error between VAL & floppy

5 = Disk full (writing to disk)

6 = Communications error between VAL & floppy

7 = Communications error between VAL & floppy

10 = Communications error between VAL & floppy

11 = Communications error between VAL & floppy

12 = Floppy not ready

13 = Floppy read error (diskette may be bad)

14 = Communications error between VAL & floppy

41 = No STX received during block transfer

42 = Incorrect checksum received during block transfer

4.0 Software Installation

1) Load the RP_DISK.SEARCH file from floppy. This is done

by typing:

LOAD RP_DISK.SEARCH

2) Execute the program, "rp.disk.search". This is done by

typing:

EXECUTE RP.DISK.SEARCH

3) Answer the questions concerning the ASCII string to search

for and the filename to be searched.

4) The search will begin, listing to the screen all .PROGRAM

lines that are encountered, as well as any lines which

have a match of the specified ASCII string. This will

allow the user to determine in which .PROGRAM the match

occured.

5) When the search is finished, another filename is asked

for. The same ASCII string will be used if a filename is

entered at this point. If a <RETURN> is typed without

entering a filename, then the program will terminate.

6) In order to search for two different strings, the program

must be run twice.

5.0 Variable names used

The following list of real variable names are used within this

set of programs:

rp.bs.sp.bs[] rp.checksum rp.chr

rp.cmd rp.cr.lf[] rp.dirbuf.ptr

rp.end[] rp.filename[] rp.flag

rp.flp.input[] rp.getchr rp.i

rp.inbuf[] rp.outchr[] rp.pgm[]

rp.pgm.ptr rp.print rp.str.cnt

rp.str.cnt2 rp.string[] rp.tmp