Home > Commands N-Z > Configuration S

SUBMENU


Description | Syntax | Parameters | Switches | Related | Notes | Examples | Errorlevels | Availability

Defines an item on a startup menu that, when selected, displays another set of choices. You can use this command only within a menu block in your CONFIG.SYS file.

The startup menu is a list of choices that appears when you start your computer. You define a startup menu by using special CONFIG.SYS commands. Each item on the menu corresponds to a set of CONFIG.SYS commands called a "configuration block." A startup menu makes it possible to start your computer with a variety of configurations. For more information about defining multiple configurations, see the chapter "Configuring Your System" in the MS-DOS User's Guide.


Syntax

SUBMENU=blockname[,menu_text]


Parameters
blockname (v6.0)
Specifies the name of the associated menu block. The menu block must be defined elsewhere in the CONFIG.SYS file and can contain menu-definition commands. Unlike the "main" menu block, which must have the block name [MENU], a menu block for a submenu can have any name you want. If the operating system cannot find a block with the specified name, the item does not appear on the startup menu. The block name can be up to 70 characters long and can contain most printable characters. It cannot include spaces, backslashes (\) and forward slashes (/), commas, semicolons (;), equal signs (=), and square brackets ([ and ]).
menu_text (v6.0)
Specifies the text you want the operating system to display for this menu item. If you don't specify any menu text, the operating system displays the block name as the menu item. The menu text can be up to 70 characters long and can contain any characters you want.

Switches

none.


Related

The SUBMENU command is one of six special CONFIG.SYS commands for defining startup menus and multiple configurations. The other commands are as follows:

For an overview of the procedure for defining multiple configurations, see the topic "Commands for Defining Multiple Configurations".


Notes

none.


Examples

This CONFIG.SYS file defines a main startup menu and one submenu:

    [menu]
    MENUITEM=base_config,Base configuration only
    MENUITEM=full_config,Normal configuration
    SUBMENU=netmenu,Normal configuration with network

    [netmenu]
    MENUITEM=lanman,Start Microsoft LAN Manager
    MENUITEM=vines,Start Banyan VINES

    [base_config]
    DOS=HIGH
    DEVICE=C:\DOS\HIMEM.SYS

    [full_config]
    INCLUDE=base_config
    DOS=UMB
    DEVICE=C:\DOS\EMM386.EXE RAM
    DEVICE=c:\dos\ramdrive.sys 512

    [lanman]
    INCLUDE=full_config
    REM Commands for Microsoft LAN Manager would go here.

    [vines]
    INCLUDE=full_config
    REM Commands for Banyan VINES would go here

This CONFIG.SYS file provides a choice of four configurations: a basic configuration (base_config), a full configuration (full_config), and two network configurations. Both network configurations include all the commands in the full configuration; the lanman configuration runs Microsoft LAN Manager and the vines configuration runs Banyan VINES network software. To choose a network configuration, the user first selects item 3, "Normal configuration with network," from the main menu. the operating system then displays the network choices on the submenu.

When the operating system starts, it displays:

    MS-DOS Startup Menu
    ===================

       1. Base configuration only
       2. Normal configuration
       3. Normal configuration with network

    Enter a choice: 1

If item 3 is selected, the operating system displays:

    MS-DOS Startup Menu
    ===================

    1. Start Microsoft LAN Manager
    2. Start Banyan VINES

    Enter a choice: 1

Errorlevels

none.


Availability
External
DOS
v6.0 v6.10 v6.2 v6.21 v6.22 v6.23 v7.00 v7.0R1 v7.10 v8.00
Windows
none
Windows NT
none