Marc's Place

DIBIOL/DBL - DBLMENU$ Subroutines

The MENU subroutines are physically contained with the DBLOSSL library, but are
logically separate.  These subroutines provide the program interface to the DIBOL
menu facility.  Two entry points are provided for each menu subroutine.  One entry
point is the entry point for the actual code within the DBLOSSL library.  The other
entry point is used for compatability with the PDP-11 version of the menu facility,
and simply jumps to the primary entry point.  In the descriptions of the MENU
subroutines, the PDP-11 entry point is shown in parenthesis.

DBLMENU$INIT

       DBLMENU$INIT (M$INIT) initializes the menu interface, opens the
       terminal and loads the menu from the menu file.

          XCALL DBLMENU$INIT ({func}, progid {,menufile {,submenu}})


DBLMENU$EXIT

       DBLMENU$EXIT (M$EXIT) terminates the menu interface and closes the
       terminal.

          XCALL DBLMENU$EXIT ({func})


DBLMENU$MESSAGE

       DBLMENU$MESSAGE (M$MSG) displays a message on the message line of the
       menu.

          XCALL DBLMENU$MESSAGE ({func}, message)


DBLMENU$SETCH

       DBLMENU$SETCH (M$SET) changes the default channel numbers used by the
       menu routines.

          XCALL DBLMENU$SETCH ({ttchan} {,otherchan})

       The defaults used are 255 for the terminal channel and 254 for the
       other channel.


DBLMENU$SELECT

       DBLMENU$SELECT (M$SLCT) allows the user to select an item from the
       menu and returns information on the selected item.

          XCALL DBLMENU$SELECT ({func}, action, dvalue, avalue, {avalsize},
                                {input {,inpsize}}, {menufile {,submenu}})


DBLMENU$PARAMS

       DBLMENU$PARAMS (M$PRMS) substitutes parameter fields defined in the
       menu with program-specified text.

          XCALL DBLMENU$PARAMS ({func}, p1 {,..., p20})


DBLMENU$PAUSE

       DBLMENU$PAUSE closes the terminal channel and (optionally) clears the
       screen.

           XCALL DBLMENU$PAUSE {function}

      function

         function is a numeric expression which modifies the default action of
         the subroutine.

                     Non-Zero  - do not clear the screen.

                     Zero      - clear the screen.


DBLMENU$RESUME

       DBLMENU$RESUME reopens the terminal channel when returning from a SPAWN
       and (optionally) refreshes the screen.

           DBLMENU$RESUME {function}

      function

         function is a numeric expression which modifies the default action of
         the subroutine.

                     Non-Zero  - do not refresh the screen.

                     Zero      - refresh the screen.
© 1997- Marc Vos (and others) Contact Me