8.4.5 Copying among servers

This command copies delivery data among multiple JP1/DH - Server systems.

Delivery data that is sent to a JP1/DH - Server system is copied to another JP1/DH - Server system. You can download the same delivery data stored in the copy source JP1/DH - Server system, from the copy destination JP1/DH - Server system.

This command is executed on the copy source JP1/DH - Server system.

Organization of this subsection

(1) Format
(2) Arguments
(3) Description
(4) Execution example

(1) Format

DWAdminClient.bat COPYTOSERVER
   {{{ -to email-address {-toname name }{-todivision division}}|^#
     { -cc email-address {-ccname name }{-cc division name}}|^#
     { -bcc email-address {-bccname name }{-bcc division name}}}|^#
    { -destinationfile the path of the Destination File}}
    -deliveryid deliveryid
   -sysconfig the pass of JP1/DH - Server configuration files (digikatsuwide.xml)
   { -title title}
   { -message message | -messagefile messagefile}
   { -openpassword openpassword}
   { -getdeliveryinfo the path of the delivary information file}
    -property the path of the Command Property File
   { -concurrenttimeout timeout time (second)}

#: Specify one or more options among these.

To Page Top

(2) Arguments

Table 8‒16: The argument of server to copy
No	Option	Explanation
1	-to	Specify the address to send by `to`. You can specify the email address^#1 or the group name (English) ^#2. Do not distinguish a capital letter and a small letter. When @ (atmark) is not contained in this value, it is registered as a group name. When you specify two or more addresses, divide them with a colon (:). You can specify to, cc, and bcc to the maximum number of the recipients set up by Data Highway - Server side in all. For more information about settings of the maximum number, refer to the manual JP1/Data Highway - Server Configuration and Administration Guide. You can also specify the email address and the group name together.
2	-toname	Specify the address name^#3 which is specified to `-to` option with colon (:) division. You can specify to the number which is specified to `-to` option. When the specified arguments are less than the number of `-to` option, it is considered that the specification was omitted. When you specify the group name as the address, this option is ignored.
3	-todivision	Specify the address division^#4 which is specified to `-to` option with colon (:) division. You can specify to the number which is specified to `-to` option. When the specified arguments are less than the number of `-to` option, it is considered that the specification was omitted. In addition, you cannot include the colon (:) to the division. When you specify the group name as the address, this option is ignored.
4	-cc	Specify the address to send by cc. You can specify the email address^#1 or the group name (English) ^#2. The specification method is the same as that of -to option.
5	-ccname	Specify the address name^#3 which is specified to `-cc` option with colon (:) division. You can specify to the number which is specified to -cc option. When the specified arguments are less than the number of -cc option, it is considered that the specification was omitted.
6	-ccdivision	Specify the address division^#4 which is specified to `-cc` option with colon (:) division. You can specify to the number which is specified to `-cc` option. When the specified arguments are less than the number of -cc option, it is considered that the specification was omitted. In addition, you cannot include the colon (:) to the division.
7	-bcc	Specify the address to send by bcc. You can specify the email address^#1 or the group name (English) ^#2. The specification method is the same as that of -to option.
8	-bccname	Specify the address name^#3 which is specified to `-bcc` option with colon (:) division. You can specify to the number which is specified to `-bcc` option. When the specified arguments are less than the number of -bcc option, it is considered that the specification was omitted.
9	-bccdivision	Specify the address division^#4 which is specified to `-bcc` option with colon (:) division. You can specify to the number which is specified to -bcc option. When the specified arguments are less than the number of -bcc option, it is considered that the specification was omitted. In addition, you cannot include the colon (:) to the division.
10	-destinationfile	It is used when specifying recipients by CSV form file. Specify the path of the Destination File which indicated recipients. It cannot specify simultaneously with other recipients specification options shown below. `-to`, `-cc`, `-bcc` `-toname`, `-ccname`, `-bccname`, `-todivision`, `-ccdivision`, `-bccdivision` For more information about Destination File see 9.3.2 (1) (e) Destination File. If the version of Data Highway - Server is 10-50 or later, this option can be used. When this option to less than 10-50 Data Highway - Server version is specified, an error of "DWCO1913_E The server returned an error. Server does not support this command. " occurs.
11	-deliveryid	Specify the delivery ID that indicates the delivery data copied among the servers.
12	-sysconfig	Specify the file path of the configuration file (`digikatsuwide.xml`) for the copy source JP1/DH - Server system.
13	-title	Specify the subject. You can specify to a hundred characters at the maximum. When this option is omitted, the subject is a blank. But the subject of the email is applied the system default subject.
14	-message	Specify the messages which are described on the email. You can specify to 256 characters at the maximum. When this option is omitted, the message is a blank. Cannot specify the newline.
15	-messagefile	Specify the path of the text file which is described message to write to the email. The character code of the text file must be described with UTF-8. If the text file is not described with UTF-8, it may be displayed incorrectly. In addition, BOM and the newline code are not cared about their existence. You can specify to 4,096 characters at the maximum. But when the file is attached BOM, you can specify to 4,095 characters at the maximum. The newline is treated as one character. When this option is omitted, the message is a blank. When this option is specified with -message option, the command ends with an error.
16	-openpassword	Specify the open password for sending to the unregistered address. When this option is omitted, the open password is a blank. But the command ends with an error because the open password is indispensable for sending to the unregistered address. When you specify the open password for sending to the registered address, it is not used and ignored. An open password must be between 6 and 32 letters, include two or more kinds of characters (numbers, small letters, big letters, symbols). You can use the following symbols. !"#$%&'()*+,-./:;<=>?@{\}^_`{\|}~ In addition, when the open password is surrounded by " (double quote), the inner character is considered as the password. For example, if the specified password is "Password01", then Password01 is the open password.
17	-getdeliveryinfo	Specify the output file path when creating a delivery information file. A delivery information file that contains delivery information of the copy destination JP1/DH - Server system is output in XML format. When the same name folder is existed, it is overwritten. And, when this option is specified that the file or folder to copy do not exist, the delivery information file is not outputted. For more information about the delivery information file see 8.4.5 (3) (d) Delivery information file.
18	-concurrenttimeout	For details, see 8.3.2 Common options. For the `-property` option, specify the path of the property file that contains the URL of the copy destination JP1/DH - Server system, and the ID and password of the sender.
19	-property

#1

One-byte alphabet and numbers and more than 256 characters can be used to e-mail address.

You cannot use a space character or the following symbols:

/ \ ? * : | " # $ < > @ ^ { } .

#2

One-byte alphabet and numbers and more than 200 characters can be used to group name.

You cannot use a space character or the following symbols:

( / \ ? * : | " < > @ ^ )

A group name including only a space character or period cannot be specified.

#3

One-byte alphabet and numbers and more than 200 characters can be used to name.

You cannot use a space character or the following symbols:

( / \ ? * : | " < > # @ ^ { } $ )

A name including only a space character or period cannot be specified.

#4

You can enter no more than 1024 characters to division.

To Page Top

(3) Description

(a) Information inherited among servers

Only the delivery data is inherited among the copy source JP1/DH - Server system and the copy destination JP1/DH - Server system. To acquire the ID of the delivery to the copy destination JP1/DH - Server system, specify the -getdeliveryinfo option and output a delivery information file in XML format.

(b) Copying data among the different versions of JP1/DH - Server

You can execute the command even if the versions of the copy source JP1/DH - Server system and the copy destination JP1/DH - Server system are different.

(c) Unable to copy

In the following cases, copying data among the servers fails:

The compression method and compression level defined in the delivery policy of the copy source JP1/DH - Server system are different from those defined in the delivery policy of the copy destination JP1/DH - Server system.
The user who is specified as the destination of the message has been deleted.
Only a message is delivered.
Delivery data does not exist.

(d) Delivery information file

The meanings of the elements which are outputted to the delivery information file are as follows.

Table 8‒17: The meanings of the elements of the delivery information file
Element/Attribute		Number of elements	Explanation
`data` Element		1	Root Element. It is always outputted.
`deliveries`Element		1	The delivery information list.
`delivery` Element		1	Output when delivery information exists. If there is no delivery information, no `delivery` element is included.
	`id` Attribute	1	Delivery ID.
	`subject` Attribute	1	The subject of the delivery.
	`message` Attribute	1	The delivary massage.
	`total-size` Attribute	1	Total data size is outputted with a number of bytes. If the data is to be compressed, this indicates the data size before compression.
`sender` Element		1	The date the delivery (transfer) was completed is displayed.
	`id` Attribute	1	Sender id.
`files` Element		0 or 1	A list of delivery files or folders.
`file` Element		1 or more	Information of the delivery file and folder. This element is output as many as the number of files and folders to be sent in one delivery. If no delivery file or folder exists, this element is not output.
`type` Element		1	One of the following delivery type is output: file: `file` folder: `folder`
`name` Element		1	Name of the delivery file and folder.
`size` Element		1	The size of the delivary file/folder is outputted with a number of bytes. For a folder, the total number of bytes before folder content archival is output. If the data is to be compressed, this indicates the data size before compression.
`receivers` Element		1	A list of recipient information.
`receiver` Element		1 or more	Recipient information is output. If there are multiple recipients, multiple `receiver` elements are output.
	`email` Attribute	1	The receiver's email address.
	`to-type` Attribute	1	The type of a receive. TO: `TO` CC: `CC` BCC: `BCC`
	`name` Attribute	1	The receiver's name.
	`division` Attribute	1	The receiver's division.

Important: When the sender user is deleted, the files sent by that user are also deleted. In this case, empty double quotation marks ("") are displayed for the id attribute of the sender element.

To Page Top

(4) Execution example

DWClient.bat COPYTOSERVER
 -to "user@mailaddress.com"
 -deliveryid 100
 -sysconfig C:\Program Files\Hitachi\jp1dh\server\misc\WEB-INF\digikatsuwide.xml
 -title "title"
 -message "message"
 -getdeliveryinfo C:\deliveryinfo.xml
 -property "C:\DWCLient\property.xml"

To Page Top