The data copy tool can be used with a command line via the CopyB command.
This command uses a script file (*.cps) that specifies the required operations. This file can either be generated interactively by the Data copy tool (graphical wizard) or be built by the user.
The command uses the following syntax:
C:\> copyb @<script_file_name>.cps
Alternatively, you can specify a script's contents in full on the command line:
C:\> copyb LOG=((NAME="test.log"))…
The drawback of this syntax is that it generates very long command lines that are hard to read. In addition, with multiple copies of data from the same source, this solution is less efficient than using a .cps script, because it entails multiple reconnections to the database and/or Middleware.
The data copy tool also exists in the Java version, the command line parameters are identical to in the Windows version.
The command line syntax is as follows:
java <javaOpts> com.hardis.adelia.copyb.CopyB @<script_file_name>.cps
java <javaOpts> com.hardis.adelia.copyb.CopyB LOG=((NAME="test.log"))...
The CLASSPATH must be configured to include the Adelia Java runtime, the configuration scripts and the necessary JDBC drivers. The following must be taken into consideration for the Java version:
- To maximize compatibility with the Windows version, the text file encodings correspond by default to Windows Western settings (code page 1252 for the ANSI character set and 850 for the ASCII character set). However, the character sets can be chosen via Java command line parameters:
- DansiCharset =< charset > | Charset for ANSI inputs/outputs (delimited ASCII, IXF source). By default "Cp1252" ("ISO-8859-1" if not supported by the JVM). |
- DasciiCharset =< charset > | Charset for ASCII inputs/outputs (delimited ASCII source). By default "Cp850" ("US-ASCII" if not supported by the JVM). |
- The log level and information displayed can be controlled by the command line (INFO by default)
- Dverbose | Displays the detail of exceptions when there is an error. |
- Ddebug | Enables DEBUG level in loggers. |
- Dtrace | Enables TRACE level in loggers. |
- Dlog4j.external.configuration = true | By default, the tool uses a LOG4J simplified configuration to limit the display to the relevant messages. If this option is specified, the log4j configuration will not be initialized by the tool (log4j.properties loaded from the CLASSPATH). |
- Generally speaking, the parameters indicating a file or directory name must be adapted to correspond to the syntax of the platform file names (path separator, drive letters, etc.).
Click below for further details about: