h2. Description
File Copy Service.
h2. Dependencies
!fileCopy.gif!
h2. Attributes
h4.DestinationFileSystem {anchor:DestinationFileSystem}

Destination file system or NONE to disable the service. The file system name can be suffixed by '!'<from>'-'<to> to defer copying outside a particular time interval, and/or prefixed by a condition '\[calling'\['!'\]'='<aeTitle> {'|' <aeTitle>}']' to limit/exclude copying to/of series received from modalities with specified AE title(s).

If the file system name is a tar URI (tar:<Directory/Mount Point>), instances of one series are packed into one tarball. Otherwise instance files are copied individually to the destination file system.

If an external command is used for the copy of tarballs to the destination, the destination name (after the "tar:" prefix) need not follow the syntax of a directory path (e.g.: tar:ftp://user@pass/service).

h4.TarCopyCommand {anchor:TarCopyCommand}

External command to copy tarballs to the destination, with
- %p will be replaced by the path of tarball to copy,
- %d will be replaced by the destination file system name,
- %f will be replaced by the destination TAR file path.

NONE = write tarball on local accessable file system.
Only effective, if the destination file system name is a tar URI.

h4.TarOutgoingDirectory {anchor:TarOutgoingDirectory}

Directory from which tarballs shall be copied by external [#TarCopyCommand]. A relative path name is resolved relative to {{dcm4chee_home/server/default/}}. Not effective if TarCopyCommand='NONE'

h4.FileStatus {anchor:FileStatus}

Status of copied file. Enumerated values: DEFAULT, TO_ARCHIVE, ARCHIVED

h4.VerifyCopy {anchor:VerifyCopy}

Verify MD5 sum of copied file.

h4.RetryIntervals {anchor:RetryIntervals}

Number and interval of retries made for failed Copy Requests.
Format: Comma separated list of <number> 'x' <interval> pairs.
The interval can be specified in seconds (##s), minutes (##m), hours (##h) or days (##d).

Example: 5x1m,10x10m
=> retry a total of 5 times, one minute apart for each retry; then retry a total of 10 times, 10 minutes apart for each retry.

h4.Concurrency {anchor:Concurrency}

Maximum number of concurrent invoked Copy Requests.

h4.BufferSize {anchor:BufferSize}

Size of write byte buffer.

h4.StoreScpServiceName {anchor:StoreScpServiceName}

Used internally. Do NOT modify.

h4.JMSServiceName {anchor:JMSServiceName}

Used internally. Do NOT modify.

h4.QueueName {anchor:QueueName}

Used internally. Do NOT modify.

h4.EJBProviderURL {anchor:EJBProviderURL}

Identifies JNDI (e.g: jnp://hostname:1099) with EJBs.
Use LOCAL if EJBs are deployed in same JBoss instance.

h4.FileSystemMgtName {anchor:FileSystemMgtName}

Used internally. Do NOT modify.

h4.Name {anchor:Name}

The class name of the MBean
h4.State {anchor:State}

The status of the MBean
h4.StateString {anchor:StateString}

The status of the MBean in text form

h2. Operations
h4.create {anchor:create}

Standard MBean lifecycle method
h4.start {anchor:start}

The start lifecycle operation
h4.stop {anchor:stop}

The stop lifecycle operation
h4.destroy {anchor:destroy}

The destroy lifecycle operation
h4.jbossInternalLifecycle {anchor:jbossInternalLifecycle}

The detyped lifecycle operation (for internal use only)

h2. Notifications