adtExec Utility

The adtExec utility can be used to execute adTempus jobs from the command line. You can use this utility, for example, to start a job from a batch file, or to create a desktop shortcut that starts a job.

adtExec uses the same authentication as the adTempus Console: the user executing the utility must have Execute permission for the job.

adtExec has the following syntax:

adtexec job [options]

All parameters except the job are optional.

Parameter	Meaning
job	Specify the name (enclose in quotes if it contains spaces or other punctuation) or Job ID (available from the job properties window) of the job you want to execute.
-f	Forces a new instance of the job if another instance is already running. This is the default behavior.
-f-	Does not force a new instance of the job if another instance is already running.
-j	Ignores conditions for the job. This is the default behavior.
-j-	Does not ignore conditions for the job.
-s	Ignores conditions for steps.
-s-	Does not ignore conditions for steps. This is the default behavior.
-m	Forces the job to run on the Master computer.
-a	Runs the job on all enabled agents associated with the job. If not specified, job runs on the Master only.
-tstepNumber	Runs the job starting with the specified step number. (1 is the first step)
-c"checkpoint"	Passes the checkpoint you specify to the job.
-uuserID	Uses the specified Windows userID for authentication, rather than using the identity of the user running the program.
-ppassword	Specifies the password to use for the account specified with the -u parameter.
-rComputerName[:port]	Connects to adTempus on the specified remote computer, rather than on the local computer.
-w	Waits for the job to run. adtExec will submit the job, then wait for it to complete and report its status. If the job completes successfully, adtExec returns an exit code of 0. If the job does not complete successfully, adtExec returns an exit code greater than 0. If this parameter is not included, adtExec returns immediately after submitting the job and provides no further information about the status of the job.