# Utilities

*TOOLS/COPYDIR | Copy Directory and its Contents

## Invocation

CALL "*tools/copydir", source_dir$, dest_dir$, recursive

Where:

source_dir$ | Source directory to copy.
dest_dir$ | Destination directory where the copy should be created. If left blank, the destination directory will be the current directory.
recursive | Flag indicating whether the copy should recursively copy all sub-directories and their contents.

## Description

Copy the source directory and its contents to the destination directory.

(The CopyDir utility was added in PxPlus 2021 Update 1.)

## Example

In this example, the utility will copy the directory "myData" and its contents, including all sub-directories and their contents, to the "backup" directory:

> call "*tools/copydir","myData/","backup/",1