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

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
export_type
Values: as_is, interchange, raw

Description: The format in which a voice segment is exported:

as_is

Exports a voice segment as a Java serialized object in the encoding format used on the voice response node. This is an efficient option if the export data is to be re-imported to a Blueworx Voice Response system with the same hardware and voice encoding configuration. The exported object contains the voice segment descriptor within it, thus removing the need to specify it in the control file if it is later re-imported into the Blueworx Voice Response Java and VoiceXML Environment.

interchange

Exports a voice segment as a Java serialized object in the interchange format, allowing it to be re-imported later into the Blueworx Voice Response Java and VoiceXML Environment. This is the recommended export option if you wish to re-import the voice data to a complex containing a variety of voice response node hardware. The exported object contains the voice segment descriptor within it, removing the need to specify it in the control file if it is later re-imported into the Blueworx Voice Response Java and VoiceXML Environment.

raw

This exports the voice segment as a raw audio file. The data encoding is specified in the file_rate and file_encoding parameters. This option should only be used if the exported voice is to be used by third-party utilities, such as a sound editing program. You need to keep a record of the audio encoding format, sample size and sampling rate associated with the data, because this information is not included in the exported object. The exception is if file_encoding is set to wav and au whose file format holds the encoding information in its header.

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

Description: Audio encoding format of the audio file. Required if export_type is raw.

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. 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 u-law, a-law 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 can 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_name
Values: A valid file name

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

file_rate
Values: 6000 or 8000

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

segment_category
Values: Alphanumeric, up to 20 characters

Description: The category of the voice segment to be exported.

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

Description: The locale of the voice segment to be exported. 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 exported.