When creating your output files, the creation of each file can be split into four separate stages, or events. At each one of these stages, you can specify a command or program to be run. These events, in particular the End of job event, are often used to perform a custom task, such as sending the file to a document management system or uploading the file to an FTP server once it has been created.

You can also use the Run commands to call functions in a DLL. See Using Run Commands to call DLL Functions for more information.

Show settings for

The four radio buttons at the top of the tab correspond to four distinct events during the printing process. You can configure a separate command to run for each event.

Stage

When it happens...

Start of job

occurs when the document is first sent to Raster Image Printer

Each page

each time we start processing a new page in the document

File close

each time the output file is closed; this can happen more than once for a single file

End of job

occurs when the created file (or each file if serialized output has been chosen) is complete and ready to be viewed

 

Event Settings

The settings shown in these fields correspond to the radio button selected above.

Enabled

Enable this check box if you want the command to run.

Command

Enter the full path to the command you want to launch. A command is limited to 128 characters in length.

The command does not have to be an executable (that is, .exe, .com, or .bat) In this case, the application associated with the file extension will open.

If the command is not an executable, and there is already an instance of the opening application running, then the Wait for completion and Wait with exit code options will not work. Instead, they will be replaced by a prompt.

Parameters

Type any parameters you need to send to your application. A list of parameters is limited to 255 characters.

When entering parameters:

Use blank spaces to separate parameters.

Enclose parameters that contain spaces in double quotation marks.

The default parameter for Each Page, File Close and End of Job is $(OutputFilePath), a variable which is replaced at runtime with the file path of the current document. Parameters in the format $(variable) will be replaced by runtime values before being passed to your application.

You can also access registry data directly with the $[registry key] syntax, and pass environment settings from the registry as parameters to your applications. See the Retrieving environment settings topic for more information.

Start in

You can specify a default working directory for your application. Note that some applications do not allow their default working directories to be overridden. The working directory is limited to 128 characters in length.

Window

Use this drop-down list to specify the window setting for your application. Note that some applications do not allow their default window settings to be overridden.

Normal - the application is displayed in its normal state. If the window is already open, and minimized or maximized, its original size is restored.

Maximized - the application is displayed as a maximized window.

Minimized - the application is displayed as a minimized window; its icon is visible on the task bar.

Hidden - the application is launched hidden from the user

Activate window

Enable this check box if you want the window in which your application runs to be activated (that is, in the foreground).

Wait for completion

Select this option if you want the print job to wait until the command terminates.

Wait with exit code

Select this option if you want the print job to wait until the command terminates successfully. If the command exits with an error, the print job will be canceled.

Do not wait

Select this option if you do NOT want the print job to wait until the command terminates.

Prompt to continue

Select this option if you want to be prompted to continue once the command has executed. This feature allows you to review the results before accepting them. If you choose No from this prompt, the print job will be canceled.

You can enter a customized prompting string up to 64 characters in length.

License

Launches the Activation Wizard as described in the Activating Raster Image Printer section if you are in trial mode.

If you have already activated Raster Image Printer , you will see a summary of your license information (see Viewing Your Activation Status for more details)

Restore Defaults

Restores this tab's settings back to the defaults when the driver was first installed.

Help

Brings up the on-line help for this tab.