The DTprompt command

Description

Use the DTprompt command with the -import option to import an AIX file containing prompt ASCII source into Blueworx Voice Response. You can use this command as an alternative to using the Prompt Editor window to select, import, and validate ASCII source.

If the imported prompt has validation errors it is not created or updated (if it exists already), and the validation errors are written to stderr.

When you import a prompt, if the specified prompt directory does not exist, Blueworx Voice Response creates it. Also, if a default prompt does not already exist, the imported prompt is saved as the default as well as in the language specified.

Use the DTprompt command with the -export option to export the ASCII source of a prompt to an AIX file.

If you want to overwrite an existing prompt or AIX file when importing or exporting, use the -noprompt option.

To use this command you must be logged on to AIX as the Blueworx Voice Response user. Also, you need to know the path name of the AIX file containing the prompt ASCII source, and the names of the prompt and the prompt directory.

Syntax

DTprompt -import -f pathname -d directory -o promptname -ulang language
[-noprompt]
[-ro ]
[-v versionstring]
DTprompt -export -f pathname -d directory -o promptname -ulang language
[-noprompt]

Parameters

-import
This parameter is mandatory for import.
-export
This parameter is mandatory for export.
-f pathname
This mandatory parameter specifies the name of the ASCII file (use the full pathname or the relative pathname) to be used as input for importing or output for exporting. Use this parameter with both the -import and -export parameters.
-d directory
This mandatory parameter specifies the name of the Blueworx Voice Response prompt directory containing the prompt. Use this parameter with both the -import and -export parameters.
-o promptname
This mandatory parameter specifies the prompt name. Use this parameter with both the -import and -export parameters.
-ulang language
This mandatory parameter specifies the language code of the prompt. Use this parameter with both the -import and -export parameters.
-noprompt
This optional parameter specifies that an existing prompt or AIX file may be overwritten. You can use this parameter with both the -import and -export parameters.
-ro
This optional parameter, used with the -import parameter, marks the prompt internally as read-only. Subsequent attempts to delete or update the prompt are prevented. Use this parameter to prevent accidental modification or deletion of the prompt.
-v versionstring
This optional parameter, used with the -import parameter, sets a user-defined version identification string in the Blueworx Voice Response data base. Blanks can be included if the version string is in double quotes.

Return codes

1
Incorrect usage
2
Prompt does not exist
3
Unable to open AIX file
4
Validation errors
5
Error creating prompt directory
6
Invalid language