Using the 'exit' delivery method

The exit delivery method lets you set up automatic responses to system events beyond just sending a message. When you set the delivery method for a given event to exit, you use the delivery address to specify the explicit path to a script or program on your system. Whenever that event occurs, InfoPrint Manager runs the script or program you specify.

For example, if the InfoPrint Manager server runs low on disk space, the disk-space-low event generates a message for the system administrator. The administrator then has to do something to clean up the disk so InfoPrint Manager can continue to run effectively. However, using the exit delivery method can automate that process by launching a "disk clean up" script. The administrator can still receive the message, but will know that the script is already working on the problem.

If you are using the Print Optimizer DSS, InfoPrint Manager provides a sample script called poexitcleanup that you can use with the exit delivery method. The script demonstrates one way that you can automate cleaning up disk space in the Print Optimizer resource filesystem after the disk-space-low event occurs.

By default, when you use the exit delivery method, InfoPrint Manager only passes two values along to the script or program: the message number of the event that occurred and the text of the message. As a result, the command line that the exit delivery method executes is composed of the path that you specified in the delivery address, the last three digits of the message number, and the text of the message.

Therefore, if you create a notification profile entry for the job-completed event, setting the delivery method to exit and the delivery address to c:\Infoprint\exits\myscript, when a job finishes printing, InfoPrint Manager will generate and execute a command line similar to this one:

c:\Infoprint\exits\myscript 280 "5010-280 Finished processing job ofc, 
Job 20 (3520800004)."

The scripts or programs you write might require other information, such as the destination name or the printer model. To pass those values, you can include them in the delivery address of the notification profile entry; they will be added to the end of the command line when InfoPrint Manager creates it.

Note: The program run by a notification profile with the "exit" delivery method runs under InfoPrint Manager, which is running as a Windows service and does not have access to the desktop. Because of this, the notification method of "exit" does not allow a delivery address that requires a windowed program to be used, such as notepad.exe.