Prinergy System Admin Guides 9.5

Space shortcuts

Page tree

Use the Raise Event tool to trigger RBA rules from another computer.
The rule set that you want to trigger must exist and must contain a Remote Trigger root event.

  1. On the remote computer that will send the trigger (for example, a Prinergy secondary server), install the Raise Event software (RaiseEvent.exe) by following these steps:
    Note: If the remote computer is a Prinergy primary server, skip this step. The Raise Event software is already installed.
    1. Ensure that Microsoft .NET Framework is installed on the remote computer. If .NET Framework is not installed, download it from the Microsoft Web site and install it. Install .NET Framework version 2.0.
    2. On the network, navigate to the Prinergy primary server, open the C:\Program Files (x86)\Kodak\RBA\bin folder, and copy the RaiseEvent.exe file to the remote computer.
    3. Make a note of the path to the RaiseEvent.exe file on the remote computer.
  2. From the remote computer, send the trigger using the Raise Event tool. You can use the tool in any of the following ways:
    • Configure software (such as MIS software) to use the Raise Event tool to send a specific Windows command to the Prinergy primary server.
    • Open a command-prompt window, locate the folder containing the RaiseEvent.exe file, and type:
      raiseevent <ruleset> [<strings>] [-host <hostname>] [-port <portnumber>] [-context <context>] [-files <paths>] [-dirs <paths>] [-ip <ipaddress>] [-wait <timeout> [-waitport <waitport>]]
      Replace the variables in the command using the following guidelines:

Variable

Description

ruleset

The full path of the rule set that you want to trigger, starting with the directory where it is located and ending with the rule set's name. Separate groups with a / symbol (forward slash). The path is case-sensitive. If the path contains a space, enclose the path in quotation marks.

strings

(Optional) Up to twelve strings (alphanumerical data), numbered from 0 to 11. This is useful if you want to communicate text data to the recipient rule set.

-host <hostname>

(Optional) The name of the Prinergy primary server. Omit this parameter if you are on the primary server.

-port <portnumber>

The port on the primary server for the command to connect to RBA—for example, 61235.

-context <context>

The context or environment where the rule set is enabled. If it is enabled in a job context, enter the job name or GUID (the globally unique identifier for the job).  The System context is the default context if no context parameter is specified.

-files <paths>

(Optional) One or more file paths, separated by semicolons. This is useful if you want to communicate file paths to the recipient rule set.
Tip: To easily send all the files in a directory, type the path of a directory. The tool automatically replaces the directory name with a list of the paths of all of the files in the directory.

-dirs <paths>

(Optional) One or more directory paths, separated by semi-colons. This is useful if you want to communicate directory paths to the recipient rule set.

-ip <ipaddress>

The IP address shown to the primary server. This parameter applies only to computers with more than one network card.

-wait <timeout>

How long to wait before triggering the rule set.

      • +<timeout> waits for the <timeout> period.
      • -<timeout> waits until the triggered rule set completes.

-waitport <waitport>

The port that the Raise Event software should monitor to receive the message from the server to stop waiting. If unspecified, any available port is used.

For example, raiseevent "Remote Trigger Create Job" -host MyServer -port 61235 -context Customer123


    • Use a batch file to start the Raise Event tool. For example,

ECHO ON
REM This batch file sends a command to a specific server and the RaiseEvent tool,
REM which triggers a specific rule set and passes it up to six strings.
REM
REM Notes
REM - EXEPATH must use a drive letter, not a UNC name. The default location of
REM RaiseEvent.exe is drive C.
REM - RULEPATH is the path of the rule set groups. It is case sensitive. If spaces exist,
REM surround it in quote marks
REM - JOB is the job name (for a job rule set) or "SYSTEM" (for a system rule set).
REM
SET EXEPATH="C:\Program Files\Kodak\RBA\bin\RaiseEvent.exe"
SET RULEPATH=Test/RaiseEvent/RemoteTrigger_WriteText
SET STR1="String1"
SET STR2="String2"
SET STR3="String3"
SET STR4="String4"
SET STR5="String5"
SET STR6="String6"
SET PORT=61235
SET SERVER=Test
SET JOB=Test
SET CMD=%EXEPATH% %RULEPATH% %STR1% %STR2% %STR3% %STR4% %STR5% %STR6% -host %SERVER% -port %PORT% -context %JOB%
REM
%CMD%
Pause