|
|
UM is the core application agent for voice, fax, and e-mail messaging and single number reach when you access uOne from the telephone. It is required for all other telephone features to work.
The UM.ini file is the configuration file for the UM application agent. You set up this file during the initial configuration of your system.
The UM.ini file parsing routines are case and white space sensitive. If you make changes to that file, ensure that the correct case is used for values and that no leading or trailing spaces are used in value or parameter names.
The UM.ini file has seven sections:
This section contains the parameters that are used to locate the phrases that the UM application agent needs. Cisco provides three sets of professionally recorded prompts in US English using female voice talent. The prompt sets include a master prompt set, which has the majority of the application and all of the system prompts. And two subsets of prompts that are distinguished by the type of dialing plan. The North American Numbering Plan (NANP) subset includes 36 prompts that refer to entering a "4, 5, 7 or 10 digit number." The second customized subset of "generic" prompts includes the same 36 prompts as in the NANP subset, with all references to a dialing plan removed from the text.
The prompt sets are:
Typically, you will not need to modify the values in this section. The default values are set during uOne installation for proper operations. You would change the phrase parameters if you wanted to change the location of the phrase files. For example, if you want to change the voice, wording, or language of the phrases and still preserve the original phrases.
 |
Note Phrase names have corresponding PromptPhraseList.tab file entries that also must be changed or added when phrase names are changed or added. |
.
| Parameter | Description | Valid Values | ||
|---|---|---|---|---|
Phrase directory for the agent phrases. | Default = /home2/spmaster/r410/prompts/voice1/ | |||
Phrase directory for the system phrases. | Default = /home2/spmaster/r410/prompts/voice1/SY | |||
Phrase directory to store the temporary files created by the agent. | Default = /home2/spmaster/r410/TNT/containers | |||
PhraseLanguage | Language code. This is used for system-level language selection for both Text-to-Speech, as well as prompts. If the subscriber preference is not available, the PhraseLanguage selection will be used. |
Default = USENGLISH
|
This section contains the key names for the phrases that are spoken during various greetings of the application. The application uses the values specified in this section as key values for look up in the PromptPhraseList.tab file. If you modify entries in this section, you should make corresponding modifications in the PromptPhraseList.tab file.
.
| Parameter | Description | Valid Values |
|---|---|---|
The text name used internally for the all calls greeting. | Default = AllCalls | |
The text name used internally for the busy greeting. | Default = Busy | |
The folder name (under the subscriber number folder of the subscriber's Greeting Administrator account) where distribution lists are stored. | Default = DistList | |
The text name used internally for the extended absence greeting. | Default = Extended_Absence | |
The folder name (under the subscriber number folder of the subscriber's Greeting Administrator account) where greetings are stored. | Default = Greeting | |
A greeting always plays when a call is rolled over to leave message module because the subscriber did not answer the phone. | Valid and existing greeting name in the table (do not type the.wav extension), or it could be blank. Default = N/A | |
The text name used internally for the no answer greeting. | Default = NoAnswer | |
The text name used internally for the Out of Hours greeting. | Default = OutOfHours | |
A phrase plays after the subscriber's busy greeting when the call is rolled over to leave message module because the subscriber was busy. | Valid and existing greeting name in the table (do not type the .wav extension). Default = PGA_IS_BUSY | |
A phrase plays after the subscriber's no answer greeting when the call is rolled over to leave message module because the subscriber did not answer the phone. | Valid and existing greeting name in the table (do not type the .wav extension). Default = PGA_IS_NOT_AVAILABLE | |
A phrase plays before the subscriber's busy greeting when the call is rolled over to leave message module because the subscriber was busy. | Valid and existing greeting name in the table (do not type the .wav extension), or it could be blank. Default = N/A | |
A phrase plays before the subscriber's no answer greeting when the call is rolled over to leave message module because the subscriber did not answer the phone. | Valid and existing greeting name in the table (do not type the .wav extension), or it could be blank. Default = N/A | |
The text name used internally for the SNR greeting. | Default = SNRGreeting | |
The text name used internally for the spoken name. | Default = SpokenName | |
A greeting always plays when a subscriber dials into the application. | Valid and existing greeting name in the table (do not type the .wav extension), or it could be blank. Default = LOG_WELCOME_CISCO |
This section contains the keys specific to the UM application agent.
| Parameter | Description | Valid Values | ||
|---|---|---|---|---|
Used for External Users that are not provisioned in the uOne LDAP database. Upon determining that a phone number does not match a subscriber, the UM application agent will repeat the full number, tell the user that it is not for a subscriber on this system and ask if they want to add it anyway. If the user doesn't want to add it, the UM application agent will proceed normally. Otherwise, an e-mail address is added to the list in the form of PhoneNumber@<AMISADomainValue> | Valid e-mail domain name. For example, AMISADomain.com. Default = N/A | |||
Application's running mode. | Static or Dynamic Default = Dynamic | |||
Audio type. This parameter is used in the creation of VPIM messages. The only value currently supported is .wav, but when G726.1 encoding format is available on DSP cards, the applicable values may be extended. | Wav Default = wav | |||
BusyNoAnswerGrt | Whether there will be an option to record busy or no answer greetings | Yes or No Default=Yes | ||
CompanyName | In content description headers such as "<Cisco> Fax Message," the company name can be configured with this parameter. | Default=Cisco | ||
Designates the format in which dates and times in the message header will be played. | Natural or Euro Default = Natural | |||
DRSMode | Enables/disables the Deposit/Retrieve Session Mode. If this mode is enabled, the user enters fewer key strokes because the system uses the ANI to determine whether the caller is a subscriber. This mode is mainly used with cell phones. For this mode to work properly, the following parameters must have these values:
| Enabled/Disabled Default=Disabled | ||
DRSRetrievalNum | Identifies the 10-digit number that the subscribers dial to retrieve their messages. The deposit/retrieval of messages is based on the value of this parameter, not the call type. | 10-digit retrieval number Default = <DRS_Retrieval_Number> | ||
InformationalLogging | Indicates whether event logging occurs, other than billing information. Information such as IMAP, LDAP, DTMF keys, phrases played will be logged. You can use this information to recreate user problems to troubleshoot problems. | On or Off Default = Off | ||
InventoryTime | Sets the length of the time interval after which the UM application agent will play a prompt while doing message inventory. For example, if the message inventory takes 1 minute and this parameter is set to 10, the UM application agent will play a prompt informing the subscriber that the inventory is still in progress every 10 seconds until the inventory is finished. During message inventory, this parameter also controls the length of time that it takes for an interrupt by the subscriber to take effect. | Any reasonable number. Unit is seconds. Default=10 | ||
To determine whether the person leaving the message will be allowed to perform *T transfer or will be allowed to transfer to operator only. When the transfer is allowed, the security and restriction burden, as well as setting up of the transfer, will be the responsibility of the DialMap.ini Caller Access Section and gatekeeper/gateway configuration.
| TransferAllowed or NoTransferAllowed Default = TransferAllowed | |||
The file used to determine the phone numbers on which the leave message module will run. | Valid filename existing in $PARMLIB/apps/UM directory. Default = LMMFile | |||
Legacy Default | Used for USDOMESTIC systems. If this parameter is enabled and if a mailbox ID could not be resolved, the UM application agent will try to build a mailbox ID using the subscriber ID and knowledge about the form of the incoming telephone number. | Enabled/Disabled Default=Disabled | ||
This entry will be applied to subscriber login, leave a fax, or leave a message when the user is prompted for the mailbox ID. | Any section name in the DialMap.ini file that can expand a phone number or blank. Default = DialPlan | |||
IMAP APIs debug information at the protocol level. | On or Off Default = Off | |||
MailProtocolTimeout | Controls timeout for SMTP sends and IMAP calls. If MailProtocolTimeout is undefined or is set to 0, the timeout for SMTP sends and IMAP calls would be infinite. | Any reasonable number. Unit is seconds. Default=10 | ||
This parameter is used to fine tune the application based upon the backend server characteristics. Currently, only two values are allowed. | Netscape or swc_mx51 Default = Netscape | |||
Maximum number of the failed login attempts for the subscriber per session. | Default = 3 | |||
MaxMessageSize | Used to determine if a caller has enough space to leave a message. A typical 3 minute message using .wav encoding results in a 2 MB message file which results in 2000 blocks. | In blocks, the system administrator should decide this value. Default=2000 | ||
MaxNumberPrompts | The maximum number of any type of message counted when the UM application agent is announcing the number of messages. For example, if this parameter is set to 50, UM will announce the exact number of messages of a specific type as long as that number doesn't exceed 50. If that number is exceeded, the subscriber will hear a message similar to the following: "You have more than 50 voice messages." | Default=100 | ||
Volume level that phrases are adjusted to. | 1 - 10 Default = 1 | |||
Informs the application whether the CMA agent is going to provide network information, such as ANI, RDNIS, and call type. | Yes or No Default = Yes | |||
Destination e-mail address for non-deliverable messages. | E-mail address of postmaster. Default = N/A | |||
Whether messages will be scheduled during send messages. | Yes or No Default = No | |||
The number of seconds to move the message forward and backward while it is playing. | Valid value for telecom. For example, 5. Default = 5 | |||
Indicates whether or not Personal Access is enabled. | Enabled or Disabled. Default = Enabled | |||
SNPP paging server host name | Valid machine name. | |||
SNPP paging server user password | Valid passwords separated by a comma; associate with SNPP port. Default = N/A | |||
SNPP paging server port number | A valid port number on the SNPP paging server. Default = N/A | |||
SNPP paging server user name | User name for paging server. Default = spmaster | |||
Number of seconds to record the caller's spoken name. | Default = 2 | |||
Contains the name of the phrase played when an SNR phone number is answered. | Default = SNR_WELCOME | |||
The table that defines the rest of the table in the application. This parameter should not be changed without consulting the development team. | Valid and existing table name. For example, Menus_define.tab. Default = Menus_define.tab | |||
The table that defines the instances of the tables specified in the TableDefinition. This parameter should not be changed without consulting the development team. | Valid and existing table name. For example, Menus_inst.tab. Default = Menus_inst.tab | |||
TextSubType | Specifies the extension for a text file. | Default=txt | ||
Application's time out value. | 0 - 30 Default = 5 | |||
The application level version control. Only developers can modify this value. | 1 Default = 1 |
The directory server related configuration parameters are defined in this section.
| Parameter | Description | Valid Values |
|---|---|---|
To allow distribution list expansions for "Netscape" and "Other" type of messaging servers. Possible and valid combinations: ExpandLists MailServerType Netscape ATT Other | Yes or No Default = Yes | |
The DN of the authority to bind to the directory, and to have sufficient privilege to perform all the operations that UM requests. | A valid DN. Default = cn=Directory Manager, o=Organization | |
The e-mail password (in other words, the IMAP password) of the above authority. | The password of LDAPBindDn Default = N/A | |
The centralized directory server name that UM uses. | Valid machine names separated by commas. Default = N/A | |
The port on which slapd (LDAP daemon) is running for the centralized server. | Valid port number. For example, 389. Default = 389 | |
Entry DN from which UM can see all entries that will be accessed. Use this parameter to restrict and/or partition the directory server from the perspective of UM and other application agents. In a large-scale directory setting, an appropriate search base will improve performance. | Top of the directory. Default = o=Organization | |
LDAPTimeout | Controls timeout for LDAP calls. If LDAPTimeout is undefined or is set to 0, the timeout for LDAP calls would be infinite. | Any reasonable number. Unit is seconds. Default=10 |
The Automated Attendant feature is reserved for future use. However, the Dial-by-Name and Address-by-Name feature use the parameters in Table 1-5
.
| Parameter | Description | Valid Values |
|---|---|---|
Indicates how the name search is constructed. First name first last name last or last name first and first name last or both. | LastName, FirstName, or Both. For example, John Doe would be: LastName: Doejohn Default = LastName | |
The minimum number of digits that must be entered by the user both initiating a search unless the name is # terminated. | 2 - 5 Default =3 | |
Maximum number of names that may be presented to the user for selection when the user # terminates the entered name. | 2 - 5 Default = 3 | |
Maximum number of entries returned from LDAP when searching for matching names. | 10 - 20 Default = 10 |
This section contains the parameters to enable/disable broadcast notification and/or broadcast message aging in uOne.
.
| Parameter | Description | Valid Values |
|---|---|---|
The default number of days before a broadcast message expires. | A reasonable number. Default = 3 | |
The maximum number of days that a subscriber is able to set in uOne for broadcast message expiration. | A reasonable number. Default = 365 |
This section lists parameters reserved for future inbound fax use. They currently should be ignored because all inbound faxes are controlled by the on ramp gateway.
|
Note The configuration parameters for outbound FAX services are defined in the FaxPrint.ini file. |
| Parameter | Description | Valid Values |
|---|---|---|
Filename for FAXFile that contains extensions used for Group Fax numbers. | Valid filename existing in $PARMLIB/apps/UM directory. Default = FAXFile | |
InactivityTimeout value passed to CMA before receiving a fax. | 0 - 30000 Default = 0 | |
When set to 'No', there will be no option 3 to leave fax in the 1,2,3 menu. | Yes or No Default = No | |
File type for faxes written to disk. This parameter is used to create VPIM messages and should not be changed without consulting the development team. | tif Default = tif |
Posted: Mon Sep 25 20:08:23 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.