DecomTrial

Purpose

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

Location

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

Usage

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

Command parameters

Option	Parameter
SysAdminNamespace	Oracle Directory Server admin namespace.
SysAdminUsername	User name for the Cognos system administrator.
TrialNamespace	Custom Authentication Provider (CAP) namespace.
TrialUsername	InForm study user who is a member of the following Reporting groups: Publishers. Either Sponsor Users or Site Users.
CognosDispatcherURI	Internal URI that the InForm server uses to communicate with the Cognos 10 BI server.
TrialName	Name of the 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.
Trial user username —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 10 BI 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 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.
trial_user=Study user.
dispatcher_url=Internal URI that the InForm server uses to communicate with the Cognos 10 BI 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