mainMenuBar - User Defined MenuBar
mainMenuBar -p menuPtName [-h heapsize] [-f font] [-b bg_colorname] [-g fg_colorname] [-v env_var] [-l lock_program] [-n] [-o lock timeout (minutes)]
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.
mainMenuBar should have an entry in the environment description file for each environment in which it is used. See RtapEnvTable(4) for more details.
mainMenuBar was developed by tesserNet Systems Inc.
menuConfig(1), RtapEnvTable(4)