AMProcess

When a Process Object is used within a workflow, a dataset called AMProcess is automatically created. This dataset can be used within an associated task to determine specific characteristics regarding the executed process (i.e. name, output, Agent name, etc.).

AMProcess is a standard AutoMate dataset and can be used much like the datasets created by the SQL Query and Get E-Mail action. For example, using a 'Message Box' action with the Message to Display field entered with:

%AMProcess.Name%

would display a message dialog during task execution showing the name of the process that executed.

Parameters

Every instance of AMProcess is populated with the following fields:

Name

Data Type

Return Value

AMProcess.Output

String

Returns the output of the command sent by the Process object. For example, if the command sent was Dir, AMProcess.Output would return all of the text of the file listing.

AMProcess.Result

Boolean

Returns the execution result of the command sent by the Process object.

AMProcess.AgentName

String

Returns the assigned name of the Agent that the Process object executed on.

AMProcess.AgentID

String

Returns the unique ID of the Agent that the Process object executed on.

AMProcess.Name

String

Returns the assigned name of the Process object that executed.

AMProcess.ID

String

Returns the unique process ID of the Process object that executed.

AMProcess.CommandLine

String

Returns the command sent by the Process object that executed.

 

See Also

Process Agents

Process Object