LOAD Command

ADDRESS VOX Commands › Voice Commands › LOAD Command

LOAD Command

The LOAD command loads a voice file or voice word library index file into your workstation's memory, allowing faster access to your voice data.

This command has the following format:

ADDRESS VOX "LOAD FILE(filename)
  [FILETYPE(NONINDEX|filetype)]
  [SYSTEM(sysname)]"

FILE

Specifies the name (filename) of a voice file or voice word library.

FILETYPE

(Optional) Specifies the type of voice file to load. Valid values are:

NONINDEX: A nonindexed voice file
WORDLIB: A voice word library's index file. Specifying WORDLIB does not load the voice word library's digitized speech data into memory.

Note: When specifying FILETYPE (WORDLIB), do not include a file extension on the FILE operand.

Default: NONINDEX

SYSTEM

(Optional) Specifies the name of the system that is running the notification server to which you want to direct the command.

The sysname value can contain up to eight alphanumeric characters.

Default: The local system name

Return Information:

After the LOAD command executes, it sets the special REXX return code variable RC.

If the command executes successfully, the RC variable contains a value of zero.
If the command does not execute successfully, the RC variable contains one of the following values: 5108, 5109, 5117, 5155, 5180, 5199, 5252. (See the Message Reference Guide for further information.) Additionally, the VOX.ERROR variable contains the complete VOX error message, which includes the four-digit return code and complete error message text.

Usage Note:

CA Automation Point loads the voice word library's index file into memory the first time your voice application requires its use. For more information, see the descriptions of the ANSWERPLAY, CALLPLAY, and PLAYGETDIGITS commands.

Example:

The following REXX code illustrates how to use the LOAD command to load an indexed voice file into memory, allowing for faster access within your voice application:

/* Load all prompts in the indexed voice file (for use by */
/* the problem-escalation application). */

address vox 'load file(probesc) filetype(wordlib)'

/* Get exclusive access to the first available voice channel. */

address vox 'getchannel group(all) prefix(handle)'

... body of the problem-escalation application code

/* Release the voice channel. */

address vox 'releasechannel channel('handle')'