1 MARKTOOL

 MARKTOOL is a tool which allows  the  instrumentation  of  programs  to
 track  their  usage by date and user name.  There are two ways in which
 it may be used:  as a stand-alone tool to track DCL command procedures,
 or  as  a subprogram which may be called from FORTRAN or other compiled
 languages.

2 Syntax

 The syntax for the stand-alone tool is:

           $ MARKTOOL toolname logfile


3 Qualifiers

/[NO]LOG

 Indicates whether the tool is to report its usage to SYS$OUTPUT.
 /NOLOG is the default.

/[NO]DATE

 Indicates that the log file entry is to contain the  current  time  and
 date.
 /DATE is the default.

3 toolname

 A 1- to 12-character string which indicates the name of the tool  whose
 use is being logged.

3 logfile

 A valid VMS file specification for the file in which the log is  to  be
 kept.   This  file  must  already  exist,  and the user must have write
 privileges for it.

2 Calling Sequence

 The calling sequence for the callable version is:

      STATUS = MARKTOOL (toolname, filename, date-flag, log-flag)

 The toolname and filename parameters are character strings.   Only  the
 first  12  characters  of  the  toolname  parameter  will be used.  The
 date-flag  and  log-flag  parametes  are  logical   values   indicating
 respectively whether the date and time is to be logged, and whether the
 log is to be  noted  on  SYS$OUTPUT.   The  completion  status  of  the
 MARKTOOL operation is passed back as an INTEGER*4 value.

2 Linking

 To include the callable version of MARKTOOL in an image, link the image
 as follows:

           $ LINK ...,SUP_COM:MARKTOOL/OPT,...
