PGMFLOW.V2 V01 RP AUTOMATION INC. 11JAN89

DESCRIPTION

The programs in this file combine to show the flow of program

control starting from a selected program name. All programs

that are CALL'd from the specified program, any programs that

they CALL, etc. will get displayed on the CRT screen in an

effort to show the program's flow through the various CALL's.

PREPARATION

Load the file PGMFLOW.V2 into memory.

PROGRAM EXECUTION

When the "pgmflow" program is executed, it immediately looks

for a special area in memory where the VAL-II system stores

pointers to the variable names in user memory. If this area

is not found, then a message gets displayed, and the program

gets ABORT'd.

Once this area is found, a PROMPT is given to the CRT screen

that asks the name of the program which is to be the starting

point for the flow.

The program then searches all of the VAL-II user memory area,

noting and saving all .PROGRAM's that are found. After this,

the program that was specified from the keyboard input gets

scanned for any CALL's to these programs.

If any matches are found, then those program names get shown

on the CRT screen as the first LEVEL. Any programs that they

CALL will be displayed as the second LEVEL, etc.

NOTES

If a program name has already been displayed, and it is found

again, then it gets displayed with an asterisk (*) to signify

that it is a multiple listing for this program, and it will

not be looked through to find its CALL's again. This extra

checking will allow co-routines and recursive routines to use

this facility without getting caught in an endless loop.

Any program name starting with the letters "pgmf" will NOT be

displayed. This is so that none of this file's programs get

involved with what is trying to get accomplished.

MESSAGES

*** Specified .PROGRAM name was not found ***

This message gets displayed if the name that was entered does

not match any of the program names that were found during the

initial search.

***** FLOW PROGRAM HAS FINISHED *****

This message gets displayed when the program is finished.

*** Couldn't find VARTAB data ***

This message gets displayed if the special area of VAL-II

memory is searched and the expected data is not found.