DecomTrial

Purpose

Securely removes Oracle InForm study components (study folders, clinical package, operational package, DSN entries, and Oracle InForm study user accounts) from the Reporting and Analysis module.

Location

The Oracle InForm application server folder on the Oracle InForm application server. For example, <Installation_Directory>\InForm\bin.

Usage

DecomTrial [SysAdminNamespace SysAdminUsername TrialNamespace TrialUsername CognosDispatcherURI TrialName [<company_code>]]

Option Parameter
SysAdminNamespace Oracle Directory Server admin namespace.
SysAdminUsername User name for the Cognos system administrator.
TrialNamespace

Custom Authentication Provider (CAP) namespace.

Enter informcap.
TrialUsername Oracle InForm study user who is a member of the following Reporting groups:
  • Publishers.
  • Either Sponsor Users or Site Users.
CognosDispatcherURI Internal URI that the Oracle InForm server uses to communicate with the Cognos Analytics server.
TrialName Name of the Oracle InForm study.
company_code

The organization ID. Optional.

This parameter is required only for Oracle-hosted studies in a single sign-on environment.

Command line prompts

Depending on the syntax used with the DecomTrial command, you are prompted for the following parameters:

  • System Administrator namespace—Oracle Directory Server admin namespace.
  • System Administrator username—User name for the Cognos system administrator.
  • Trial namespace name—Custom Authentication Provider (CAP) namespace. Enter informcap.
  • Trial user username—Oracle InForm study user who is a member of the following Reporting groups:
    • Publishers.
    • Either Sponsor Users or Site Users.
  • Cognos dispatcher URL—Internal URI that the InForm server uses to communicate with the Cognos Analytics server.
  • Trial name—Study name.
  • Company Code—The organization ID.

    Optional. Reserved for Oracle-hosted studies in a single sign-on environment.

  • System Administrator password—Password for the Cognos system administrator.
  • Trial user password—Password for the Oracle InForm study user.

Note:

You are always prompted for the System Administration password and Trial user passwords when you run DecomTrial.

For legacy purposes, you can also pass the parameters by using the /accountparams:"path_to_parameter_file" command option.

When specified, this option includes the path to a text file that contains the values required to run the command. The format of the parameter file is parameter=value. There is a new line for each parameter, and there are no spaces on a line.

Parameter file contents

You can pass the following parameters in a parameter file:

  • sysadmin_namespace=Oracle Directory Server admin namespace.
  • sysadmin_uid=User name for the Cognos system administrator.
  • trial_namespace=Custom Authentication Provider (CAP) namespace. Enter informcap.
  • trial_user=Study user.
  • dispatcher_url=Internal URI that the InForm server uses to communicate with the Cognos Analytics server.
  • trial_name=Study name.
  • company_code=OrgID assigned for an single sign-on study.

Example

DecomTrial OHSI crnsysadmin informcap mmartin http://server.example.com:9300/p2pd/servlet/dispatch pfstcardio blank

Parent topic: Command and script reference