Run Orchestration Jobs with the dmpexec Command :: SAS(R) Visual Process Orchestration Server 2.1: Administrator's Guide

Overview

You can execute orchestration jobs on the SAS Visual Process Orchestration Runtime Server with the command install-path/bin/dmpexec.

dmpexec Options

The dmpexec command accepts the following options:

Option	Purpose
-c filename	Reads a configuration file to set option values that are specific to the job or command.
-j file	Executes the job in the specified file.
-l file	Writes job log messages to a file. Specify different log files for different jobs, and for different runs of the same job, particularly when you are collecting log entries using the Job Monitor application in the SAS Environment Manager. For more information about the Job Monitor, seeCollect Job Status Information in the SAS Job Monitor.
-i key=value	Sets the input variable key to a value before running the job.
-o key=value	Sets a server option to a value.
-b key=value	Sets a job option to a value.
-a	Authenticates the user who is executing dmpexec. This option is required for domain-enabled connections. To successfully authenticate, you need to specify options that specify the authenticating server, user name, and password.

Note: You can use the -i, -b, and -o options multiple times to set multiple values.

Configure Authentication for dmpexec

When you specify the -a option in the dmpexec command, the Runtime Server requires that the following configuration options are set in configuration file app.cfg. The recommended method of specifying these options is to add them to a separate file, which you then identify with the -c option.

BASE/AUTH_SERVER_LOC=network-path:port defines how to connect to the SAS Metadata Server.

BASE/AUTH_SERVER_USER=user-name specifies the user name that will be authenticated by the SAS Metadata Server.

BASE/AUTH_SERVER_PASS=password specifies the password that is associated with the user name.

Return Codes for the dmpexec Command

The dmpexec command returns the following status codes:

Return Code	Reason
0	Job has finished successfully
1	Failure before start of job execution
2	Job was canceled
3	Job finished with errors: process terminated