PURPOSE
To trace calls to your subroutines. FMSPSH adds your subroutine to the list of internal
subroutines maintained by
FMS. FMSPOP removes your subroutine from the
list of called subroutines.
The benefits include CPU and WALL
timings, number of times called by parent and children and an optional graphical trace
of your subroutine calls.
SYNOPSIS
CALL FMSPSH (NAME)
CALL FMSPOP (NAME)
INPUT PARAMETERS
- NAME = CHARACTER*18
Name of the subroutine
OUTPUT PARAMETERS:
None.
FMS PARAMETERS:
The following
FMS Parameters are especially
important to this routine:
Parameter |
Description |
LOGTIM |
Turns on timing and tracing |
DESCRIPTION:
These subroutines add or remove an entry to the
FMS call stack for
subroutine NAME. The action taken is different when NAME is called by the
parent or child.
- Parent
FMSPSH places subroutine NAME on the FMS call stack.
Timers are started to measure the CPU and WALL time used.
The number of calls by the parent is incremented.
FMSPOP removes subroutine NAME from the FMS call stack and
stops the timers.;
- Child
FMSPSH increments the number of times NAME was called by a child process.
FMSPOP checks NAME and returns.
You MUST follow a call to FMSPSH with a call to FMSPOP
at each point in subroutine NAME where a return is possible.