Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameters

Qualifiers

Examples

/ECHO

/IF_STATE

/LOCK_STATE

/LOG

/SET_STATE

/TERMINATE

MAIL DEFINE — MicroVMS 4.5B

  Defines a key to execute a MAIL command.  This enables you to  press
  a key to enter a command instead of typing the command name.

   Format:

       DEFINE/KEY key-name string

Additional information available:

ParametersQualifiersExamples

Parameters

 key-name

  Specifies the name of the key you are defining.  Use  the  following
  key-names when defining keys:



       Key-name            VT100     VT52        LK201

       PF1                 PF1       red key     PF1
       PF2                 PF2       blue key    PF2
       PF3                 PF3       black key   PF3
       PF4                 PF4       -           PF4
       KP0, KP1-KP9        keypad 0-9            keypad 0-9 keypad 0-9
       PERIOD              period key            period key period key
       COMMA               comma key comma key   comma key
       MINUS               minus key minus key   minus key
       ENTER               ENTER key ENTER key   ENTER key
       UP,DOWN,LEFT,RIGHT  arrow keys            arrow keys arrow keys
       FIND,INSERT_HERE    -         -           Find,Insert Here
       REMOVE,SELECT       -         -           Remove,Select
       PREV_SCREEN         -         -           Previous Screen
       NEXT_SCREEN         -         -           Next Screen
       HELP,DO             -         -           Help, Do
       F6-F10,F11-F14      -         -           Function Keys
       F17-F20             -         -           Function Keys

 string

  Specifies the string you want entered when  you  press  the  defined
  key.   "String" can be a MAIL command, for example, DIRECTORY or SET
  FILE.

Qualifiers

Additional information available:

/ECHO/IF_STATE/LOCK_STATE/LOG/SET_STATE
/TERMINATE

/ECHO

 /[NO]ECHO

 Specifies whether or not the command line is echoed after  you  press
  the  defined  key.   You cannot define a key specifying both /NOECHO
  and /NOTERMINATE.  The default is /ECHO.

/IF_STATE

 /[NO]IF_STATE=state_list

 Specifies a list of states, any one of which must be set in order  to
  enable  the  specified  key  definition.  If you omit or negate this
  qualifier, the current state prevails.

/LOCK_STATE

 /[NO]LOCK_STATE

 Retains the state specified by the /SET_STATE qualifier until you use
  the  /SET_STATE  qualifier  again  to  change  it.   The  default is
  /NOLOCK_STATE.

/LOG

 /[NO]LOG

 Specifies whether or not informational messages are displayed.  These
  messages  signal  successfully created key definitions.  The default
  is /LOG.

/SET_STATE

 /[NO]SET_STATE=state

 Associates a state with the key you are defining.  A state  name  can
  be  any  alphanumeric string.  If you omit or negate this qualifier,
  the current state  remains  unchanged.   You  cannot  define  a  key
  specifying both /SET_STATE and /TERMINATE.

/TERMINATE

 /[NO]TERMINATE

 Determines whether or not the specified command string executes  when
  you  press the key.  When you use /NOTERMINATE you must press RETURN
  to execute the command string.  You cannot define a  key  specifying
  both /SET_STATE and /TERMINATE.

Examples

  1.   MAIL> DEFINE/KEY PF1 "DIRECTORY"

  This example shows how to define the keypad  key  PF1  as  the  MAIL
  command  DIRECTORY.   To  enter  the  DIRECTORY  command,  press PF1
  followed by the RETURN key.

  2.   MAIL> DEFINE/KEY KP6 "EDIT" /TERMINATE

  This example shows how to define  the  keypad  key  6  as  the  EDIT
  command.   The  /TERMINATE  qualifier  causes  the  EDIT  command to
  execute when you press keypad key 6 without having to press RETURN.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026