Home > Commands A-M > Configuration I

INCLUDE


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

Includes the contents of one configuration block within another. You can use this command only in your CONFIG.SYS file.

The INCLUDE command is one of six special CONFIG.SYS commands used for defining multiple configurations within a single CONFIG.SYS file. With multiple configurations, you define a menu that appears when your computer starts. Each menu item corresponds to a block of commands, or "configuration block," in your CONFIG.SYS file. For more information about multiple configurations and configuration blocks, see the chapter "Configuring Your System" in the MS-DOS User's Guide.


Syntax

INCLUDE=blockname


Parameters
blockname (v2.0)
Specifies the name of the configuration block to include.

Switches

none.


Related

The INCLUDE command is one of six special CONFIG.SYS commands for defining multiple configurations. The other commands are for defining the startup menu:

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 three configurations:

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

    [base_config]
    DOS=HIGH
    DEVICE=C:\DOS\HIMEMSYS

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

    [net_config]
    include=full_config
    DEVICEHIGH=c:\net\network.sys

    [common]

This CONFIG.SYS file contains four configuration blocks. The [base_config] block contains two typical CONFIG.SYS commands. The [full_config] block includes the commands in [base_config] plus the DOS=UMB command, a DEVICE command, and a DEVICEHIGH command. The third configuration, [net_config], includes all the commands in [full_config], which in turn includes those in [base_config]. The [common] block appears at the end of the CONFIG.SYS file. It is a good idea to end your CONFIG.SYS file with a [common] block so that installation programs can successfully append commands to your CONFIG.SYS file.


Errorlevels

none.


Availability
External
DOS
v2.0 v2.01 v2.05 v2.10 v2.11 v2.11R v2.12 v2.2 v2.25 v3.0 v3.20 v3.05 v3.1 v3.21 v3.25 v3.30 v3.3A v3.3R v3.3T v3.31 v3.40 v4.0 v4.01 v4.01A v5.0 v5.0A v5.00.02 v5.001A v5.01 v5.02 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

Last Updated: 2003/07/28
Direct corrections or suggestions to: Rick Lively