.chapter The VAX Tool Box
.IFNOT NBI
.RM72
.LM5
.ENDIF NBI
.STHL ,0
.ap
.flags bold
.enable bolding
.HL 1 Introduction

The VAX Tool Box provides a place where infrequently used utility functions
and functions which do not belong as part of any other menu may be placed.

The Tool Box menu differs from any other menu in the VPW system in that
it is a "Rubber Band" menu.  Conceivably, it can be as long as a given
site wants, ie hundreds of lines of selections.  However, only 11 lines
are displayed at a time, and the user is allowed to move forward and
backward in the menu by either pressing the Up/Down arrow keys or the 
Prev/Next keys (LK201 keyboards).
.hl 1 The Tool Box Menu

When the Tool Box menu is first invoked, a display similar to the folowing
appears.
.keep
.nofill

                     ^*The VAX Tool Box\*

         ^*BA\*ckup       -    Backup files to tape
         ^*CE\*rtify      -    Certify Tape
         ^*CL\*ock        -    Terminal alarm clock
         ^*DD\*T          -    Draw Directory Tree structure
         ^*ER\*rors   nn  -    Translate VMS error codes to english
         ^*IW\*Q          -    Insert file into WP Transfer Queue
         ^*O\*pen ^*F\*iles   -    Show process's open files
         ^*PR\*oblem      -    Submit a VAX System Problem Report
         ^*QD\*isplay     -    Compact display of Print/Batch Queues
         ^*RES\*equence   -    Resequence a Fortran source file
                               ^*More ...\*
         ^*E\*xit / ^*<ret>\* -    Exit to DCL / Return to previous menu
         ^*PF2\*  / ^*PF4\*   -    HELP / New VPW Window
         ^*Prev\* / ^*Next\*  -    Previous / Next menu screen

Choice:

.NOKEEP
.fill

The exact contents of the Tool Box menu depend on what utilities have been
made available through it.
The ^*More#...\* in bold indicates that more items are available for selection.
Pressing the ^*Next Screen\* or down arrow key, will "roll in" the next page
of menu items each time that key is pressed.  When no more items exist,
a ^*No#More#...\* will be displayed.  Likewise, one can go backward in the
menu by pressing ^*Prev Screen\* or the up arrow key.  When one reaches the
top of the list of entries, a ^*No#More#...\* will be displayed at the top of 
the screen.

The minimum number of key strokes to enter is highlighted in bold.  Enter
a selection at the "Choice: " prompt.  If you are unsure how to use
some function, try pressing the PF2 key for HELP.  There is a good chance
that HELP exists for the function you are interested in.
.hl 1 Adding a New Entry to the Tool Box Menu

To add a new entry, two changes must be made.  First, the text to be displayed
in the menu must be added to SYS$SYSVPWFILES:TOOLMENU.TXT.  By convention,
the minimum number of allowed keystrokes required to activate a menu item
are bolded by enclosing that text with the <ESC>[1m/<ESC>[m pair.  Next, one
edits VPWTOOLBX.COM to add that entry to the dispatch table of the form
"IF ...... THEN GOTO My__Function".  At some appropriate place in the body
of VPWTOOLBX.COM add a line "$My__Function:" followed by several lines to 
activate the new command procedure and then return to the start of the
Tool Box menu. For example
.lit

$       IF Option2 .EQS. "PR"	     THEN GOTO Submit_VPR
          ...     ...     ...     ...     ...     ...
          ...     ...     ...     ...     ...     ...
          ...     ...     ...     ...     ...     ...
$Submit_VPR:
$       ON ERROR THEN CONTINUE
$       @SYS$SYSVPWFILES:VAXPRBLM
$       GOTO Start

.end lit
Note that the parsing of the "Choice" prompt is already done for you.  The
Symbols Option, Option2 and Option3 contain 1, 2, and 3 characters of the
choice prompt respectively.