APPEND COMMAND

Purpose:  Sets appended directories for data files search.

Syntax :  For first use only:
          APPEND [/X[:ON | :OFF]] [/PATH:ON | /PATH:OFF] [/E]

          To specify directories to be searched:
          APPEND [drive:][path][;[drive:][path] ... ]

          To delete appended paths:
          APPEND;

Type:     External command

Description:

     The APPEND command allows you to specify a search path for data files
and executable modules. If PTS-DOS doesn't find the needed file in the
current directory, it tries to find it in directories, specified in the
option of the APPEND command or in the current process environment variable.

     If the APPEND command is invoked without the /X switch or with the
/X:OFF switch, it will act only for the "open file" system calls  - (int
21h, Functions 3Dh,6Ch).

Parameters:

/X or           Extends the command action on system calls "execute"
/X:ON           (int 21h, Function 4Bh), "find first" (int 21h, Function
                4Eh).
/X:OFF          Turns off the /X:ON switch.
/E              In this case PTS-DOS will use the appended search paths,
                specified in the variable of the APPEND environment.
/PATH:ON        Indicates that, if searched files are specified with the
                drive and/or with the search path, PTS-DOS should search for
                them in the appended directories, specified by the APPEND
                command, in case these files are not present in the
                indicated place.
/PATH:OFF       Indicates that, if searched files are specified with the
                drive and/or with the search path, PTS-DOS should not search
                for them in the appended directories, specified by the
                APPEND command, in case these files are not present in the
                indicated place.

     You may specify several appended directories, separating them with a
semicolon - ";". If you start the APPEND command with the option a second
time, the old directory list will be replaced by the new one. If the APPEND
command was started with the /E switch, you may change the directory list by
redefining the variable of the APPEND environment.

     If you start the command without options, the current list of the
appended directories will be displayed.

     You can temporarily abort the execution of the APPEND command by
specifying NUL directory as an option:

        APPEND ;

It means that PTS-DOS will search for files only in the current directory.

Notes:
1. You can use the APPEND command in the network to access the network
   files.
2. If you use the ASSIGN command, you must start APPEND before starting
   ASSIGN.
3. If you want to set a search path for executable modules or external
   commands, you should better use the PATH command.

Example:
     Suppose you want to access data files in the PTSDOS directory on
drive C and in the EXE directory on drive A. To do this, use the following
command:

     APPEND C:\PTSDOS;A:\EXE