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.
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.
When it happens...
Start of job
occurs when the document is first sent to Raster Image Printer
each time we start processing a new page in the document
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
The settings shown in these fields correspond to the radio button selected above.
Enable this check box if you want the command to run.
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.
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.
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.
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
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.
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)
Restores this tab's settings back to the defaults when the driver was first installed.
Brings up the on-line help for this tab.