Parameters

-configuration configurationname
The name of the configuration to use. If you do not specify this, it defaults to default.
-controlfile filename
The fully qualified name of the dtjplex control file. If you do not specify this, it defaults to impexp.cfv in the current directory.
-database databasename
The fully qualified name of the configuration database. You should not need to specify this.
-host hostname
The name of the host on which to perform the action. If not entered this will default to the local host.

Control file keywords

Note: You must specify either import_hints or segment_encoding and segment_rate.
character_encoding
The character encoding used in the control file. You need to set this only if your voice segment names use national characters (that is, 8-bit ASCII encoding or DBCS) and you are planning to share the control file across multiple systems. The name must be one of the “canonical names” listed on Sun’s “Supported Encodings” Web site at
http://java.sun.com/products/jdk/1.1/docs/guide/intl/encoding.doc.html
file_name
Values: Any file name

Description: The name of the file containing the audio data to be imported. The file name is relative to the directory from which the action is executed.

file_encoding
Values: ulaw, alaw, gsm, wav, au

Description: Audio encoding format of the audio file. Required if the audio data has not been exported as_is or interchange.

You must ensure that the audio data stored in the file matches the format specified in the control file. Unintelligible sound will result at playback if the data is incorrectly specified.

ulaw or alaw

Single-channel, 8-bit sample size, 8kHz sampling rate.

gsm

Single-channel, compressed format only. The sampling rate is ignored.

wav

A file encoding of wav indicates that the audio file is a Microsoft WAV file. When importing a WAV file the encoding, sample size, and sampling rate information is taken from in the WAV file itself. The data stored in the WAV file must be either in ulaw, alaw or linear encoding. For ulaw and alaw, it must be single-channel with 8-bit sample size and 6kHz or 8kHz sampling rates. For linear encoding, it must be mono or stereo and 8 or 16-bit sample size. When exporting to a WAV file, the data format used is always 16-bits, mono and 8kHz sampling rate.

au

When you import an au file, the encoding, sample size and sample rate information is taken from the au file itself. The data stored in the au file may be u-law, a-law or PCM. For u-law and a-law it must be single channel with 8-bit sample size. It may have any sampling rate. For PCM it may be 8-bit or 16-bit sample size (mono or stereo). When you export to an au file the data format used is 8-bit, 8kHz, m-law. Non-PCM au files must be mono.

file_rate
Values: 6000 or 8000

Description:Data sampling rate in Hz of the data in the audio file. Required if file_encoding is ulaw, alaw or adpcm.

import_hints
Values: a string of the format QxSy where x and y represent the quality and size measures of the imported voice segment. A value of 1 means low, 2 means medium and 3 means high while a value of 0 means “don't care”.

Description: An alternative to specifying explicitly the voice segment data encoding format is to hint at the desired audio quality and size of imported voice segment.

These values are interpreted differently on different Blueworx Voice Response systems. On systems where only one audio encoding format is supported, the values of the hints have no effect. The use of import_hints is particularly useful if audio data is to be imported into systems with different voice encoding configurations.

Required if you don’t specify segment_encoding and segment_rate. (If you specify import_hints, any existing values in segment_encoding and segment_rate are unset.)

segment_category
Values: Alphanumeric, up to 20 characters

Description: The category of the voice segment to be imported. Required if the audio data has not been exported as_is or interchange, or if an as_is or interchange voice object is to be re-imported as a different voice segment.

segment_encoding
Values: ulaw, alaw, adpcm, or gsm

Description: Required if you don’t specify import_hints. (If you specify this, any existing value in import_hints are unset.)

segment_locale
Values: Alphanumeric, up to 15 characters (ll_CC or ll_CC_variant)

Description: The locale of the voice segment to be imported. Defaults to the locale in which you run the command (not the locale of the voice response node).

segment_name
Values: Alphanumeric, up to 20 characters

Description: The name of the voice segment to be imported. Required if the audio data has not been exported as_is or interchange, or if an as_is or interchange voice object is to be re-imported as a different voice segment.

segment_rate
Values: 6000 or 8000

Description: Data sampling rate in Hz of the voice segment. Required if you don’t specify import_hints. (If you specify this, any existing value in import_hints are unset.)