FPT and WinFPT Reference Manual - Command-line Commands

| SimCon Home | Reference Manual Home |


SHOW CALL TREE

Syntax:

SHOW CALL TREE [ [:] <symbol> [ { [,] <symbol> } ... ] ]

NO CALL STRUCTURE LISTING

DO NOT LIST CALL STRUCTURE

Function:

When written without arguments, FPT lists a call tree of the entire program or suite of programs. When the command is made in interactive mode, one or more sub-programs may be specified as arguments, and FPT then displays only the call trees starting at these sub-programs.

The names of sub-programs which have not been read by FPT are shown in the tree parenthesis, as is SECNDS in the example below.

The call tree display is indented to show the nesting structure, and the level of call nesting is shown at the left margin.

By default, the call tree is displayed to a call nesting depth of 5. When the calling depth exceeds this value, the sub-program name is followed by elipses, ..., and a separate call structure display is written for the sub-program concerned. The depth of the call tree display may be modified by the command CALL STRUCTURE LISTING DEPTH. Note that increasing the depth also increases the length of the display since all calls from every instance of every sub-program are displayed.

When FPT is run interactively, the listing is directed to the screen by default. It may be re-directed by the commands [NO] LIST TO FILE and [NO] LIST TO TERMINAL.

An interactive listing may be terminated by the command STOP CALL STRUCTURE LISTING.

Where to use this command:

Operating system command line

Yes


Configuration file, config.fsp

No


Specification (FSP) files, *.fsp

Yes


Interactively, to FPT> prompt:

Yes


Interactive command files

Yes


Embedded in the Fortran code

No


Default:

The call tree is not shown by default (Note that defaults may be changed in the configuration file)

Example:

FPT> show call tree: chess

   0  CHESS
   1  !  (SECNDS)
   1  !  HEUR
   2  !  !  MYCAS
   3  !  !  !  BMOVE
   2  !  !  WMOVE
   1  !  TREE
   2  !  !  FMOVE
   2  !  !  BMOVE
   2  !  !  WMOVE
   1  !  MYGO
   2  !  !  FMOVE
   2  !  !  WMOVE
   1  !  ISGO
   2  !  !  ISCAS
   3  !  !  !  WMOVE
   2  !  !  BMOVE
   2  !  !  WMOVE

See also:

CALL STRUCTURE LISTING

CALL STRUCTURE LISTING DEPTH


Copyright ©1995 to 2014 Software Validation Ltd. All rights reserved.