B Process Parameters

This appendix describes the Oracle Voicemail & Fax parameters. The parameters are set on the administration pages for the Voicemail & Fax group, Voicemail & Fax Application, and each of the services.

Note: Not all parameters apply at each level of the hierarchy, or for each of the services.

See Also: Note 416319.1 on http://www.metalink.com for information discovered after this document was published.

Database Buffers Parameters

The Database Buffers parameters specify the size of the read and write buffers (Table B-1).

Table B-1 Database Buffers Parameters

Parameter Name	Description	Valid Values/Default Value
Collaboration Suite Database Read Buffer Size	The amount of data that is read from the database in one read operation during retrieval of voicemail messages.	Valid Values: Positive integer Default Value: 102400 bytes
Collaboration Suite Database Write Buffer Size	The amount of data that is written to the database in one write operation during the sending of voicemail messages.	Valid Values: Positive integer Default Value: 524288 bytes

General Parameters

General parameters do not fit any other category of parameters. The general parameters for each of the services are described in the sections that follow.

Miscellaneous Services

There is only one parameter for the Call Transfer Service, Fax Receiving Service, and Interactive Voice Response Service (Table B-2).

Table B-2 General Parameters for Miscellaneous Services

Parameter Name	Description	Valid Values/Default Value
Threads Per Process	Number of worker threads for this service within one Java Virtual Machine (JVM).	Valid Values: A positive value. Default Value: 4

Message Delivery Monitor Service

Table B-3 shows the general parameter for the Message Delivery Monitor Service.

Table B-3 General Parameter for the Message Delivery Monitor Service

Parameter Name	Description	Valid Values/Default Value
Process Sleep Duration	Test messages are sent from the Oracle Voicemail & Fax system to a test account on the Oracle Collaboration Suite Database. This parameter specifies the time interval between test messages.	Valid Values: 0 – 2147483647 seconds Default Value: 600 seconds

Message Waiting Indicator Service

Table B-4 shows the general parameters for the Message Waiting Indicator Service.

Table B-4 General Parameters for Message Waiting Indicator Service

Parameter Name	Description	Valid Values/Default Value
Process Sleep Duration	Number of milliseconds an MWI service instance thread sleeps between back-to-back MWI requests.	Valid Values: Positive integer Default Value: 250
Collaboration Suite Database Physical Connection Time	Number of seconds a physical database connection between an MWI service instance and an Oracle Collaboration Suite Database is idle before the connection is broken.	Valid Values: Positive integer Default Value: 3600
MWI Mode	In Dispatch mode, the MWI Service processes Oracle Collaboration Suite Database requests. In Notify mode, the MWI Service sets the message waiting indicator on the PBX.	Valid Values: Dispatch and Notify, Dispatch, Notify Default Value: Dispatch and Notify

Recording Service

Table B-5 shows the general parameters for the Recording Service.

Table B-5 General Parameters for the Recording Service

Parameter Name	Description	Valid Values/Default Value
Threads Per Process	Number of threads for this service within one JVM.	Valid Values: A positive value. Default Value: 4
Transfer Application DN	Distinguished name entry for the transfer service. This is the service to which calls are routed when a user chooses to transfer to an attendant.	Valid Values: A valid Oracle Internet Directory distinguished name Default Value: cn=%LDAPComputerName% : %installhome% : transfer, cn=ovf, cn=%ct_orahome%, cn=%LDAPComputerName%, cn=Computers, cn=oraclecontext
Fax Receiving Application DN	Distinguished name entry for the fax receiving service. This is the service to which fax calls are routed.	Valid Values: A valid Oracle Internet Directory distinguished name Default Value: cn=%LDAPComputerName% : %installhome% : faxrecv, cn=ovf, cn=%ct_orahome%, cn=%LDAPComputerName%, cn=Computers, cn=oraclecontext

Retrieval Service

Table B-6 shows the general parameters for the Retrieval Service.

Table B-6 General Parameters for the Retrieval Service

Parameter Name	Description	Valid Values/Default Value
Threads Per Process	Number of worker threads for this service within one Java Virtual Machine (JVM).	Valid Values: A positive value. Default Value: 4
Recording Application DN	Distinguished name entry for the recording service. This is the service to which forwarded calls are routed. Forwarded calls are calls to the voicemail system to record a voicemail message or to send a fax.	Valid Values: A valid Oracle Internet Directory distinguished name Default Value: cn=%LDAPComputerName% : %installhome% : recording, cn=ovf, cn=%ct_orahome%, cn=%LDAPComputerName%, cn=Computers, cn=oraclecontext
Transfer Application DN	Distinguished name entry for the transfer service. This is the service to which calls are routed when a user chooses to transfer to an attendant.	Valid Values: A valid Oracle Internet Directory distinguished name Default Value: cn=%LDAPComputerName% : %installhome% : transfer, cn=ovf, cn=%ct_orahome%, cn=%LDAPComputerName%, cn=Computers, cn=oraclecontext

Routing Service

Table B-7 shows the general parameters for the Routing Service.

Table B-7 General Parameters for the Routing Service

Parameter Name	Description	Valid Values/Default Value
Threads Per Process	Number of worker threads for this service within one JVM.	Valid Values: A positive value. Default Value: 4
Retrieval Application DN	Distinguished name entry for the retrieval service. When a call is made to the voicemail system to retrieve voicemail messages, the call is routed to this service.	Valid Values: A valid Oracle Internet Directory distinguished name Default Value: cn=%LDAPComputerName% : %installhome% : retrieval, cn=ovf, cn=%ct_orahome%, cn=%LDAPComputerName%, cn=Computers, cn=oraclecontext
Recording Application DN	Distinguished name entry for the recording service. This is the service to which forwarded calls are routed. Forwarded calls are calls to the voicemail system to record a voicemail or to send a fax.	Valid Values: A valid Oracle Internet Directory distinguished name Default Value: cn=%LDAPComputerName% : %installhome% : recording, cn=ovf, cn=%ct_orahome%, cn=%LDAPComputerName%, cn=Computers, cn=oraclecontext
Transfer Application DN	Distinguished name entry for the transfer service. This is the service to which calls are routed when a user chooses to transfer to an attendant.	Valid Values: A valid Oracle Internet Directory distinguished name Default Value: cn=%LDAPComputerName% : %installhome% : transfer, cn=ovf, cn=%ct_orahome%, cn=%LDAPComputerName%, cn=Computers, cn=oraclecontext
Telephony Port Map	Mapping of the Telephony Server's card port and device numbers to agent line numbers.	Valid Values: Space delimited pairs of device name and agent line number values Default Values: blt1LSI1 507654321 blt1LSI2 501234567

Internet Directory Parameters

The Internet Directory parameters in Table B-8 specifies parameters for the Oracle Internet Directory (OID) from which the Recording Service retrieves recipient information and connection pool characteristics.

Note: Some parameters apply to some components and not to others. Therefore, you may not see every parameter shown here on your page.

Table B-8 Internet Directory Parameters

Parameter Name	Description	Valid Values/Default Value
Process Refresh Interval	Length of time, in seconds, between attempts by the service to refresh itself.	Valid Values: Positive integer Default Value: 3600
Query Timeout	Length of time, in milliseconds, that an Oracle Internet Directory query may run before the system abandons the query.	Valid Values: Positive integer Default Value: 4000
Initial Connection Pool Size	Number of Oracle Internet Directory connections that are created at application startup.	Valid Values: Positive integer Default Value: 1
Minimum Connection Pool Size	Minimum number of simultaneous Oracle Internet Directory connections that an application may use.	Valid Values: Positive integer Default Value: 1
Maximum Connection Pool Size	Maximum number of simultaneous Oracle Internet Directory connections that an application may use.	Valid Values: Positive integer Default Value: 1, plus the number of worker threads that the application uses
Connection Pool Increment Size	Number of new Oracle Internet Directory connections to create when all OID connections are in use.	Valid Values: Positive integer Default Value: 1
Connection Timeout	Length of time, in seconds, that an Oracle Internet Directory connection may be idle before it is released from the connection pool.	Valid Values: Positive integer Default Value: 3600
Search Base for E-mail Users	Distinguished name of the Oracle Internet Directory subtree that will be searched for e-mail users. Oracle Voicemail & Fax services will be able to find only e-mail users in this subtree.	Valid Values: A valid Oracle Internet Directory distinguished name. Default Value: cn=EmailServerContainer,cn=products,cn=oraclecontext
Search Base for Voicemail Users	Distinguished name of the Oracle Internet Directory subtree that will be searched for voicemail users. Oracle Voicemail & Fax services will only be able to find voicemail users in this subtree.	Valid Values: A valid Oracle Internet Directory distinguished name. Default Value: cn=UMContainer,cn=products,cn=oraclecontext
Search Base for Voicemail Processes	A container in Oracle Internet Directory that holds all the Oracle home and process-level configuration for all Oracle Voicemail & Fax Applications.	Valid Values: An Oracle Internet Directory distinguished name Default Value: cn=Computers,cn=OracleContext

Log Parameters

The log parameters in Table B-9 configure logging for the service.

Note: Some parameters apply to some components and not to others. Therefore, you may not see every parameter shown here on your page.

Table B-9 Log Parameters

Parameter Name	Description	Valid Values/Default Value
Full Path for Log Directory	Directory where log files are written.	Valid Values: Path name of a file system directory Default Values: On Windows: %ORACLE_HOME%\um\log
Log Level	Specifies the type of logging performed by the UM process	Valid Values: INTERNALERROR. Reports only critical errors. ERROR. Reports all errors. WARNING. Reports all errors and warnings. NOTIFICATION. Reports high-level flow of operations within the process. TRACE. Reports all debugging information. Default Value: WARNING
Maximum Log File Size	Maximum size of each log file, in bytes. Once this size is exceeded, another log file is created.	Valid Values: A positive integer Default Value: 500000
Maximum Number of Log Files	Maximum number of log files to write for a process. Once the maximum number of log files has been written and all log files are full, the oldest log file is overwritten.	Valid Values: A positive integer Default Value: 10

Note: The TRACE option should never be used during standard business operations because it can have a detrimental impact on process performance.

PBX-Application Cluster Parameters

The PBX-Application Cluster parameter in Table B-10 specifies the name of the PBX-Application Cluster associated with this Voicemail & Fax Application.

Table B-10 PBX-Application Cluster Parameter

Parameter Name	Description	Valid Values/Default Value
PBX-Application Cluster Name	Name of the PBX-Application Cluster with which this Voicemail & Fax Application is associated.	Valid Values: Valid characters include alphanumeric characters, spaces, dashes, underscores, and colons. Must not exceed 256 characters. Default Value: None

Process Management Parameters

Note: Some parameters apply to some components and not to others. Therefore, you may not see every parameter shown here on your page.

Table B-11 Process Management Parameters

Parameter Name	Description	Valid Values/Default Value
Frequency of Process Alive Notifications	Frequency with which the Oracle Voicemail & Fax Services return a notification to OPMN that the process is alive.	Valid Values: Numeric String Default Value: 60 seconds
Maximum Queued Process Administration Requests	Maximum number of requests that may be queued at the process administration port.	Valid Values: Positive integer Default Value: 25
Secure Process Administration Communication	Specifies whether process administration requests made to the Voicemail & Fax Services need to be secured.	Valid Values: Boolean Default Value: True
Process Administration Request Timeout	Time out (in milliseconds) for a request made to the process administration port.	Valid Values: Positive integer Default Value: 3600000 msec

Recording Process Parameters

Table B-12 Recording Process Parameters

Parameter Name	Description	Valid Values/Default Value
Maximum Greeting Play Time	The maximum length of silence, in milliseconds, permitted before the system plays a user's greeting. If the system is unable to obtain the user's greeting from Oracle Internet Directory in the specified time, the system uses a more generic greeting based on the user's phone number or recorded name, depending on what information was obtained. If this parameter is not set, there is no time limit besides that which is imposed by Oracle Internet Directory on each query.	Valid Values: A positive integer to indicate that a time out is in use or Not Set to indicate that a time out is not in use. Default Value: Not Set

Recovery Process Parameters

Note: Some parameters apply to some components and not to others. Therefore, you may not see every parameter shown here on your page.

Table B-13 Recovery Process Parameters

Parameter Name	Description	Valid Values/Default Value
Process Sleep Duration	Frequency with which Message Recovery Service checks to see if there are queued messages on the file system	Valid Values: Numeric string Default Value: 900 seconds
Message Queue Location	Location where messages are queued.	Valid Values: Valid path name of a file system directory Default Value: %ORACLE_HOME%\um\queue

Telephony Server Parameters

The Telephony Server parameters in Table B-14 are used to register the application with the Telephony Server.

Note: Some parameters apply to some components and not to others. Therefore, you may not see every parameter shown here on your page.

Table B-14 Telephony Server Parameters

Parameter Name	Description	Valid Values/Default Value
Name	Host name of the Telephony Server.	Valid Values: A valid host Default Value: localhost
Number of Devices	Number of devices enabled in the installation of Oracle Voicemail & Fax. The number of devices corresponds to the number of simultaneous calls the application should allow.	Oracle recommends that the number of devices be restricted to the number of Host Media Processing (HMP) Software licenses the computer has, or the number of Routing Services being run, whichever is lower, to respect license and processing power limitations.
SIP Server IP Address	IP Address of your SIP server. This is the digital PBX or call manager which routes calls and controls MWI functionality for your architecture.	Valid Values: A valid host Default Value: localhost
SIP Server Port	Port reserved for the SIP Server for receiving SIP messages, such as MWI messages. This only needs to be changed if another application is using the port.	Valid Values: A valid (free) port Default Port: 8035
Registry Port	Port the RMI registry will run on. This only needs to be changed if another application is using the port.	Valid Values: A valid (free) port Default Port: 8035
Registry timeout	Timeout for registry startup. This value should only be changed if the server machine is particularly slow and taking a long time to start.	Valid Values: A string of digits Default Value: 500 ms
Call Answer Timeout	Specifies the time that the telephony server will wait to configure resources for this application.	Valid Values: A string of digits Default Value: 500
Configuration Timeout	Timeout for the Oracle Telephony Server to process a call. This value should only be changed if the Oracle Telephony Server does not seem to be picking up calls due to timeouts.	Valid Values: A string of digits Default Value: 500