Home > Commands A-M > Commands J

JOIN


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

Allows access to the directory structure and files of a drive through a directory on a different drive.

Warning: DO NOT use these commands while a Join is in effect: ASSIGN, BACKUP, DISKCOMP, DISKCOPY, FORMAT, RESTORE. or SUBST.


Syntax

JOIN d: [d:path]

To disconnect a previously joined drive:

JOIN [d:] [/D]


Parameters
d: (v3.1)
Drive to connect / disconnect.
d: ( path v3.1)
Drive and directory name to give it. If the directory you specify in the second parameter does not exist, DOS will create it. If the directory does exist, it must be empty.

Switches
/D (v3.1)
Used to disconnect a joined drive.

Related

none.


Notes
Attempts to access a joined drive

After joining a drive to a directory, the files stored on the joined drives can be accessed as if they were on the specified directory. Attempts to access the joined drive will result in the display of the error message:

    Invalid drive specification

Join to a directory containing files

If you try to join a directory containing files, the program will display the error message:

    Directory not empty

Join to current directory

You cannot join the current directory. Also, you cannot join to a directory that is more than one level below a root directory or to the root directory itself.


Examples

To join drive B: to the directory FILES on drive A:, enter:

    JOIN B: A:\FILES

If you now ask for a directory of A:\FILES, the files stored on drive B: will be displayed. After entering this command, attempts to access drive B: will result in the error message:

    Invalid drive specification

To disconnect the join established in the previous example, enter:

    JOIN B: /D

Errorlevels

none.


Availability
External
DOS
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
Windows
none
Windows NT
none
External Supplemental disk
DOS
v6.0
Windows
none
Windows NT
none