# [Setup Command Execution] dialog box

Use this dialog box to set up an external command.
This dialog box appears when you add a plug-in to run the external command. When you run the start command execution plug-in, the command file specified in this dialog box starts.

### [Path Name]

Specify the file name and full path of the external command to execute. You can enter full path or click [Browse] to select the file.
You can enter a command line option after the path name of the external command.

### [Browse]

Displays the [Open] dialog box and select a command file.

### [Start-up Directory]

Specify the path of the working directory for the command file.

### [Execute parallel]

Select this check box if you want DocuWorks to continue while the external command is being executed. If this box is cleared, control does not return to DocuWorks until the external command is finished.

### [Setup Document Parameters]

#### [Pass Selected Documents]

Passes the path name of the selected file or folder to the external command. If the check box is cleared, the file or the folder will not be passed to the external command.

#### [Pass Double Quoted Document Name]

By selecting this box, you need to enclose the file name in double quotations (") when passing the file to the external command. If the check box is cleared, then the document is passed without enclosing the name with double quotations.

#### [Pass MS-DOS File Name]

By selecting this box, you need to pass the document name in the MS-DOS file format (i.e. 8 alphanumeric as filename plus 3 alphanumeric as file extension) to the external command. If the check box is cleared, then the document name is passed as it is.
Choices:
[Run Regardless of Number of Documents Selected] / [Run When Single Document Selected] / [Run When Multiple Documents Selected]

- [Run Regardless of Number of Documents Selected]
  Run the external command regardless of whether a DocuWorks document is selected or not.
- [Run When Single Document Selected]
  Run the external command only when one DocuWorks document is selected.
- [Run When Multiple Documents Selected]
  Run the external command when one or more files are selected.

Note

- If you select [Execute parallel] in the [Setup Command Execution] dialog box, the file selected at the start of the external command can be manipulated in Desk during the time the external command is executed. If the [Pass Selected Documents] in the [Setup Document Parameters] is selected at the same time, we recommend not to manipulate them in Desk while the external command is running.
- When the external command is set to handle files of other formats, shortcuts, and folders, you can select them as well as the DocuWorks documents and binders.
- If [Execute parallel] is selected in the [Setup Command Execution] dialog box, you can continue to use Desk while the external command is running.
- If command line options are specified, they overwrite the following values and are passed to the command as parameters.

- %F File name
- %P Current page
- %D path name corresponding to the folder currently open in Desk

- If Desk is in list view and the displayed page of %P is specified, the [Page Selection] dialog box appears so that you can specify a page to send to the external command. If the document other than DocuWorks files is selected, the specification of %P will be invalid.