## JReport Designer launch files

You can find a set of utilities in the directory `<install_root>\bin`. All of these batch files (Windows)/script files (Unix) can be edited to suit different circumstances. However, you need to make sure of their functions before doing this. In addition, the information in this topic is current at the time of release, however, due to changes that take place during the release cycle it may no longer be valid. The most current information can be found in the Readme.html file with each version in the path `<install_root>`.

### CatDr.bat/CatDr.sh

This tool is for starting the Catalog Doctor in order to make changes to the catalog.

Usage

`java <-Dreporthome=reporthome> jet.builder.JReport [-options] [reportfile]`

Options

- -help
  Prints out this message.
- -vDebug
  Enables output debug message.
- -vError
  Enables output error message.
- -log[:<file>]
  Outputs message to `.\<file>` or the default.

### DJReport.bat/DJReport.sh

This tool is for starting JReport Designer in logging mode. In case of problems, you are requested to launch JReport Designer with this batch file/script file in order to track detailed log information. Running this batch file/script file generates log file in the `<install_root>\logs` directory.

Usage

`java <-Dreporthome=reporthome> com.jinfonet.designer.JReport [-options][reportfile]`

Options

- -help
  Prints out this message.
- -vDebug
  Enables output debug message.
- -vError
  Enables output error message.

### EConvert.bat/EConvert.sh

This tool is for removing the evaluation mark from reports. If you have purchased the JReport product and is successful in running JReport Designer with the new key, but the evaluation watermarks are still left, you will need to run this batch file to remove the evaluation watermarks. Run the batch file with the report names to be converted with the full path as parameter.

Usage

    java -Dreporthome=<drive>:<path> jet.report.EvlConverter
    [[drive:][path][filename] +]
    [drive:][path][filename]

`Econvert.bat [ReportName.cls]`

Example: `Econvert.bat C:\JReport\Designer\Demo\Reports\TutorialReports\*.cls`

### jrenv.bat/jrenv.sh

This tool is for generating the report environment file report.env in the current directory. This file can help the Jinfonet support staff assist you when you run into problems.

### JReport.bat/JReport.sh

This tool is for starting JReport Designer.

Usage

`java <-Dreporthome=reporthome> com.jinfonet.designer.JReport [-options][reportfile]`

Options

- -help
  Prints out this message.
- -vDebug
  Enables output debug message.
- -vError
  Enables output error message.

Note: You may need to set an appropriate -Dfile.encoding option in the file to start JReport Designer in order to view characters correctly.

### JRTutorial.bat/JRTutorial.sh

This tool is for running this batch file to display the tutorial help.

### ModelWizard.bat/ModelWizard.sh

This tool is for importing ObjectDataSource.

Usage

`java com.jinfonet.jdbc.model.wizard.ModelWizard [-options]`

Options

- -help
  Prints out this message.
- -vDebug
  Enables output debug message.
- -vError
  Enables output error message.
- -log[:<file>]
  Outputs message to JGUIEditor.log or `.\<file>`.

### NJReport.bat/NJReport.sh

This tool is for starting JReport Designer without the command window.

Usage

`java <-Dreporthome=reporthome> com.jinfonet.designer.JReport [-options][reportfile]`

Options

- -help
  Prints out this message.
- -vDebug
  Enables output debug message.
- -vError
  Enables output error message.

Note: You may need to set an appropriate -Dfile.encoding option in the file to start JReport Designer in order to view characters correctly.

### PropConvert.bat/PropConvert.sh

This tool is for converting property values. Running this batch file will display a window from which you can modify many properties of a selected report file. This is most useful when you want to modify several properties using the same value at the same time. For example, if a Label and several DBFields share the same background of blue, and now you want to change them all to transparent, you can simply use this tool.

### rp.bat/rp.sh

This tool is for replacing user ID and license key.

Usage

`rp UID Key`

### rptconv.bat/rptconv.sh

This tool is for converting old report schema to be current version.

Usage

`rptconv "-source=source_path" ["-target=destination_path"] [-r] [-s]`

Options

- -source
  Specifies the source path of the reports that are to be converted.
- -target
  Specifies the destination path for the converted reports.
- -r
  Replaces the source report with the converted version.

  If this option is set, ["-target=destination_path"] will be ignored.

  If both "-r" and "-target" are not specified, the converted reports are saved in the same directory as the source reports and named as "converted_SourceReportName".

- -s
  Converts all the reports in the specified directory, including the reports in all subdirectories.

Examples

- To convert a single report:

  `rptconv "-source=C:\JReport\Designer\demo\reports\SampleReports\InvoiceReport.cls" "–target=C:\temp"`

  This will convert C:\JReport\Designer\demo\reports\SampleReports\InvoiceReport.cls to C:\temp\InvoiceReport.cls.

  `rptconv "-source=C:\JReport\Designer\demo\reports\SampleReports\InvoiceReport.cls" "–target=C:\temp\1.cls.xml"`

  This will convert C:\JReport\Designer\demo\reports\SampleReports\InvoiceReport.cls, save the converted report to `C:\temp`, and name it as "1.cls.xml" (if license allows).

  `rptconv "-source=C:\JReport\Designer\demo\reports\SampleReports\InvoiceReport.cls"`

  This will convert C:\JReport\Designer\demo\reports\SampleReports\InvoiceReport.cls, save the converted report in the same directory, and name it as "converted_InvoiceReport.cls".

  `rptconv "-source=C:\JReport\Designer\demo\reports\SampleReports\InvoiceReport.cls" -r`

  This will overwrite C:\JReport\Designer\demo\reports\SampleReports\InvoiceReport.cls.

- To convert all reports (*.cls, *.rpt, *.clx, *.cls.xml) in a directory:

  `rptconv "-source=C:\JReport\Designer\demo\reports" "–target=C:\temp"`

  This will convert all the reports in `C:\JReport\Designer\demo\reports` and save the converted reports to `C:\temp`. The converted reports use the same file names as source reports.

  `rptconv "-source=C:\JReport\Designer\demo\reports" "–target=C:\temp" -s`

  This will convert all the reports in `C:\JReport\Designer\demo\reports` and in the subdirectories and save the converted reports to `C:\temp`. The converted reports take the same file names and directory structure as source reports.

  `rptconv "-source=C:\JReport\Designer\demo\reports" "–target=C:\temp\*.cls" -s`

  This will convert all the reports in `C:\JReport\Designer\demo\reports` and in the subdirectories and save the converted reports to `C:\temp`. The converted reports take the same directory structure as source reports and the suffixes of their file names are all changed to ".cls".

  `rptconv "-source=C:\JReport\Designer\demo\reports" -r -s`

  This will convert all the reports in `C:\JReport\Designer\demo\reports` and in the subdirectories. The converted reports overwrite the source reports.

  `rptconv "-source=C:\JReport\Designer\demo\reports"`

  This will convert all the reports in `C:\JReport\Designer\demo\reports`. All the converted reports are saved in the same directory and named as "converted_SourceReportName".

- To convert a type of reports with same suffixes in a directory:

  The usage is similar to converting a directory. You can specify the wildcard to filter reports, for example:

  `rptconv "-source=C:\JReport\Designer\demo\reports\SampleReports\*.cls" "–target=C:\temp"`

  This will convert all the reports with the suffix ".cls" in `C:\JReport\Designer\demo\reports\SampleReports` and save the converted reports to `C:\temp`.

Notes:

- There must be one and only one catalog file in the directory where the reports to be converted reside.
- If the reports to be converted contain UDO or UDF, make sure the corresponding classes or jars are included in the class path of rptconv.bat/rptconv.sh.

### setenv.bat/setenv.sh

This tool is for generating the report environment variables before starting JReport Designer.