Generating a Blank Casebook Report from the Command Line

You can generate a Blank Casebook Report by issuing the RunBlankCasebook command from the Microsoft Windows command line.

You enter the RunBlankCasebook command in the following format:

RunBlankCasebook.cmd -st study [-p patient] -bk DCI_Book -l folder_location -u user [-pw password] [-debug] [-trace] [-o orientation]

For more information, see:

Displaying the Syntax for the RunBlankCasebook Command

To display the syntax for the command:

  1. Type RunBlankCasebook on the command line.
  2. Press Enter.

Parameters for the RunBlankCasebook Command

The following table describes the required and optional parameters for the RunBlankCasebook command.

Note:

When specifying a parameter that contains spaces (on a Windows command line), you must enclose the parameter in double quotes.

Parameter Required? Description

-st study

Yes

Specifies the name of the study to use for the generated report.

  • If you do not include the -p patient parameter, the system generates a Blank Casebook Report for the casebook defined in the -bk DCI_Book parameter.
  • If you include the -p patient parameter, the system generates a Blank Casebook Report that is specific to a particular patient.

-p patient

No

Specifies a unique patient number (ID). The system generates a Blank Casebook Report that is specific to the specified patient.

-bk DCI_Book

Yes

Specifies the name of the DCI Book (casebook) to use for the generated report.

Note that for a patient-specific report, this value may not match the casebook assigned to the specified patient.

-l folder_location

Yes

Specifies the directory where the system saves the PDF file created for each report, and the log files created during the generation of the report.

In addition, the system uses this directory to write the debug information if you include the -debug parameter on the command line. The directory that you specify must already exist. If the directory you specify does not exist, the command fails and displays an error message that the folder is invalid.

-u user

Yes

Specifies your user name for logging in to the Oracle Clinical database.

-pw password

No

Specifies your password for logging in to the Oracle Clinical database. When you use this parameter, your password is visible on the screen.

If you do not use the -pw parameter, the system prompts you for your password. Asterisks mask your password as you type it. For security reasons, Oracle recommends that you do not specify your password directly on the command line.

-debug

No

Leaves data in temporary tables and outputs files to the directory that you specified with the -l folder_location parameter. This data is useful when working with customer support to debug an issue. After you resolve the issue and the debug information is no longer necessary, be sure you truncate the temporary pdr_temp and pdr_superscripts tables.

-trace

No

Turns on database trace and creates a trace file during the execution of the report. Trace data is useful when debugging performance problems. The system saves the trace file in the directory specified in the init.ora file of the database. Check with your database administrator for the location.

-o orientation

No

Denotes the orientation of the pages in the cover, table of contents, ancillary data sections, and appendixes. Valid entries are:

  • P = portrait (default)
  • L = landscape