Installing the Report Output Control System

The Report Output Control System (ROC) is an optional module, which you can install. You can browse or print reports using the Report Output Control system. When you start the ROC system, you temporarily leave your application. ROC is a separate system that controls report output for all applications within a given database.

To install the Report Output Control System, perform the following:

  1. Use the Runtime Administration tool to add a Database Server Registration called “default”. Refer to Adding a Database Server Registration for more information.

  2. Open the Command Prompt window as Administrator and use the Change Directory command to go to the <Installation Directory\ROC> directory. For example C:\program files\Unisys\...\Roc.

  3. Run the ROC installation script ”InstallRoc.js” contained in that directory, passing the Application User login name, the Application User password, and the Application User domain as parameters.

    The syntax is

              cscript InstallRoc.js <Application-User’s login-name> 
          <Application-User password> <Application User’s domain>

    For example:

              cscript InstallRoc.js AppUser App1User .

    Note: The “.” period in the example signifies the local machine as a domain.

    When the script runs, it performs the following actions:

    1. Checks if you have a registration called “default”.

    2. Creates a database called “ROCDB”, if you do not already have one.

    3. Installs ROC from a RocSystem.msi, after the installation of the Report Output Control System is completed successfully.

    4. Deploys ROC and displays a message after a successful deployment.

Note: You can use the DeployPackage Runtime API to override the default values in the script to install ROC system. For example, the following command run from a command prompt as an Administrator, installs ROC System under a “NonDefault” Database Server registration with “NewROCDB” as its Runtime Database. 

DeployPackage /L <Absolute path of ROCSystem.msi> /U <Application User Login Name>
/P <Application User Password> /TSN localhost /TDBR NonDefault /TDBN NewROCDB