! Editted by Frank J. Nagy 03-Apr-83 to cleanup and specialize to Fermilab
!
1 VTM
 VTM is a program used to format messages for a VT100 terminal.
 Various options are available and are listed below.  If no options
 are specified, the default is to clear the screen and write the message
 in double height characters centered in the middle of the screen.

 Consult help on "Startup" and "Format" before attempting to use VTM.
2 ALL
 Turns on all attributes except underscore.
 The attributes turned on are BOLD, BLINK, and REVERSE.

2 ACSET
 Selects the alternate character set.  

2 ANSI
 Sets the ANSI mode.  The VT100 MUST be in this mode for VTM
 to work properly.

2 BLINE

 BLINE=n

 Specifies the bottom line number.  This is the line number
 where wraparound to the top line occurs.  The default bottom
 line number is 24.

2 BELL
 Inserts a bell in the message.  Multiply bells can be inserted
 in each message by using the command:  {BELL, BELL}

2 BLINK
 Turns on the blink attribute.

2 BOLD
 Turns on the bold attribute.

2 BOX

 BOX=top_line:bottom_line[:left_column:right_column]

 Draws a box on the screen using special graphics.  The
 default line and column numbers are {BOX=1:22:1:80} for
 VAX/VMS and {BOX=1:23:1:80} for RSX-11M.  If just {BOX}
 is specified, the previous parameters are used.

2 CLEAR

 CLEAR or -CLEAR

 Enables or disables clearing the entire screen.  The default
 is to clear the screen once before the first message is written.  

2 COLUMN

 COLUMN=n

 Use column number 'n' for the next message.

2 CENTER

 CENTER or -CENTER

 Enables or disables centering messages in the middle of the
 screen.  The default is to center messages.

2 CBOL
 Clears to the beginning of the line.

2 CEOL
 Clears to the end of the line.

2 CLIN
 Clears the entire line.

2 CBOS
 Clears to the beginning of the screen.

2 CEOS
 Clears to the end of the screen.

2 DATE
 Outputs the current date in the format DD-MMM-YY.

2 DELAY

 DELAY=n

 Delays for 'n' seconds.  The delay is immediate.  If it
 is specified on a line with a message, the message is
 displayed after the delay.  The delay has no effect on
 output to a file.  It's useful only in VTM command files.

2 DHEIGHT

 DHEIGHT or -DHEIGHT

 Enables or disables double height messages.  Once specified,
 the next and subsequent messages are written in double height.

2 DWIDTH

 DWIDTH or -DWIDTH

 Enables or disables double width messages.  Once specified,
 the next and subsequent messages are written in double width.

2 Format
 Command lines are of the form:

 {option, option, ...} message_text {option, option, ...} etc.

 Where message_text is the text to display.  If contained in a
 command file, upper and lowercase characters are accepted.  The
 command line interpreters (MCR and DCL) convert lowercase to
 uppercase.  The message is truncated if the length is too long.

 The braces MUST be specified around the options.  Multiple options
 must be separated with commas.  The options can be abbreviated to
 one or two characters.

2 JUMP
 Sets the jump scroll mode.

2 HOME
 Writes the message starting in the top left corner of the screen.
 This is equivalent to command {L=1, C=1}.  The screen is not cleared.

2 ITERATION

 ITERATION=n

 Specifies an iteration count for the next or current command line.
 If you specify a count of 65535, you will loop infinitly and you
 must type CTRL/C to exit from VTM.

2 KEYPAD

 KEYPAD=ON or KEYPAD=OFF

 The ON state is known as the application mode.  In this
 mode, the keys on the keypad transmit an escape sequence.

 The OFF state is known as the numeric mode.  In this mode,
 the keys on the keypad transmit the number on the key.  Your
 keypad is normally in the numeric mode.

2 LINE

 LINE=nn

 Specifies the line number for the next message.  On startup,
 the default line number is 12.

2 LED

 LED=n or -LED

 Turns on the specified LED (L1 - L4) on the terminal.  The
 The range of 'n' is 1-4.  If 'n' isn't specified, all the
 LEDs are turned on.  A {-LED} command turns all LEDS off.

2 LJUSTIFY
 Left justify the next message.  Same as the command {C=1}.

2 LMARGIN

 LMARGIN=n

 Sets the left margin to 'n'.  The default is 1.

2 NARROW
 Sets the screen to 80 column mode.  The VT100 automatically
 clears the screen when changing column modes.

2 OUTPUT

 OUTPUT=file.ext

 Outputs to the specified file.  If running interactive, messages
 are output to both the terminal and the file.  The -TTY command
 will inhibit output to the terminal.  If no output file is specified
 (i.e., {OUT=}), the default file name of VTM.DAT is used.  If a
 second {OUT=...} is specified, the current file is closed and the
 new file is openned.

2 OFF
 Turns off all the attributes (BLINK/BOLD/REVERSE/UNDERSCORE).
 All attributes are turned off because the VT100 does not have
 the capability to turn off a single attribute.  This command
 is executed automatically at the end of each message output
 if you havn't turned the attributes off.

2 PLINE

 PLINE=n

 Specifies the prompt line number.  The default prompt line
 is 24 for RSX-11M and line 23 for VAX/VMS.  This is also
 the last line output to a file when the file is closed.

2 REVERSE
 Turns on the reverse video attribute.

2 REGION

 REGION=top_line:bottom_line or -REGION

 Enables or disables the scrolling region.  When specifying a
 scrolling region, the top line must be greater than the bottom
 line.  To disable the scroll region, use {-REGION} or {REGION=1:24}.

2 RESET
 This does a power-up reset.  It is useful in command files
 being aborted by CTRL/C or CTRL/Y when the state of the
 VT100 is unknown.

2 RJUSTIFY
 Right justify the next message.  The message will be output
 so the last character lines up with right margin.

2 RMARGIN

 RMARGIN=n

 Sets the right margin to 'n'.  The default is 80.

2 RULER

 RULER=n

 Write a ruler on the VT100 to aid in message formatting.
 The default line number (n) is 1.

2 TLINE

 TLINE=n

 Specifies the top line number.  This is the line started at
 after wrapping around from the bottom.  The default top line
 number is 1.

2 SKIP

 SKIP=n

 Skips 'n' lines on the screen.  After displaying a message,
 VTM automatically adjusts the line number to the next line.
 This option is used for additional spacing.

2 SCREEN

 SCREEN=BLACK or SCREEN=WHITE

 The BLACK state causes the screen to be black with white
 characters.  The WHITE state causes the screen to be white
 with black characters.

2 SGRAPHICS
 Turns on special graphics.  In this mode, the lowercase
 character set is used to display special graphic characters.
 Use either {UKSET} or {USSET} to exit special graphics mode.

2 SMOOTH
 Sets smooth scroll mode.

2 Startup
 There are three methods of starting VTM; they are:

     1. $ VTM
        VTM>

        This is the interactive mode.  VTM continues to prompt
        for input until you type CTRL/Z to exit.

     2. $ VTM message_text

        Clears the screen, writes the message in the middle of the
        screen, and then exits.

     3. $ VTM @command_file

        Using this method, command lines are read from the specified
        command file.  The length of the command lines can be up to a
        maximum of 256 characters.  The continuation character "-" is
        allowed at the end of a line.  If the extension isn't specified
        the default is .VTM.

 The VTM command is defined as a foreign command by:

        $ VTM :== $FERMI$EXE:VTM

2 TEST
 Fills the screen with "Es".

2 TERMINAL

 TERMINAL=ddnn:

 Specifies the terminal to write the message to.  On VAX/VMS,
 you can only write to terminals which are not logged on.
 Logical names are permitted of the form ddnn: (RSX standard).
 The double underscore on terminal names on VAX are stripped.

2 TIME
 Outputs the current time in the format HH:MM:SS.

2 TTY

 TTY or -TTY

 Enables or disables output to the local terminal.  The default
 is to always output to the local terminal.  On RSX-11M, the
 output device is TI0:.  On VAX/VMS, the output device is
 wherever SYS$OUTPUT is directed (normally the terminal).

2 UNDERSCORE
 Turns the underscore attribute on.

2 UKSET
 Selects the United Kingdom character set.

2 USSET
 Selects the USASCII character set.

2 WIDE
 Sets the screen to 132 column mode.  The VT100 automatically
 clears the screen when changing column modes.

