WiseCopy

WiseCopy can be run from the command line. This means that you can run WiseCopy from within a batch command (a file with .bat extension), for example, or that you can write some software program that, at a point, launches WiseCopy, waiting for it to have finished running or not. This point is not further detailed, as this manual illustrates the features of WiseCopy, and not the Windows API interface.

Running WiseCopy from the command line requires the previous definition of a procedure. Therefore, you can run WiseCopy from the command line if and only if WiseCopy is correctly registered.

The utility of an unattended execution of WiseCopy is obvious: you can activate such a procedure at a programmed time, maybe at night or when the workload of your system or your network is small , thus implementing a very practical backup of an entire disk or of selected folders.

Or, you can think to write your own software program that manipulate certain files, and at the end, it launches WiseCopy to copy the files created or updated. There are endless possibilities.

Selected examples

The command line:

"C:\AFM Applications\WiseCopy\WiseCopy.exe" d:\Myfolder\Step.twc -f -q

shall run WiseCopy (note the double quotes, they are necessary in this case, because the file pathname contains white spaces), executing the procedure d:\ MyFolder\Step.twc.

The -f indicates that the copy is carried forward, ie from source to destination for each step of the procedure. When the procedure is completed WiseCopy ends (-q), allowing the command file to continue with the next command or the launching program to continue.

The command line

"C:\AFM Applications\WiseCopy\WiseCopy.exe" d:\Myfolder\lineup.twc -X -q

shall run WiseCopy executing the procedure d:\Myfolder\lineup.twc, which is performed in both directions (-X), after which WiseCopy terminates.

Top page

Command line parameters

The command line must contain, in order:

• The name of the WiseCopy command: normally it is the full path to the WiseCopy.exe file; if the program was installed with the installation wizard, it should be "C:\AFM Applications\WiseCopy\WiseCopy.exe" (always, in any language).
• The name of the procedure: in this case too it is better to specify the full path, even if the procedure is in the same folder of WiseCopy.exe. It is not granted that this is the current directory of the calling process.
• Parameters for the control of the execution.

The control parameters are preceded by '-', and are case sensitive.

Controlling the copy direction

• -f: straight copy, from origin to destination, for each step of the procedure.
  Equivalent to the OK button in interactive mode.
• -b: reverse copy, from destination to origin for each step of the procedure.
  Equivalent to the Revert button in interactive mode.
  
• -X: straight copy and then reversed.
  Equivalent to the Line up button in interactive mode.
• ->: a synonym for -f.
• -<: a synonym for -b

In case of conflict (ie, if you indicate more than one parameter of this class), the last parameter found on the command line is used. Therefore:

"C:\AFM Applications\WiseCopy\WiseCopy.exe" d:\Myfolder\lineup.twc -X -f -b

is the same as

"C:\AFM Applications\WiseCopy\WiseCopy.exe" d:\Myfolder\lineup.twc -b

The command line

"C:\AFM Applications\WiseCopy\WiseCopy.exe" d:\Myfolder\lineup.twc -> -X

is the same as

"C:\AFM Applications\WiseCopy\WiseCopy.exe" d:\Myfolder\lineup.twc -X

Execution control

• -q means that, when the procedure is over, WiseCopy terminates. The main window is closed, and the control is returned to the calling task, whether a batch or a software program. However, if there are errors, the WiseCopy does not terminate: the main window remains active, showing the list of occurred errors.
• -Q: the same as -q, but the program terminates even if errors have occurred. If you use -Q, it is a good idea that the procedure keeps a log of operations, and that the log with errors are kept. Otherwise, you would never know if any error occurred, and which.
• -t: WiseCopy works silently, without opening any window. Of course, in this case, the parameters-q and-Q are meaningles, and they and are ignored.

If you specify both -q and -Q, the last parameter on the command line takes the precedence. No error is raised.

Top page