Secondary Config.ini [SYSTEM] Section Variables for the Modem Manager

The Config.ini variables listed below are the secondary configuration parameters required for more advanced configurations and special tuning. Because of the specialist nature of some of these, not all appear in Config.ini, but they may be added to override internal defaults.

<ModemName>Device

Normally, local modem(s) are allocated to any modem devices on the local machine on a first-available basis. This parameter may be set to force a particular relationship by associating a modem tag name with an explicit modem device name. Since modem device names are not always predictable, this parameter may be set in a workstation.ini file (see Introduction to Workstation.ini).

Default: <ModemName>Device =

<ModemName>Disabled

If this is defined and has a true value (i.e. a non-zero numeric value) then the modem identified by ModemName is started in Disabled mode.

Default: <ModemName>Device =

DialerSpeechInit 

This is the string to be used to initialize the text-to-speech device for audio calls.

Default: DialerSpeechInit = \xPfl=60\

DialResetTime 

A configurable time delay (in seconds or fractions of a second) between the hanging-up of a modem, and its selection for use in a new call. This delay allows the system driver to reset the modem to a known state. At low baud rates it may be necessary to extend this time.

Default: DialResetTime = 10

DialWaitTime

Indicates the delay (in seconds) to wait before retrying a failed modem operation after no dial tone, no response is received from the modem. When the dial attempt is started, the system modem driver initializes the modem. At low baud rates, it may be necessary to increase this parameter to allow sufficient time for this initialization.

Related Variables: The HangUpDelay variable indicates the number of seconds to wait before hanging up the modem when there are not active attempts to read or write (see H Config.ini [SYSTEM] Variables, or Config.ini [SYSTEM] Section Variables for the Modem Manager).

Default: DialWaitTime = 10

GuardTone 

Defines a wave file that will be played every \ModemSpeechTO seconds while an audio call is silent. If not defined, then nothing is played.

Default: GuardTone =

InitModemsDisabled 

If this is defined and has a true value (i.e. a non-zero numeric value), then all modems are started in Disabled mode. If this is defined in a workstation.ini file, then only the modems owned by that workstation are affected.

Default: InitModemsDisabled =

MMLogDateFormat

Indicates the date format to be used for the elements in the Modem Manager's event log (see Modem Manager Programming Interface). The format (as specified to a VTS Date command) applied to the current date in the Modem Manager event logs. The default is blank, indicating date recording suppression.

Note: If MMLogDateFormat is set to –1, no time is recorded in the list. (The available date format options are described in the Date function.)

Default: MMLogDateFormat =

MMLogLevel 

The Modem Manager's event log records events at four levels of detail (0..3). Setting this value to non-zero allows the additional information to be viewed.

Default: MMLogLevel = 0

MMLogTimeFormat

Indicates the time format for the elements in the Modem Manager's event log (see Modem Manager Programming Interface). The format (as specified for a VTS Time command) applied to the current time in the Modem Manager event logs. The default time format is "hh:mm:ss:dd" (4).

Note: If MMLogTimeFormat is set to –1, no time is recorded in the list. (The available time format options are described in the Time function.)

Default: MMLogTimeFormat = 4

MMRPCTimeout

Indicates the number of seconds to wait before failing an attempt to connect to another workstation. Connections that require multiple RPC hops utilize multiples of this timeout value.

Default: MMRPCTimeout = 60

ModemAlarm

If set to 0 in either the application’s Config.INI or Appmod.SRC file, this will override the ModemAlarm module, effectively disabling the recording of modem manager events in the alarm history.  This may be useful in applications that otherwise generate a large number of modem manager alarm log entries.

Default:  ModemAlarm =

ModemAutoReset

A modem which has failed is periodically reset. The ModemAutoReset variable indicates the delay (in minutes) between each such reset.

Default: ModemAutoReset = 60

ModemManagerLogSize

Indicates the number of entries to be stored in the Modem Manager’s log file.

Note: The Event Log modem library tool permits you to view these log entries.

Default: ModemManagerLogSize = 1000

ModemMmaster 

Text GUID of the application that is running the Modem Manager (e.g. ModemMmaster = {05ecfb23-7b5d-4238-b5df-8729a8094062}).

There is normally no need to set this. However, it is necessary when implementing Cross-Application working. A typical scenario would be where more than on VTS application is run on the same machine and each requires access to the common pool of modem(s). In this case, one application would be designated the Master and would control the pool for all applications.

Default: ModemMmaster =

ModemSpeechTO 

Defines the interval (in seconds) between playing the wave file identified by \GuardTone (if any).

Default: ModemSpeechTO = 3.5

ModemTCPIPPort 

The Modem Manager needs to be able to setup socket-based communications between different PCs in order to stream the modem data. This parameter sets the base port number. The Modem Manager will start with this base and will try to open a socket, incrementing the port number until successful.

Default: ModemTCPIPPort = 50000

UseUnimodem

Indicates whether or not you want the UniModem V driver to appear in the list of available modem drivers

Trihedral supplies its own modem driver / TAPI Service Provider (TSP). By default, only Trihedral's driver will appear in the available list. If UseUnimodem is set to "1", the older UniModem V driver will also be available for you to select.

Default: UseUnimodem = 0