NAME

      mainMenuBar - User Defined MenuBar
    

SYNOPSIS

      mainMenuBar -p menuPtName [-h heapsize] [-f font] [-b bg_colorname]
                  [-g  fg_colorname]  [-v env_var] [-l lock_program] [-n]
                  [-o lock timeout (minutes)]

DESCRIPTION

      mainMenuBar places a user defined menubar across the top of  the  crt.
      The menu items can be configured for security, so that items for which
      a user does not have security for are not  selectable.   Some  of  the
      uses  for  the  menu  bar include starting up processes such as hpterm
      and running utilities such as RtapSchematX.

      The user is required to  log  into  the  menu  bar  by  selecting  the
      Security  menu  label  and  the  New User menu item. The user name and
      password is verified with  the  system  and  the  user's  security  is
      queried  from  the  database.  Only  menu  items that allow the user's
      security level is enabled (see menuConfig(3)).

      Over the menu bar is an informational bar that contains the following:

      - company logo, which is retrieved from the file "logo" from the
        symbols directory
      - the user that is currently logged in
      - the current date and time

      The configuration information is stored in the  database  in  a  user-
      specified  point.  The name of this point is given in the command line
      argument -p. Each option in the menu bar is  represented  by  a  table
      attribute  in the menu point.  There will be as many attributes in the
      menu point as menu options and they are named Menu 0, Menu 1, Menu  2,
      Menu 3, etc.

      There are two fields in each table attribute -
      Menu Name Or Item - which has a data element type of rtBYTES20
      Command To Execute - which has a data element type of rtBYTES128

      Record 0, field Menu Name or Item in the table indicates the title  to
      display  on the menubar and has a NULL string for the field Command To
      Execute. The remaining records in the  table  contain  the  particular
      menu  option  name  in  the  Menu  Name  or Item field and the related
      command sequences in the Command To Execute field.

      The heap size for this process can be set using the  -h  command  line
      argument.

      The default font  used  is  "-adobe-new  century  schoolbook-medium-r-
      normal--17-120-100-100-p-91-iso8859-1"   but  it  can  be  changed  by
      setting the command line argument -f to the new font name.
      The background and foreground colors use the system defaults  for  the
      menu  bar  unless they are specified in the command line.   The system
      defaults  are  defined  by  the  color  scheme  file  named   in   the
      .X11defaults.   It  uses  the  colors  defined under the Window Styles
      section. The colors can be set directly  by  using  the  command  line
      argument  -b  for  the background color name and -g for the foreground
      color name.

      Environment variables that need to be pre-pended to the  command  line
      can  be specified using the -v option (for example, "-v DISPLAY", will
      pre-pend DISPLAY=... to all commands executed.

      The program used for locking the display is  specified  using  the  -l
      option.   The   default   is  /usr/vue/bin/vuelock.   Note  that  this
      functionality requires that the program xautolock is available on  the
      system.

      Notification of a pending lock  can  be  used  by  specifying  the  -n
      option.

      The timeout period, in minutes, can be specified using the -o  option.
      The default is 10minutes.

      The menubar takes up the width of the screen less  2  pixels  for  the
      border.   The  width  of  the  crt  is determined by checking  the crt
      device file.

NOTES

      mainMenuBar should have an entry in the environment  description  file
      for  each  environment  in  which it is used.  See RtapEnvTable(4) for
      more details.

AUTHOR

      mainMenuBar was developed by tesserNet Systems Inc.

SEE ALSO

      menuConfig(1), RtapEnvTable(4)