Please enable JavaScript to view this site.

TIFF Image Printer

Navigation: Working with TIFF Image Printer > Using the Run Commands

Execute a Command for Each File Created

Scroll Prev Top Next More

Prior to version 12, the Run at End command was triggered for each file created, and the name of each file created could be passed to the command using a macro, $(OutputFileName). Other macros could also be passed to the command.

As of version 12, there are now two Run at End commands, On Success and on Failure. one which runs on success after all the files have been created, and one which runs on failure. Both commands always includes a text file containing a list of any files created as the last parameter. The Run at End commands are are different from the End of Job command. The End of Job command always runs when the print job is finished, while only one of On Success or On Failure runs, depending on the state of the print job.

The included PNExec12.exe tool allows you to reproduce the previous Run at End command behavior in the current version. It allows you to execute a command ( *.exe) for each file created, making it easier to migrate from earlier versions.

PNExec12.exe Utility

The included utility has been provided in the RunCommands folder in your TIFF Image Printer install folder. This is usually C:\Program Files\TIFF Image Printer 12\RunCommands\.

PNExec12 Macros

There are two extra Run Command macros that can only be used with this utility:

$(OutputFilePath)

The final output file, a fully qualified path to the created file, in quotation marks.

$(OutputFilePathNoQuotes)

Same as $(OutputFilePath), but without quotation marks.

 

Command Line Arguments

/C="path to command"

Required, pass in the full path to the command to execute. Use quotes if there are spaces in the path. Single quotes can also be used.

/A=" 'arg 1' arg2"

Optional, extra arguments to pass to the command.

Use double quotes around the entire argument string, and single quotes around any argument in the string that needs to be passed quoted. Optionally, you can use single quotes around the entire argument string and double quotes around any argument in the string that needs to be passed quoted.

/A='"arg 1" arg2'

This argument can contain the $(OutputFilePath) or $(OutputFilePathNoQuotes) macro. If it does, the macro is replaced with the name of the file from the file list for each file we run.

If the macros are not present in this argument, or this argument is not used, the quoted file name for the file in the list the command is being run for is appended to the end of the command.

Other run command macros can also be used here.

/WAIT=<time in seconds>

Optional; how many seconds PNExec12.exe will wait for the command to complete.

When not provided or a negative number - waits indefinitely for the command to finish (complete)

If set to 0 = does not wait for the command to complete

If greater than 0 - waits that many seconds for the command to complete

PNExec12 Logging - If there is an error running the command, a log file is created in the %TEMP% folder. The log file name has the pattern pnexec12-{GUID}.txt.

Sample Migration For Run Commands

For users migrating from the older-style commands from version 11 or previous, the following shows the changes needed to update your commands for version 12 and later. To see how to add a new command, go to the step-by-step instructions below.

Single Argument Command

This is a sample run at end command in TIFF Image Printer 11.0 using ArchiveUpdate.exe, a fictional utility used for demonstration only. It is not an included utility. This utility expects the full path to the output file that was created.

TIFF Image Printer 11.0 End of job settings in Printer Preferences:

RunAtEndVersion11UI

TIFF Image Printer Script File settings for Run at End :

[Run]

RunAtEnd enable=1

RunAtEnd command=C:\CustomActions\ArchiveUpdate.exe

RunAtEnd parameters=$(OutputFilePath)

RunAtEnd directory=

RunAtEnd window=Hidden

RunAtEnd window active=0

RunAtEnd wait=0

RunAtEnd prompt=Do you want to continue?

In TIFF Image Printer 12, using the PNExec12.exe utility in the profile to call the fictional ArchiveUpdate.exe for each output file created would look like the following:

RunCommandsUsingPNExec12

 

Multiple Custom Arguments Command

This is a sample run at end command inTIFF Image Printer 11.0 using UpdateDatabase.exe, a fictional utility used for demonstration only. It is not an included utility. This utility takes some custom arguments, the JobID of print job and full path to the output file that was created.

TIFF Image Printer 11.0 End of job settings in Printer Preferences:

RunAtEndWithArgumentsVersion11UI

TIFF Image Printer Script File settings for Run at End :

[Run]

RunAtEnd enable=1

RunAtEnd command=C:\CustomActions\UpdateDatabase.exe

RunAtEnd parameters=/U /ID=$(JobID) $(OutputFilePath)

RunAtEnd directory=

RunAtEnd window=Hidden

RunAtEnd window active=0

RunAtEnd wait=2

RunAtEnd prompt=Do you want to continue?

In TIFF Image Printer 12, using the PNExec12.exe utility in the profile to call the fictional ArchiveUpdate.exe for each output file created would look like the following.

RunCommandsUsingPNExec12WithArgs

 

Step by Step Instructions

The steps below demonstrate how to use the PNExec12.exe tool and the new Run Commands tab to call a fictional utility, ArchiveUpdate.exe that takes the full path to the output file that was created. This tool name is for demonstration only and is  not an included utility.

1.Launch the TIFF Image Printer Dashboard.

LaunchDashboard

 

2.Select "Edit & Create Profiles" to open Profile Manager.

3.Select "Add a profile" to create a personal profile, or create a copy of one of our system profiles.

4.Name the profile, add a description, and click Save.

5.On the Run Commands tab, click the On Success button to add an On Success command.

AddSuccessRunCommand

 

6.The command will be added already enabled and the details expanded. Beside Run this command, enter the full path and file name of the PNExec12.exe:

RunCommandsUsingPNExec12Command

7.In the Use these parameters field, add any parameters needed by the command being run. For our fictional tool, we only need to pass the full output file name. We can do this using the macro $(OutputFilePath). The PNExec12 utility will automatically replace this value with the quoted output file path from text file when it processes the list of files created.

RunCommandsUsingPNExec12

 

8.Click Save-Back, and close Profile Manager.

 

If you choose to enable run commands, you may also want to disable prompting by the Save As dialog each time you print.

i.To turn off prompting by the Save As dialog, disable Prompt for the output location and base file name.

DisablePrompting

 

If you plan to use these settings regularly, you may wish to make this personal profile the default profile used by TIFF Image Printer.

 

i.Select "Manage Printers" to open Printer Management.

i.Select the printer you wish to edit and use the Profile drop box to select your desired default profile.

ii.Select the Save icon to save changes.

iii.Select the Home icon to return to the Dashboard.

 

9.Close the Dashboard. Now when you print your document to TIFF Image Printer, you will receive an email notifying you if the print is a success or failure.