Creating a Run Process action

Use the procedure below to define a Run Process action.

Remember the following guidelines for command-line syntax:

For external processes, adjust the command syntax appropriately for the platform on which the server is running, and include the explicit path to the command; for example, /home/jim/bin/ command.
In the Windows environment, specify the drive; for example, d:\home\jim\bincommand.bat.
In the UNIX environment, the process runs under a Bourne shell.
On a Windows server, you can only run a process that runs in a console (such as a .bat script or an executable like runmacro.exe ).
Use double quotation marks around substituted fields when the values might contain spaces or other special characters; for example, /bin/cmd"$ field$".
Substituted field values that contain hard returns or other special characters can have unexpected results.
The AR System server does not interpret environment variables for the Run Process action. To use environment variables, the action must run in the context of a command window or shell on the client or server computer. Therefore, include the path to the command-line executable in the command-line statement, as in the following Windows example (cmd.exe ):
"C:\Program Files\I386\cmd.exe %windir%\system32\mplay32.exe %windir%\Media\chimes.wav".
For UNIX, you must include a reference to /bin/sh in the path. For examples using the Run Process action to integrate AR System server with other applications, see Using-buttons-and-menu-bar-items-to-execute-active-links.

To define the Run Process active link, filter, or escalation action

As a Remedy developer, you can add a run process to active links, filters, or escalations. The run process is recognized by BMC Remedy AR System server or client which performs the operations directly.
In Developer Studio, add an element to the view, such as a field or button.
Select the button or field and create a new active link.
Select New > Active Link.
Select a server in the Select Server dialog box.
The Untitled Active Link screen appears.
In the Associated Forms section, click Add.
The Form Selector dialog box opens.
Select the form in the Progressive View which has the element such as a field or button to which you want to add the active link.
Right-click the If Action or the Else Action panel header.
Select Add Action > Run Process.
In the Command Line field, enter the command to execute.
You can type the command or you can build the command by using the Expression Editor dialog box. You can include the values from fields from the primary form and keywords in the command, and you can select a process from the list of BMC Remedy AR System server processes.
- If an expanded value contains spaces, you must insert double quotation marks around the parameter so that the operating system interprets it as a single value.
- The fully expanded command line cannot exceed 4096 bytes.
Save the active link, filter, or escalation.