IBM Support

Rational Method Composer command line options

Education


Abstract

IBM Rational Method Composer (RMC) has a number of command line options that configure how RMC behaves when launched. RMC can also be executed from a batch script, and the command line options can be used to performed repetitive operations, such as publishing. This article describes each of the command line options, and what it does.

Content

RMC is launched from the command line as follows:

<install directory>rmc.exe parameters

where parameters can be:

-data workspace path
or
-rmclibrary library path

    RMC always opens a library when launched. You can either specify a workspace-based library to open, or a standard library.
      • "-data workspace path" is used to open a workspace-based library
      • "-rmclibrary library path is used to open a standard library.
    If no library is specified, the default library is opened (the RMC Practices library that is installed with RMC).

-nl language
    Specify a language to use. Language choices are:
    ar - Arabic
    da - Danish
    de - German
    en - English
    es - Spanish
    fr - French
    it - Italian
    ja - Japanese
    ko - Korean
    po - Polish
    pt_BR - Brazilian Portuguese
    ru - Russian
    zh_CN - Chinese (Simplified)
    zh_TW - Chinese ( Traditional)

    Refer to the release notes for the RMC version to identify what languages are supported, what has been translated for each language, and how to install the different languages.

-rmcsilent
    Indicates that RMC is to execute in batch mode. It must always be followed by another argument indicating the type of operation. At this time, the only operation we officially support for batch mode is publishing, and the key word for it is "publish":

    publish -rmcconfiguration configuration name -rmcoutput output path-rmcwebtype [war|ear|static] -rmcwebappname web app name -rmcsearch [php|php-zend|servlet-rss]
      RMC will publish the specified configuration to the specified output path location, and then exit.

      “rmcwebtype” specifies the type of the web site set for publishing, with choices of “war”, “ear”, and “static”. If the “rmcwebtype” option is not specified, the search option defaults to “war”. If the value is invalid(not one of these three types), the command line will exit immediately.

      “rmcwebappname” specifies the name of the dynamic web site set for publishing, this parameter is only valid when the “rmcwebtype” is not set to “static”, if the “rmcwebappname” is not specified, the name of the dynamic web site defaults to “rmcwebsite”. If the value is invalid(invalid file name), the command line will exit immediately.

      "rmcsearch" specifies the search option to set for publishing, with choices of "php", "php-zend" and “servlet-rss”. If the “rmcwebtype” is not specified or is set to “war” or “ear”, "rmcsearch" option defaults to "servlet" unless is set to “servlet-rss” explicitly. If the “rmcwebtype” is set to “static”, "rmcsearch" option defaults to "applet" unless is set to “php/php-zend” explicitly.
      .
In addition to these RMC-specific command line options, there are many command line options inherited from Eclipse. These are documented in the Eclipse online help (topic "Running Eclipse").

The most useful ones are:
    -clean
      Cleans cached data used by the OSGi framework and Eclipse runtime. Try to run Eclipse once with this option if you observe startup errors after install, update, or using a shared configuration.

    -refresh
      Option for performing a global refresh of the workspace on startup. This will reconcile any changes that were made in the file system since the platform was last run.

    -vm vmpath
      The location of Java Runtime Environment (JRE) to use to run the Eclipse platform. If not specified, the launcher will attempt to find a JRE. It will first look for a directory called jre as a sibling of the Eclipse executable, and then look on the operating system path. Relative paths are interpreted relative to the directory that eclipse was started from.

    -showlocation
      Option for displaying the location of the workspace in the window title bar.

      Example:

      This is an example for publishing the "all_practices-ibm" configuration in German (-nl de):

      "C:\Program Files\IBM\RMC752\rmc\rmc.exe" -nl de -rmcsilent publish -rmclibrary "C:\rmclibs\lib.7.5.1.2.prac" -rmcconfiguration all_practices-ibm  -rmcoutput "C:\publishing\de\all_practices" -rmcsearch php

      This is the same example, using a batch file and some variables:

      set rmc_executable_location="C:\Program Files\IBM\RMC752\rmc\rmc.exe"
      set library_location="C:\rmclibs\lib.7.5.1.2.prac"
      set lang=de
      %rmc_executable_location% -nl %lang% -rmcsilent publish -rmclibrary %library_location% -rmcconfiguration "all_practices-ibm" -rmcoutput "C:\publishing\%lang%\all_practices" -rmcsearch php

      Original Publication Date

      23 April 2012

      [{"Product":{"code":"SS7DVG","label":"IBM Engineering Lifecycle Optimization - Method Composer"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Documentation","Platform":[{"code":"PF033","label":"Windows"},{"code":"PF016","label":"Linux"}],"Version":"7.5;7.5.0.1;7.5.1;7.5.1.1;7.5.1.2;7.5.2;7.5.2.1;7.5.2.2","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

      Product Synonym

      Rational Method Composer

      Document Information

      Modified date:
      17 June 2018

      UID

      swg27027017