.f
.ifnot manual
.RM 64
.NO NUMBER
.NO PAGING
.STHL 5,1,1
.endif manual
.if MANUAL
.hl 1 CONTROLT - ROUTINE TO PRINT INCREMENTAL TIME STATISTICS
.else MANUAL
.nf
2 CONTROLT
!
.br
.f
.endif MANUAL
CONTROLT is a routine which simulates the DEC-10 Control-T feature.
This feature allows the user to interrupt his running program at
any time and print out how much time has elapsed, how much CPU time
has been used, and how much I/O has been done. The mechanism
is activated every time the Control-C key combintion is struck.
When you press Control-C, the information is printed on the
terminal immediatly.
The running program
is not affected by this activity. However, the CONTROLT feature is
not available unless a program makes an explicit call to the CONTROLT
subroutine. Almost all of the HMC library programs and those programs
on the TOOLS: directory have this feature installed.
.if manual
.hl 2 Author of CONTROLT
.else manual
.br
3 Author
.br
.endif manual
CONTROLT was written by Mark Anderson. It is currently supplied
and supported by the OMNIGRAPH project.
.ifnot manual
Any questions about or problems with CONTROLT should be reported
via MAIL to OMNIGRAPH.
.endif manual
.if manual
.hl 2 Activating the CONTROLT feature
.else manual
.br
3 Calling
.br
.endif manual
All that a program need do to activate the mechanism is to make the
call:
.s 1
.i +8
CALL CONTROLT
.s 1
at the beginning of the program. No arguments are necessary and CONTROLT
may be called from any of the languages on the VAX. After the call, any
time Control-C is struck, the elapsed time, CPU time used, and I/O operations
done will be printed. Control-C may be used as often as the user wishes.
Note that Control-C during graphics output may disturb the picture being
drawn.
.if manual
.hl 2 Location of the CONTROLT routine
.else manual
.br
3 Location
.br
.endif manual
The source to CONTROLT is the file:
.s 1
.i 8
DEV:[OMNIGRAPH.UTILITY]CONTROLT.FOR
.s 1
CONTROLT is in the object library POWELL. All that needs to be done
is to request this library at link time. This would appear as:
.s 1
.i 8
$ LINK PROG,TOOLS:POWELL/LIB
.s 1
The CONTROLT routine will then be loaded into your program.