4
Oracle Voicemail & Fax Processes

This chapter discusses the different telephony processes of the Oracle Voicemail & Fax system.

This chapter contains the following topics:

• Overview
• Managing Oracle Voicemail & Fax Processes
• Oracle Voicemail & Fax Process Parameters
• Oracle Voicemail & Fax Log Files

Overview

The Oracle Voicemail & Fax telephony component consists of several processes based on the Computer Telephony Server (CT Server) architecture from Enterprise Computer Telephony Forum (ECTF). Each process interacts with a call, performs the task(s) at hand and transfers the call to different processes.

These are the telephony processes:

• Routing Process: Answers inbound calls to the Oracle Voicemail system and directs them to the recording or retrieval process.
• Voice Mail Recording Process: Records voice messages and stores them in the mail store
• Voice Mail Retrieval Process: Interacts with the user and retrieves and renders messages from the mail store.
• Fax Receiving Process: Receives and stores fax messages in the mail store
• Attendant Process: Manages and transfers calls when a user wishes to speak with an operator.
• Recovery Process: Manages queued voice mail and fax messages if the mail store is unavailable.
• MWI Service Process: Manages the Message Waiting Indicator (MWI) for individual switch implementations.
• AQMWI Process: Manages the Message Waiting Indicator (MWI) requests from the mail server.

The following are examples of how a call goes through the various processes:

• Recording: The routing process picks up the call from the PBX and parses call detail information. Once the Routing process determines that it's a recording call type, the call is handed off to the Recording process or, if fax tone is detected, the call is routed to the Fax Receiving process. Recording and Fax Receiving processes interacts with Oracle Internet Directory and the mail store to store the recorded message. Calls to be transfered to an operator is handed off to Attendant process.
• Retrieval: The routing process picks up the call from the PBX and parses call detail information. Once the Routing process determines that it's a retrieval call type, the call is handed off to the retrieval process. The retreival process interacts with Oracle Internet Directory and the Oracle Voicemail & Fax mail store. For reply and forward, the call is handed off to the recording process and for transfers, the call is handed off to the attendant process.
• MWI: When a new voice mail message arrives into a Oracle Voicemail & Fax telephony subscriber's inbox, a Message Waiting Indicator (MWI) activation request is generated for the AQMWI process. The AQMWI process interacts with Oracle Internet Directory, looks up the corresponding MWI Service process and relays the request to that MWI service process. Conversely, when there are no more unread voice mail Messages in the Oracle Voicemail & Fax telephony subscriber's inbox, an MWI deactivation request is generated to the AQMWI process and the same procedure is followed. MWI Service process performs activates and deactivates MWI for a specific PBX location.

Routing Process

When the mail server receives a call from the PBX, the routing process answers the call. This process retrieves call detail information from the PBX. This information indicates whether the current call was a direct call to the voice mail system or a forwarded call from a busy or unanswered extension. The routing process routes forwarded calls to the voice mail recording process and direct calls to voice mail retrieval process. If no call detail information is available, the routing process enables the caller to choose whether to access voice mail recording or voice mail retrieval. The routing process maintains a pool of worker threads. Each thread can handle one call at any time. The routing process can retrieve call details through SMDI or CTMEDIA.

Voice Mail Recording Process

The Oracle Voicemail & Fax voice mail recording process records and sends voice mail messages. Messeges can be sent through regular delivery or can be marked as "urgent" prior to sending. The voice mail recording process maintains a pool of worker threads. Each thread can handle one call at any time. There are four scenarios in which the caller interacts with the recording process:

• Normal Recording: When the routing process receives a forwarded call, the process routes the call to voice mail recording and provides the extension number of the call's intended recipient. Voice mail recording acquires the recipient's information from Oracle Internet Directory. The process verifies that the recipient has telephone access enabled and plays the recipient's greeting message: a personal greeting, a vacation greeting, a default greeting with a recorded name, or a default greeting with a telephone number. If a fax calling tone is detected while the greeting is played, the call is routed to the fax receiving process. The caller records a message, and can choose to edit it. Finally, the voice mail recording interacts with the Computer Telephony Server (CT Server) to store the voice mail in the mail store.
• Unknown Origin Recording: When the routing process receives a call without call detail information and the caller chooses to record a message, the routing process routes the call to the voice mail recording process, which prompts the caller for the recipient's telephone number. The system looks up the user in Oracle Internet Directory and plays the user's greeting.
• Reply to a Message: When users choose to reply through the telephone user interface to a voice mail from another Oracle Voicemail & Fax user, the voice mail retrieval process routes the call to voice mail recording. This process plays a generic system greeting, and then the user records a message and can choose to edit it. The message's recipient is the sender of the original message. Finally, voice mail recording interacts with the Computer Telephony Server (CT Server) to store the voice mail in the mail store.
• Forward a Message: When users choose to forward a message through the telephone user interface, the voice mail retrieval process routes the call to voice mail recording. This process plays a generic system greeting, and then the user records a message, addresses it, and can choose to edit it. Finally, voice mail recording interacts with the Computer Telephony Server (CT Server) to store the voice mail in the mail store.
• Authenticated User Recording: When users choose to compose a message while they are logged in through the telephone user interface, the retrieval process transfers them to recording. The recording process plays a generic system greeting, and then the users record a message, addresses it, and can choose to edit it. Finally, voice mail recording interacts with the CT Server to store the voice mail in the mail store.
• Transfer from Retrieval: When users in the retrieval process press the star key before logging in, they are routed to the recording process and the call is handled as an Unknown Origin Recording call.

If there are any delivery problems while sending a message, the recording process places the message in a file system queue. The recovery process attempts to redeliver the message. This may occur if the mail store database is unavailable.

Voice Mail Retrieval Process

The voice mail retrieval process enables users to log in, retrieve messages, administer their accounts, reply to and forward messages, and record new messages for users. This process maintains a pool of worker threads each of which can process one call at any time. All calls to this process arrive through the routing process.

The retrieval process prompts the caller to enter an extension number and password, and authenticates him or her against a user object in the Oracle Internet Directory server. Upon a successful authentication, this process interacts with the CT server to retrieve voicemail messages and other account information. The voice mail retrieval process enables the user to listen to, save, and delete voice mail messages. Users can also set a PIN, and record or administer greetings. Account information for the user is stored in Oracle Internet Directory.

Attendant Process

The attendant process receives a call when the caller chooses to transfer to an operator during an interaction with the voice mail recording process or the retrieval process. The attendant process looks up the operator extension in the user's group profile, and if none exist, it looks up the default extension defined in the process properties.

Fax Receiving Process

The fax receiving process receives fax messages. This process maintains a pool of worker threads each of which can process one call at any time. All calls arrive through the voice mail recording process when a fax calling tone is detected. This process receives a fax message and then delivers it to the e-mail server mail store by communicating with the CT server.

Recovery Process

The recovery process attempts to redeliver messages if the voice mail recording or fax receiving process experience errors when communicating with the mail store. This process wakes periodically and attempts to send any messages found in the file system queue. Once the recovery process can successfully send a message, the process dequeues any messages.

Process Manager Process

The RMI service enables remote process startup for all Windows based processes for Oracle Voicemail & Fax. The RMI service registers itself with the RMI registry and RMID activation daemon. Client programs, like the Oracle Enterprise Manager JSP pages invoke a remote method in this RMI service to start up a specific process instance. When this service receives the request, it creates a service in the Windows Registry for the specified process instance and starts it up. If the service is already installed, it restarts the existing service.

Processes managed by this RMI service are:

• Routing Process
• Voice Mail Recording Process
• Voice Mail Retrieval Process
• Attendant Process
• Recovery Process
• Fax Receiving Process
• MWI Service Process

rmiregistry and the rmid must be running before the RMI service can be started.

MWI Service Process

The MWI service process activates and deactivates the message waiting indicators for a specific PBX in response to requests received through Java RMI. This process maintains either an SMDI or a CTMEDIA connection with the PBX. At least one MWI service process should be running for each PBX with voice mail users. The AQMWI process initiates RMI requests for this process.

AQMWI Process

The AQ MWI Process retrieves Message Waiting Indicator (MWI) activation or deactivation requests from an advanced queue (AQ), and routes them to an MWI service process through Java Remote Method Invocation (RMI). When a user receives a new voice mail, the mail store inserts into an AQ a request to activate that user's MWI. When a user reads his or her last unread voice mail, the mail store inserts into an AQ a request to deactivate that user's MWI. The AQMWI Process retrieves the request from the AQ, looks up the user's telephone number and finds an MWI service process responsible for handling MWI for that telephone number. Finally, the AQ MWI Process sends the MWI request to that MWI service process through Java RMI.

Managing Oracle Voicemail & Fax Processes

This section describes how to start, stop, reinitialize, and modify Oracle Voicemail & Fax processes.

Starting, Stopping, or Reinitializing All Oracle Voicemail & Fax Processes

Starting an Oracle Voicemail & Fax process starts all the processes comprising that service type.

Stopping an Oracle Voicemail & Fax system sends a request to the operating system to shut down all of the Oracle Voicemail & Fax processes. A reason and administrator would want to stop the Oracle Voicemail & Fax system is to perform maintenance, such as upgrading the server hardware or software. It is not possible for the processes to be running while certain kinds of upgrades are performed.

Reinitializing an Oracle Voicemail & Fax process informs the operating system to reload its operational settings from the Oracle Internet Directory server. The process does not stop running, which means that users continue to receive uninterrupted service. Whenever a Oracle Voicemail & Fax process parameter is modified, it must be reinitialized to make the changes take effect.

Using Oracle Enterprise Manager, perform the following steps to start, stop, or reinitialize all Oracle Voicemail & Fax processes:

1. Navigate to the Oracle Voicemail & Fax Service Targets page.
2. Select an Oracle Voicemail & Fax process.
3. Click Start, Stop, or Reinitialize.

Creating an Oracle Voicemail & Fax Process Instance

Using Oracle Enterprise Manager, perform the following steps to create an Oracle Voicemail & Fax process instance:

To create a new Oracle Voicemail & Fax process instance with default parameters:

1. Navigate to the Oracle Voicemail & Fax Service Targets page.
2. Select an Oracle Voicemail & Fax process.
3. Click Create. This creates a new Oracle Voicemail & Fax process instance with default parameters.

To create a new Oracle Voicemail & Fax process instance with the same parameter values as an existing Oracle Voicemail & Fax process instance:

1. Select the instance with the parameters you want to replicate.
2. Click Create Like. This creates a new Oracle Voicemail & Fax process instance with the same parameters as the selected Oracle Voicemail & Fax process instance.

Deleting an Oracle Voicemail & Fax Process Instance

Using Oracle Enterprise Manager, perform the following steps to delete an Oracle Voicemail & Fax process instance:

1. Navigate to the Oracle Voicemail & Fax Service Targets page.
2. Select an Oracle Voicemail & Fax process.
3. Select the Oracle Voicemail & Fax process instance you want to delete.
4. Click Delete.

Starting an Oracle Voicemail & Fax Process Instance

Using Oracle Enterprise Manager, perform the following steps to start an Oracle Voicemail & Fax process instance:

1. Navigate to the Oracle Voicemail & Fax Service Targets page.
2. Select an Oracle Voicemail & Fax process.
3. Select the Oracle Voicemail & Fax process instance you want to start.
4. Click Start.

Stopping an Oracle Voicemail & Fax Process Instance

Using Oracle Enterprise Manager, perform the following steps to stop an Oracle Voicemail & Fax process instance:

1. Navigate to the Oracle Voicemail & Fax Service Targets page.
2. Select an Oracle Voicemail & Fax process.
3. Select the Oracle Voicemail & Fax process instance you want to stop.
4. Click Stop.

Reinitializing a Oracle Voicemail & Fax Process Instance

Using Oracle Enterprise Manager, perform the following steps to reinitialize an Oracle Voicemail & Fax process instance:

1. Navigate to the Oracle Voicemail & Fax Service Targets page.
2. Select an Oracle Voicemail & Fax process.
3. Select the Oracle Voicemail & Fax process instance you want to reinitialize.
4. Click Reinitialize.

Modifying Parameters for a Specific Oracle Voicemail & Fax Instance

Using Oracle Enterprise Manager, perform the following steps to modify parameters for a specific Oracle Voicemail & Fax process instance:

1. Navigate to the Oracle Voicemail & Fax Service Targets page.
2. Select an Oracle Voicemail & Fax process.
3. Select the Oracle Voicemail & Fax instance you want to modify.
4. Modify the parameters you want to change.
5. Click Apply.

Modifying Oracle Voicemail & Fax Process Parameters

Using Oracle Enterprise Manager, perform the following steps to modify Oracle Voicemail & Fax process default parameters:

1. Navigate to the Oracle Voicemail & Fax Service Targets page.
2. Select an Oracle Voicemail & Fax process.
3. Select Change Settings.
4. Modify the parameters you want to change.
5. Click Apply.

Oracle Voicemail & Fax Process Parameters

The following is a list of Oracle Voicemail & Fax process parameters and definitions:

Routing Process

Log Level

This parameter specifies the log level parameter that controls amount of logging performed by the UM process.

Acceptable Values:

• INTERNALERROR
• ERROR
• WARNING
• NOTIFICATION
• TRACE

Default Value: WARNING

Active Flag

This parameter specifies whether the instance is running.

Acceptable Values = True or False

Default Value: None

Number of Threads per Process

This parameter specifies the number of threads for this routing process within one JVM.

Acceptable Values: None

Default Value: None

Root Context for UM

This parameter specifies the distinguished name of the Oracle Voicemail & Fax container in Oracle Internet Directory. This domain name's subtree contains Oracle Voicemail & Fax - specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Root Context for ES

This parameter specifies the distinguished name of the e-mail server container in Oracle Internet Directory. This domain name's subtree contains e-mail server - specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Install Context for UM

This parameter specifies UM Install Context. For example, um_system.

Acceptable Value: The name of a UM Install Context

Default Value: None

Voice Mail Recording Process

Maximum Message Recording Duration

This parameter specifies the maximum length of a recorded message in milliseconds.

Acceptable Value: A string of digits

Default Value: 120000

Maximum Silence Duration

This parameter specifies the amount of continuous silence which causes message recording to stop.

Acceptable Value: A string of digits

Default Value: 10000

Log Level

This parameter specifies the log level parameter that controls amount of logging performed by the Oracle Voicemail & Fax process.

Acceptable Values:

• INTERNALERROR
• ERROR
• WARNING
• NOTIFICATION
• TRACE

Default Value: WARNING

Active Flag

This parameter specifies whether the instance is running.

Acceptable Values: True or False

Default Value: None

Number of Threads per Process

This parameter specifies number of threads for this Oracle Voicemail & Fax process within one JVM.

Acceptable Value: A positive integer

Default Value: None

Root Context for UM

This parameter specifies the distinguished name of the Oracle Voicemail & Fax container in Oracle Internet Directory. This domain name's subtree contains Oracle Voicemail & Fax specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Root Context for ES

This parameter specifies the distinguished name of the e-mail server container in Oracle Internet Directory. This domain name's subtree contains e-mail server specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Install Context for UM

This parameter specifies UM Install Context

Acceptable Value: A valid UM Install Context

Default Value: None

CT Server Name

This parameter specifies the host name of the machine where the CT server is installed. The name should be in the following format:

<hostname>:<port number>

The port number is 2019.

Acceptable Value: A valid host name

Default Value: None

CT Server Application Profile Name

This parameter specifies the name of the CT server profile that contains application configuration information.

Acceptable Value: A valid CT server profile name

Default Value: None

CT Server Group Configuration

This parameter specifies the name of the CT server group configuration that represents a collection of resources.

Acceptable Value: A valid CT server group configuration

Default Value: None

CT Application Service Name

This parameter is the CT Server Application Service ID (ASI), and is the name application uses to register itself with the CT Server.

Acceptable Value: A valid CT server application service name

Default Value: None

CTMEDIA Call Timeout Value

This parameter specifies the time (in seconds) CTMEDIA waits to configure resources for this application.

Acceptable Value: A string of digits

Default Value: None

Message Coder Type

This parameter specifies audio coder type for voice mail messages.

Acceptable Value: A valid audio coder type

Default Value: v_Linear8Bit_64k

Greeting Coder Type

This parameter specifies the audio coder type for greetings and recorded names.

Acceptable Value: A valid audio coder type

Default Value: v_Linear8Bit_64k

Mail Box Minimum Length

This number specifies the minimum number of digits that can be entered by the user for the application to be able to resolve the user's mailbox number.

Acceptable Value: A positive integer

Default Value: None

Mail Box Maximum Length

This parameter specifies the maximum number of digits permitted for the mailbox number.

Acceptable Value: A positive integer

Default Value: None

International Number Prefix List

This parameter defines a mapping between PBX extension numbers and international telephone numbers. The mapping is list of submappings separated by semicolons. Each submapping follows the form:

<international prefix> <PBX prefix>
 

where <international prefix> is the sequence of digits which should be appended to a PBX extension number beginning with <PBX prefix>. If the prefix list is 1650506;1650607, the extension 60000 is mapped to 16505060000, and 70000 is mapped to 16506070000.

Acceptable Value: A string of digits delimited by a semicolon

Default Value: None

Prefix to be Added to the PBX Number

This parameter specifies the prefix that needs to be added to the phone numbers that are sent to the application through the PBX in order to formulate a phone number in the international format

Acceptable Value: A string of digits

Default Value: 1

Length of the Number Sent by the PBX

This parameter specifies the number of digits that the PBX sends.

Acceptable Value: A positive integer

Default Value: 10

Directory Name for Stored Queued Messages

This parameter specifies the directory where the undelivered messages are stored for future delivery.

Acceptable Value: A full file system directory path

Default Value: None

Fax Receiving Application DN

This parameter specifies the distinguished name entry for the fax receiving application instance where fax calls are routed.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Attendant Application DN

This parameter specifies the distinguished nameentry for the attendant application instance where the calls are routed to when transferred to operator function.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Voice Mail Retrieval Process

Maximum Greeting Recording Duration

This parameter specifies the maximum length of a recorded greeting in milliseconds.

Acceptable Value: A string of digits

Default Value: 30000

Maximum Silence Duration

This parameter specifies the amount of continuous silence that causes the greeting recording to stop in milliseconds.

Acceptable Value: A string of digits

Default Value: 10000

Log Level

This parameter specifies the log level parameter that controls amount of logging performed by the Oracle Voicemail & Fax process.

Acceptable Values:

• INTERNALERROR
• ERROR
• WARNING
• NOTIFICATION
• TRACE

Default Value: WARNING

Active Flag

This parameter specifies whether the instance is running.

Acceptable Values: True or False

Default Value: None

Number of Threads per Process

This parameter specifies the number of threads for this Oracle Voicemail & Fax process within one JVM.

Acceptable Value: A positive integer

Default Value: None

Root Context for UM

This parameter specifies the distinguished name of the Oracle Voicemail & Fax container in Oracle Internet Directory. This domain name's subtree contains Oracle Voicemail & Fax specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Root Context for ES

This parameter specifies the distinguished name of the e-mail server container in Oracle Internet Directory. This domain name's subtree contains e-mail server specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Install Context for UM

This parameter specifies the UM Install Context

Acceptable Value: A valid UM Install Context

Default Value: None

CT Server Name

This parameter specifies the host name of the machine where the CT server is installed. The name should be in the following format:

<hostname>:<port number>

The port number is 2019.

Acceptable Value: A valid host name

Default Value: None

CT Server Application Profile Name

This parameter specifies the name of the CT server profile that contains application configuration information.

Acceptable Value: A valid CT server profile name

Default Value: None

CT Server Group Configuration

This parameter specifies the name of the CT server group configuration that represents a collection of resources.

Acceptable Value: A valid CT server group configuration

Default Value: None

CT Application Service Name

This parameter is the CT Server Application Service ID (ASI), and is the name application uses to register itself with the CT Server.

Acceptable Value: A valid CT server application service name

Default Value: None

CTMEDIA Call Timeout Value

This parameter specifies the time (in seconds) CTMEDIA waits to configure resources for this application.

Acceptable Value: A string of digits

Default Value: None

Message Coder Type

This parameter specifies audio coder type for voice mail messages.

Acceptable Value: A valid audio coder type

Default Value: v_Linear8Bit_64k

Greeting Coder Type

This parameter specifies the audio coder type for greetings and recorded names.

Acceptable Value: A valid audio coder type

Default Value: v_Linear8Bit_64k

Mail Box Minimum Length

This number specifies the minimum number of digits that can be entered by the user for the application to be able to resolve the user's mailbox number.

Acceptable Value: A positive integer

Default Value: None

Mail Box Maximum Length

This parameter specifies the maximum number of digits permitted for the mailbox number.

Acceptable Value: A positive integer

Default Value: None

Maximum Allowed Digits in Pin Number

This parameter specifies the maximum number of digits allowed for the PIN.

Acceptable Value: A positive integer

Default Value: None

Minimum Allowed Digits in Pin Number

This parameter specifies the minimum number of digits allowed for the PIN. If the PIN entered by the user does not fall within the minimum and maximum range, it is rejected.

Acceptable Value: A positive integer

Default Value: None

International Number Prefix List

This parameter defines a mapping between PBX extension numbers and international telephone numbers. The mapping is list of submappings separated by semicolons. Each submapping follows the form:

<international prefix> <PBX prefix>
 

where <international prefix> is the sequence of digits which should be appended to a PBX extension number beginning with <PBX prefix>. If the prefix list is 1650506;1650607, the extension 60000 is mapped to 16505060000, and 70000 is mapped to 16506070000.

Acceptable Value: A positive integer

Default Value: None

Prefix to Be Added to the PBX Number

This parameter specifies the prefix that needs to be added to the phone numbers that are sent to the application through the PBX in order to formulate a phone number in the international format.

Acceptable Value: A positive integer

Default Value: 1

Length of the Number Sent by the PBX

This parameter specifies the number of digits that the PBX sends.

Acceptable Value: A positive integer

Default Value: 10

Voice Recording Application DN

This parameter specifies the distinguished name entry for the recording application instance to which recording calls are routed.

Acceptable Value: A valid Oracle Internet Directory distinguished name.

Default Value: None

Attendant Application DN

This parameter specifies the distinguished name entry for attendant application instance which the calls are routed to when transferred to the operator function.

Acceptable Value: A valid Oracle Internet Directory distinguished name.

Default Value: None

Attendant Process

Log Level

This parameter specifies the log level parameter that controls amount of logging performed by the Oracle Voicemail & Fax process.

Acceptable Values:

• INTERNALERROR
• ERROR
• WARNING
• NOTIFICATION
• TRACE

Default Value: WARNING

Active Flag

This parameter specifies whether the instance is running.

Acceptable Values: True or False

Default Value: None

Number of Threads per Process

This parameter specifies the number of threads for this Oracle Voicemail & Fax process within one JVM.

Acceptable Value: A positive integer

Default Value: None

Root Context for UM

This parameter specifies the distinguished name of the Oracle Voicemail & Fax container in Oracle Internet Directory. This domain name's subtree contains Oracle Voicemail & Fax specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Root Context for ES

This parameter specifies the distinguished name of the e-mail server container in Oracle Internet Directory. This domain name's subtree contains e-mail server specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Install Context for UM

This parameter specifies UM Install Context

Acceptable Value: A valid UM Install Context

Default Value: None

CT Server Name

This parameter specifies the host name of the machine where the CT server is installed. The name should be in the following format:

<hostname>:<port number>

The port number is 2019.

Acceptable Value: A valid host name

Default Value: None

CT Server Application Profile Name

This parameter specifies the name of the CT server profile that contains application configuration information.

Acceptable Value: A valid CT server profile name

Default Value: None

CT Server Group Configuration

This parameter specifies the name of the CT server group configuration that represents a collection of resources.

Acceptable Value: A valid CT server group configuration

Default Value: None

CT Application Service Name

This parameter is the CT Server Application Service ID (ASI), and is the name application uses to register itself with the CT Server.

Acceptable Value: A valid CT server application service name

Default Value: None

CTMEDIA Call Timeout Value

This parameter specifies the time (in seconds) CTMEDIA waits to configure resources for this application.

Acceptable Value: A string of digits

Default Value: None

Dialing Number For Attendant

A PBX-dialable working telephone number where the calls are routed to when they are transferred to the operator function.

Acceptable Value: A string of digits

Default Value: None

Fax Receiving Process

Log Level

This parameter specifies the log level parameter that controls amount of logging performed by the Oracle Voicemail & Fax process.

Acceptable Values:

• INTERNALERROR
• ERROR
• WARNING
• NOTIFICATION
• TRACE

Default Value: WARNING

Active Flag

This parameter specifies whether the instance is running.

Acceptable Values: True or False

Default Value: None

Number of Threads per Process

This parameter specifies the number of threads for this Oracle Voicemail & Fax process within one JVM.

Acceptable Value: A positive integer

Default Value: None

Root Context for UM

This parameter specifies the distinguished name of the Oracle Voicemail & Fax container in Oracle Internet Directory. This domain name's subtree contains Oracle Voicemail & Fax specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Root Context for ES

This parameter specifies the distinguished name of the e-mail server container in Oracle Internet Directory. This domain name's subtree contains e-mail server specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Install Context for UM

This parameter specifies UM Install Context

Acceptable Value: A valid UM Install Context

Default Value: None

CT Server Name

This parameter specifies the host name of the machine where the CT server is installed. The name should be in the following format:

<hostname>:<port number>

The port number is 2019.

Acceptable Value: A valid host name

Default Value: None

CT Server Application Profile Name

This parameter specifies the name of the CT server profile that contains application configuration information.

Acceptable Value: A valid CT server profile name

Default Value: None

CT Server Group Configuration

This parameter specifies the name of the CT server group configuration that represents a collection of resources.

Acceptable Value: A valid CT server group configuration

Default Value: None

CT Application Service Name

This parameter is the CT Server Application Service ID (ASI), and is the name application uses to register itself with the CT Server.

Acceptable Value: A valid CT server application service name

Default Value: None

CTMEDIA Call Timeout Value

This parameter specifies the time (in seconds) CTMEDIA waits to configure resources for this application.

Acceptable Value: A string of digits

Default Value: None

Mail Box Minimum Length

This number specifies the minimum number of digits that can be entered by the user for the application to be able to resolve the user's mailbox number.

Acceptable Value: A positive integer

Default Value: None

Mail Box Maximum Length

This parameter specifies the maximum number of digits permitted for the mailbox number.

Acceptable Value: A positive integer

Default Value: None

International Number Prefix List

This parameter defines a mapping between PBX extension numbers and international telephone numbers. The mapping is list of submappings separated by semicolons. Each submapping follows the form:

<international prefix> <PBX prefix>
 

where <international prefix> is the sequence of digits which should be appended to a PBX extension number beginning with <PBX prefix>. If the prefix list is 1650506;1650607, the extension 60000 is mapped to 16505060000, and 70000 is mapped to 16506070000.

Acceptable Value: A positive integer

Default Value: None

Prefix to Be Added to the PBX Number

This parameter specifies the prefix that needs to be added to the phone numbers that are sent to the application through the PBX in order to formulate a phone number in the international format.

Acceptable Value: A positive integer

Default Value: 1

Length of the Number Sent by the PBX

This parameter specifies the number of digits that the PBX sends.

Acceptable Value: A positive integer

Default Value: 10

Directory Name for Stored Queued Messages

This parameter specifies the directory where the undelivered messages are stored for future delivery.

Acceptable Value: A file system directory path

Default Value: None

Recovery Process

Log Level

This parameter specifies the log level parameter that controls amount of logging performed by the Oracle Voicemail & Fax process.

Acceptable Values:

• INTERNALERROR
• ERROR
• WARNING
• NOTIFICATION
• TRACE

Default Value: WARNING

Active Flag

This parameter specifies whether the instance is running.

Acceptable Values: True or False

Default Value: None

Number of Threads per Process

This parameter specifies the number of threads for this Oracle Voicemail & Fax process within one JVM.

Acceptable Value: A positive integer

Default Value: None

Root Context for UM

This parameter specifies the distinguished name of the Oracle Voicemail & Fax container in Oracle Internet Directory. This domain name's subtree contains Oracle Voicemail & Fax specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Root Context for ES

This parameter specifies the distinguished name of the e-mail server container in Oracle Internet Directory. This domain name's subtree contains e-mail server specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Install Context for UM

This parameter specifies UM Install Context

Acceptable Value: A valid UM Install Context

Default Value: None

CT Server Name

This parameter specifies the host name of the machine where the CT server is installed.

The name should be in the following format:

<hostname>:<port number>

The port number is 2019.

Acceptable Value: A valid host name

Default Value: None

CT Server Application Profile Name

This parameter specifies the name of the CT server profile that contains application configuration information.

Acceptable Value: A valid CT server profile name

Default Value: None

CT Server Group Configuration

This parameter specifies the name of the CT server group configuration that represents a collection of resources.

Acceptable Value: A valid CT server group configuration

Default Value: None

CT Application Service Name

This parameter is the CT Server Application Service ID (ASI), and is the name application uses to register itself with the CT Server.

Acceptable Value: A valid CT server application service name

Default Value: None

CTMEDIA Call Timeout Value

This parameter specifies the time (in seconds) CTMEDIA waits to configure resources for this application.

Acceptable Value: A string of digits

Default Value: None

Process Manager Process

Log Level

This parameter specifies the log level parameter that controls amount of logging performed by the Oracle Voicemail & Fax process.

Acceptable Values:

• INTERNALERROR
• ERROR
• WARNING
• NOTIFICATION
• TRACE

Default Value: WARNING

Process ID

This parameter specifies the process identification.

Acceptable Values: None

Default Value: None

Active Flag

This parameter specifies whether the instance is running.

Acceptable Values: True or False

Default Value: None

Root Context for UM

This parameter specifies the distinguished name of the Oracle Voicemail & Fax container in Oracle Internet Directory. This domain name's subtree contains Oracle Voicemail & Fax specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Root Context for ES

This parameter specifies the distinguished name of the e-mail server container in Oracle Internet Directory. This domain name's subtree contains e-mail server specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

JavaHome

Full path name of the Java home directory that is used to locate the java.exe executable.

Acceptable Value: A file system directory path

Default Value: None

System Root

Full path name of the Windows system root directory that is used to located cmd.exe and any other windows system executables.

Acceptable Value: A file system directory path

Default Value: None

ResourceKit Home

This parameter specifies the full path name of the Windows resource kit directory. Is used to locate the srvany.exe, instsrv.exe, sc.exe, and other resource kit executables.

Acceptable Value: A file system directory path

Default Value: None

CTMEDIA Home

Full path name of the CTMEDIA directory that issued to locate the libraries and dlls under CTMEDIA\Shared Files folder.

Acceptable Value: A file system directory path

Default Value: None

MWI Service Process

Log Level

This parameter specifies the log level parameter that controls amount of logging performed by the Oracle Voicemail & Fax process.

Acceptable Values:

• INTERNALERROR
• ERROR
• WARNING
• NOTIFICATION
• TRACE

Default Value: WARNING

Set of International Phone Numbers

This parameter specifies the set of phone numbers for which this process controls MWI activation or deactivation. The set is the union of all phone number subsets listed under this attribute.

Acceptable Value: A semicolon-delimited list of international phone number subsets. A phone number subset is a string of digits and asterisk characters which are wildcards. For example, 1650506****; 1650507****.

Default Value: None

RMI URL

This parameter specifies the RMI URL of the MWI service. The MWI service registers as an RMI service with the name <service name>. If a port number is specified, the MWI service registers with the RMI registry on that port. Otherwise, it uses the default port. Other processes use the entire RMI URL to connect to this MWI service through RMI.

Acceptable Value: A well-formed URL for RMI.

Default Value: None

PBX integration type

This parameter specifies the PBX connection type. If the type is CTMEDIA, then this process attempts to set or unset MWI through CTMEDIA. If the type is SMDI, attempts to set or unset MWI through an SMDI monitor process.

Acceptable Values: SMDI or CTMEDIA

Default Value: None

SMDI Monitor Host Name

This parameter specifies the host name of a machine running the SMDI monitor.

Acceptable Value: A valid host name

Default Value: None

SMDI Monitor Port

This parameter specifies the port number on which the SMDI monitor accepts connections.

Acceptable Value: A valid TCP port number

Default Value: None

SMDI Monitor Timeout Value

This parameter specifies the timeout (in milliseconds) for socket communication with the SMDI monitor.

Acceptable Value: A positive integer

Default Value: None

MWI Phone Number Suffix Size for SMDI

Indicates the number of digits from the phone number to pass to the SMDI monitor. If the suffix size is five, then the rightmost five digits of phone number are used, and the rest are discarded. If the SMDI MWI prefix is defined, it is prepended to those five digits.

Acceptable Value: A positive integer

Default Value: None

MWI Phone Number Prefix for CTMedia

A string of digits to be prepended to a phone number (after suffix truncation) before it is passed to the CTMEDIA service.

Acceptable Value: A string of digits

Default Value: None

CTMEDIA MWI Provider Name

This parameter specifies the provider string for the CT server which hosts the MWI session service.

Acceptable Value: An IT Media provider string of the following form <profilename>@<server>:<port>

Default Value: None

CTMEDIA MWI Service Name

This parameter specifies the name of the MWI session service.

Acceptable Value: A valid name of a CTMEDIA session service.

Default Value: MWI service

MWI Phone Number Suffix Size for CTMEDIA

Indicates the number of digits from the phone number to pass to the CTMEDIA service. If the suffix size is 5, the rightmost 5 digits of phone number are used, and the rest are discarded. The CTMEDIA MWI prefix, if one is defined, is then prepended to those 5 digits.

Acceptable Value: A positive integer

Default Value: None

MWI Phone Number Prefix for CTMedia

A string of digits to be prepended to a phone number (after suffix truncation) before it is passed to the CTMEDIA service.

Acceptable Value: A string of digits

Default Value: None

AQMWI Process

Log Level

This parameter specifies the log level parameter that controls amount of logging performed by the Oracle Voicemail & Fax process.

Acceptable Values:

• INTERNALERROR
• ERROR
• WARNING
• NOTIFICATION
• TRACE

Default Value: WARNING

Number of Threads

This parameter specifies the number of threads which should be listening to the AQ and processing MWI requests.

Acceptable Value: A positive integer

Default Value: 1

Port number of AQ DB Listener

This parameter specifies the port number on which the database listens for connections.

Acceptable Value: A valid TCP port number

Default Value: 1521

Connect string for AQ DB

This parameter specifies the connect string for the database which holds the AQ.

Acceptable Value: A valid Oracle connect string

Default Value: None

AQ name

This parameter specifies the name of the AQ on which MWI requests are made.

Acceptable Value: A valid name for an Oracle Advanced Queue

Default Value: None

User ID for connecting to the database

This parameter specifies the user ID for connecting to the database.

Acceptable Value: A valid oracle user ID

Default Value: None

Password for connecting to the database

This parameter specifies the password for connecting to the database.

Acceptable Value: A valid oracle user password

Install Root Context

This parameter specifies the distinguished name of the container for this installation in Oracle Internet Directory. This domain name's subtree contains information specific to a Oracle Voicemail & Fax installation.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Root Context for UM

This parameter specifies the distinguished name of the Oracle Voicemail & Fax container in Oracle Internet Directory. This domain name's subtree contains Oracle Voicemail & Fax specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Root Context for ES

This parameter specifies the distinguished name of the e-mail server container in Oracle Internet Directory. This domain name's subtree contains e-mail server specific information.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Process Root Context

This parameter specifies the domain name of the e-mail server container in Oracle Internet Directory. The subtree of this domain name contains configuration information for all processes.

Acceptable Value: A valid Oracle Internet Directory distinguished name

Default Value: None

Oracle Voicemail & Fax Log Files

The following is a list of Oracle Voicemail & Fax log file locations:

Routing Process

On Windows:

%ORACLE_HOME\um\log\UMMediaApp

Voice Mail Recording Process:

On Windows:

%ORACLE_HOME\um\log\VMrecordingMediaApp

Voice Mail Retrieval Process

On Windows:

%ORACLE_HOME\um\log\VMretrievalMediaApp

Attendant Process

On Windows:

%ORACLE_HOME\um\log\AttendantMediaAPP

Fax Receiving Process

On Windows:

%ORACLE_HOME\um\log\FaxReceivingMediaApp

Recovery Process

On Windows:

%ORACLE_HOME\um\log\DBRecovery

Process Manager Process

On Windows:

%ORACLE_HOME\um\log\ProcessMgrService

MWI Service Process

On Windows:

%ORACLE_HOME\um\log\MWIService

AQMWI Process

On UNIX:

$ORACLE_HOME/um/log/AQMWIStarter

On Windows:

%ORACLE_HOME\um\log\AQMWIStarter