Next: D Installation: UNIX Up: Part IV: Appendices Prev: B.6 The general preprocessor TOUTXX Contents

C The MODULEF library structure

When being confronted with a large library such as MODULEF, it is very useful to be able to answer questions such as:

• which procedures belong to a certain library?
• which procedures are called by a specific subroutine?
• what are the names of the libraries to execute a certain procedure?
• in which subroutines is a specific COMMON declaration found?

A "procedure data base" can be consulted interactively to provide information concerning the program hierarchy. For example, information concerning all the routines called by a calling (or main) program can be accessed: called programs calling program. Furthermore, a table of procedures (see section 4.5, part iii) specifies all the libraries to reference when calling a preprocessor. To obtain this information it is necessary to

• create the table of procedures (see section 4.5, part iii) via program PROCAT of library PPAL, using datafile SYMD.D of library SYMD, and
• examine the table of procedures via program PROIMP of library PPAL.

Program PROIMP utilizes the datafile created by program PROCAT.

An example of the interrogation of the procedure data base is given below. A menu appears as soon as program PROIMP is executed. Say, for example, we would like to know the names of all the subroutines called by subroutine APNOXX. We then choose option PA from the menu, select the > option, and enter the name of the subroutine. We follow the same procedure to extract all the subroutines called by subroutine APNOPW. To return to the main menu, press on the "return" key.

B$ proimp

 **** COMMAND    ( OR ? = HELP ) ? 
?

 BB   : RELATIONS LIBRARIES <--> LIBRARIES
 F    : END (SAME AS Q)
 G    : GENERAL
 LC   : LENGTH OF A COMMON
 NB   : NAMES OF LIBRARIES
 NC   : NAMES OF COMMONS
 NP   : NAMES OF PROCEDURES
 PA   : RELATIONS PROCEDURES <--> CALLED PROCEDURES
 PB   : RELATIONS PROCEDURES <--> LIBRARIES
 PC   : RELATIONS PROCEDURES <--> COMMONS
 P*   : CLOSURE OF CALLED PROCEDURES
 Q    : QUIT THE PROGRAMM (SAME AS F)

 **** COMMAND    ( OR ? = HELP ) ? 
PA

 CHOOSE THE RELATIONSHIP :
    >          PROCEDURE > CALLS
    <               CALL < PROCEDURES
    (RETURN)   QUIT
>

 PROCEDURE ?   (OU *=LISTE COMPLETE, RETURN=QUITTER)
APNOXX
 > CALLS                         
 APNOPW   FFRONT   INITIS   

 NUMBER OF ENTRIES IN THE ABOVE TABLE :       3

 PROCEDURE ?   (OU *=LISTE COMPLETE, RETURN=QUITTER)
APNOPW
 > CALLS                         
 APNOPO   CNVAPN   IINFO    LECTEU   LIBCAR   LIBCOM   OUVRIR   TITRE    
 TRUNIT   

 NUMBER OF ENTRIES IN THE ABOVE TABLE :       9

 PROCEDURE ?   (OU *=LISTE COMPLETE, RETURN=QUITTER)


 CHOOSE THE RELATIONSHIP :
    >          PROCEDURE > CALLS
    <               CALL < PROCEDURES
    (RETURN)   QUIT


 **** COMMAND    ( OR ? = HELP ) ? 
?

 BB   : RELATIONS LIBRARIES <--> LIBRARIES
 F    : END (SAME AS Q)
 G    : GENERAL
 LC   : LENGTH OF A COMMON
 NB   : NAMES OF LIBRARIES
 NC   : NAMES OF COMMONS
 NP   : NAMES OF PROCEDURES
 PA   : RELATIONS PROCEDURES <--> CALLED PROCEDURES
 PB   : RELATIONS PROCEDURES <--> LIBRARIES
 PC   : RELATIONS PROCEDURES <--> COMMONS
 P*   : CLOSURE OF CALLED PROCEDURES
 Q    : QUIT THE PROGRAMM (SAME AS F)

 **** COMMAND    ( OR ? = HELP ) ?

If you would like to terminate the interrogation, simply type the letter Q. Let us however first check which libraries does subroutine COMAXX access. To do this choose option P from the main menu, select option B and type the name of the subroutine:

P*

 SELECTED OPTION :
    A          TREE OF PROCEDURES
    B          TABLE OF LIBRARIES
    P          TABLE OF PROCEDURES
    BP         TABLE OF LIBRARIES + PROCEDURES
    F          FILE  OF LIBRARIES + PROCEDURES
    (RETURN)   QUIT
B

 PROCEDURE ?   (OU RETURN=QUITTER)
COMAXX

 PROCEDURE ?   (OU RETURN=QUITTER)


 LIBRARIES :

 CONV     CONW     COSD     ELA2     ELA3     ELAS     ELCP     FLUI     
 MAGN     PPAL     THER     UTII     U_SUN UTSD     ZZZZ_MOD

 NUMBER OF ENTRIES IN THE ABOVE TABLE :      15

 SELECTED OPTION :
    A          TREE OF PROCEDURES
    B          TABLE OF LIBRARIES
    P          TABLE OF PROCEDURES
    BP         TABLE OF LIBRARIES + PROCEDURES
    F          FILE  OF LIBRARIES + PROCEDURES
    (RETURN)   QUIT


 **** COMMAND    ( OR ? = HELP ) ? 
?

 BB   : RELATIONS LIBRARIES <--> LIBRARIES
 F    : END (SAME AS Q)
 G    : GENERAL
 LC   : LENGTH OF A COMMON
 NB   : NAMES OF LIBRARIES
 NC   : NAMES OF COMMONS
 NP   : NAMES OF PROCEDURES
 PA   : RELATIONS PROCEDURES <--> CALLED PROCEDURES
 PB   : RELATIONS PROCEDURES <--> LIBRARIES
 PC   : RELATIONS PROCEDURES <--> COMMONS
 P*   : CLOSURE OF CALLED PROCEDURES
 Q    : QUIT THE PROGRAMM (SAME AS F)

 **** COMMAND    ( OR ? = HELP ) ? 
Q
 NUMBER OF WORDS USED :        49236 /     5000000