This documentation supports the 9.1 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

BMC Remedy Assignment Engine application commands

To support interaction between the AR System server and BMC Remedy Assignment Engine, use the Application-Command process. You can run this process from filters, escalations, and active links by using the Run Process action.

Application-Command process

The Application-Command process allows the specification of commands to be executed by an application. Whenever an Application-Command process is run, a request is created in the Application Pending form that contains details about the command. The Application Dispatcher retrieves commands from this form and passes them to BMC Remedy Assignment Engine for processing. If the Application Dispatcher is not in use, BMC Remedy Assignment Engine retrieves commands directly from the Application Pending form.

Application-Command commands use the Run Process action. As with all Run Process actions, you should use quotes around a parameter when its value contains a space, to make sure that it is evaluated correctly. 

Application-Command processes exist on the AR System server. If you are performing an operation from an active link, you must use the syntax that indicates that the process should be run as a remote process on the server.

For more information, see Run Process action, Using Run Process and $PROCESS$ commands and Keywords.

Assignment Engine server commands

This section lists all commands that are defined for BMC Remedy Assignment Engine server. Most of the commands are used automatically by BMC Remedy Assignment Engine and its workflow.

Use these commands as the command parameter for Application-Command processes. You must precede each command with Application-Command. The following commands can be run from filters, escalations, and active links.

Command  to force BMC Remedy Assignment Engine to build its runtime cache

Application-Command AE-CACHE DoCache[-s formName]  [-e requestID] [-t operation] [-o processInstanceID] [-I processName]
Runs a specified Assignment Engine process. This command forces BMC Remedy Assignment Engine to build its runtime cache. The runtime cache consists of processes, forms, and rules that are currently configured with BMC Remedy Assignment Engine in the ASE:Administration form. When this command is run, BMC Remedy Assignment Engine re-builds its cache by caching data from the ASE:Administration form.

Note

During runtime, BMC Remedy Assignment Engine cache is updated if there are any changes in processes, forms, or rules. You need not run this command manually. However, if started manually, the command builds BMC Remedy Assignment Engine's runtime cache.

This command takes the following arguments:

  • -sformName is the name of the form on which you are executing the command.
  • -erequestID of the process or form or rule, the cache of which is being updated. Please note this has nothing to do with 'Assignment' requests]. For active links, the request ID is required. For filters, it is optional.
  • -tOperation carried out on the process (CREATE, DELETE and MERGE).
  • -IprocessName is the name of the process to run. It must match the process name in the Processes tab of the Assignment Engine Administration Console.
  • -oprocessInstanceID is the unique ID of the process.
    For information about the Assignment Engine, see Assigning requests with the Assignment Engine.
    For example:
    Application-Command AE-CACHE DoCache -t $OPERATION$ -o $Process InstanceId$ -l $Process Name$

Command to run a specified BMC Remedy Assignment Engine process.

Application-Command AE-ASSIGN DoAssign [-t processName] [-e requestID]
This command runs a specified BMC Remedy Assignment Engine process.
This command takes the following arguments:

  • -tprocessName is the name of the process to run. It must match the process name in the Processes tab of the Assignment Engine Administration Console.
  • -erequestID is the ID of the request on which the process will run. For active links, the request ID is required. For filters, it is optional.

    For example, to run the AE:Sample Help Desk Assignment Process on the request with ID 000000001:
    Application-Command AE-ASSIGN DoAssign -t "AE:Sample Help Desk Assignment Process" -e "000000001"

    Note

    If you want to configure two processes, which have the same name, to work with BMC Remedy Assignment Engine, you must pass the process instance ID to the -t parameter.

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Brian Gillock

    Can you please change AE-Assign to AE-ASSIGN. It's case sensitive and someone may copy/paste from the wrong place. Thank you.

    Jun 25, 2020 04:35
    1. Anagha Deshpande

      Hello Brian,

      Thanks for bringing this to our notice. We have corrected the topic.

      Regards,

      Anagha

      Jun 30, 2020 05:50