Job Specification - Custom Processes

The Custom Processes page allows you to specify additional actions to be performed at the start or end of the GOexchange® maintenance job.

JobSpec_Wizard_CustProc_PageDefault_Small.png

A custom process can be any executable or batch file on the Exchange server.  This can be used to start or stop any Exchange-dependent services or trigger a backup of the Exchange databases.

Each GOexchange job supports two custom processes:

If there are multiple actions that you need to perform at the start or end of a job, we recommend composing a batch file.

NOTE: Custom commands are run as spawned processes via a non-interactive service.  So, when the custom command is run, it will not show up in any user session; instead it will be run in the background.  Therefore, when using this feature, be sure to only run commands that can complete on their own without any user interaction.

 

To add a custom process to your maintenance job:
  1. In either the Pre-Maintenance or Post-Maintenance Custom Process box, click on the ellipsis (...) button.

    CustProc_ProcessBox_BLANK_WithEllipsisHighlighted.png

    A dialog opens, allowing you to browse for the application or batch file you want to run.

    CustProc_BrowseDialog.png

  2. Select the desired application or batch file and click OK.

NOTE: If the custom process is 64-bit command, or is a batch file that includes 64-bit commands, you may need to include extra instructions to bypass x64 file system redirection.

For details, see: Problems using 64-bit programs as Custom Processes.

  1. Optional: If there are any special arguments needed by your executable or batch, add them to the end of the command in the Custom Process box.

    CustProc_Cmd_WithArgs.png

  2. For controlling how long GOexchange will give the custom process, set the Runtime Limit to Process Completion, Timeout, or both.

CustProc_RTL_Defaults.png

NOTE: If the custom process is a batch file, this is when the batch stops executing.  If the batch is written to launch some other background process and then complete itself, that background process could still be running when GOexchange sees the batch complete.

If possible, we recommend that you write your batch files to wait for all critical processes to complete.

NOTE: If you do not set a Timeout for your custom process, then we strongly encourage you to run the job as part of a schedule and to set a Runtime Limit on that GOexchange schedule.

  1. Set Treat Failure as... to either:

Proceed to: Backup

Back to: How do I create a job?