Configuring clients with a configuration file

The artour.ini file contains configuration information about your client and each connection you define. This file is modified when you create connections or modify their properties. It controls which fields and buttons are presented on the Connect window for each connection.

Methods of configuration

One way to propagate a common client configuration for many users is to create an artour.ini file that contains the wanted configuration. Then distribute the file to your users. Each user has the same global settings and connections defined.

The artour.ini file is a readable text file, that contains many fields and their values. The file is divided into sections. Each section is preceded by a section heading enclosed in brackets. The first section, which is preceded by the heading [SAFELINX], contains global information about the configuration of this SafeLinx Client. Subsequent sections contain information about connections and their interfaces, and are preceded by headers that contain the name of the connection or interface.

Some entries can exist for a connection or for an interface. The interface section is checked first, and if no entry is found, then the connection section is used.

For a description of these parameters, see:
  • Table 1 for global parameters that affect all connections
  • Table 2 for each connection
  • Table 3 for all types of interfaces
  • Table 4 for interfaces that use Mobitex modems
  • Table 5 for interfaces that use GSM, PSTN, or AMPS modems
  • Table 6 for interfaces that use Dataradio modems
  • Table 7 for interfaces that use DataTAC modems
  • Table 8 for interfaces on Private IP connections
  • Table 9 for interfaces on ASTRO connections
Table 1. Global parameters that affect all connections

Global parameters that affect all parameters.

Parameter name Description
ArtcfgPositionSize This parameter stores the display parameters for the Mobility Connections window on the Windows desktop. It stores the position, size, and View menu selection for the window in 5 comma-separated values:
  • X position
  • Y position
  • X size
  • Y size
  • View

The values for X position and Y position specify the beginning horizontal and vertical coordinates from which the window object is drawn on the screen. The value of X size sets the width of the window, and value of Y size sets its height. The value for View specifies which View menu selection to use: 1 for Tiles, 2 for Icons, or 3 for List.

AutoStartToolbar 1= the toolbar is automatically started when the SafeLinx Client is started.
BatteryDialogPos Screen X, Y coordinates for Battery dialog box.
BlackHoleDecrement The value used to decrement the padded configure requests when running black hold detection. The default value is 100 bytes.
Confirmations 1= request confirmation on user actions
ConnectionTimeout An unsuccessful SafeLinx Client login attempt will timeout after the number of seconds set in this parameter. This timeout occurs only if the SafeLinx Client is configured to use Graphical Identification and Authentication (GINA) and connect at Windows startup. The default is 60 seconds.
CurrentConnection Identifies the name of the active or most recently used connection.
DetectBlackHoles 1= an advertised speed of network connection is 10 Mbps or greater, client pads configuration requests sent to the gateway to the maximum network MTU size. This process is done in an effort to detect black holes. If the configuration request times out, then the second attempt is decremented by using BlackHoleDecrement before being retransmitted. This parameter is set to 0. The process occurs when the client is using a high speed adapter but there is a slow or intermediate link between the client and the gateway. The default value is 1.
DisableRoaming 1= prevents the automatic cross-network roaming from occurring for use of custom applications that are using the SafeLinx Client Toolkit. The default value is 0.
DisableTrayIcon Prevents the tray icon from being create. The default value is 0 (the icon is created).
EchoTimeoutThreshold Specifies the number of consecutive echo timeouts processed before the SafeLinx Client displays an error to indicate that the SafeLinx Server is not responding. The default value is 3.
EnableAccountID 1= show the User ID input field on Connect panel.
EnableChangePassword 1= show the Change password entry in the SafeLinx Client context menu in the tray area of your desktop.
EnableChangeSettings 1= show the Change button on Connect screen to change connection dial settings.
EnableDomain 1= show the Organizational unit input field on Connect panel.
EnablePassword 1= show the Password input field on Connect panel
EnableSavePassword 1= show the Save password check box on Connect panel.
EncryptionType
  • 0= data is not encrypted
  • 2= DES data encryption
  • 5= AES data encryption with a 128-bit key strength
  • 6= AES data encryption with a 192-bit key strength
  • 7= AES data encryption with a 256-bit key strength
HandleAuthenticationEvents This parameter controls how the SafeLinx Client core handles secondary authentication events:
  • 1 = The SafeLinx Client automatically processes RADIUS, LDAP-bind, Certificate, and Change Password secondary authentication events. This value is the default.
  • 0 = The SafeLinx Client ignores secondary authentication events.
GinaMessageTimeout This parameter specifies the number of seconds to display the message that indicates that the SafeLinx Client connection attempt timed out, before Windows logon continues. The default is 15 seconds.
GinaSingleConnectAttempt This parameter controls whether the SafeLinx Client waits for the client login second try attempts or continues with the Windows login. Applies only if the SafeLinx Client is configured to use Graphical Identification and Authentication (GINA) and connect at Windows startup.
  • 1 = The SafeLinx Client continues with the Windows login after the first timeout or failed login attempt. This value is the default.
  • 0 = The client GINA code waits to reattempt the SafeLinx Client logon instead of continuing with the Windows logon.
IPUpTimeout This parameter is the number of seconds a timer waits for the IP interface to initialize. After successfully logging in, if this timer expires while waiting on the IP interface to come up, a pop-up message will display. This message informs the user that the interface is loading and how to close the client. The default value is 45 seconds.
RequestTransportProfile 1= The SafeLinx Client sends the name and the speed of the adapter when it logs in and roams from one network to another. 0= The transport profile is not requested. The SafeLinx Client uses the properties set on the Link Control Protocol and Optimization tabs. The default value is 1.
Note:
  1. The Link Control Protocol and Optimization tabs are not displayed when RequestTransportProfile=1 There is no online help available for the Link Control Protocol and Optimization pages.
SaveAccountID 1= save the value entered for User ID in the connection section of the artour.ini file
SaveDomain 1= save the value entered for Organizational unit in the connection portion of artour.ini file
ServiceAllowChangePasswordDefault This parameter applies only to connections that are configured to start when Windows starts. 1= enables users to change their passwords from the SafeLinx Client taskbar icon, 0 = disables the capability to change a user's password for the connection from taskbar. The default is 1.
ServiceAllowNonAdminExit This parameter applies only to connections that are configured to start when Windows starts. 1= users can end their connection by clicking Exit from the taskbar icon, 0= the Exit option is disabled. The default is 1.
ServiceConnection Identifies the connection that is started when Windows starts.
ServiceInitialConnectDelay A delay between the time the LMC service (which drives Start When Windows Starts option) starts and the time it initiates the initial connect attempt to the SafeLinx Server. The time is measured in seconds. This value can be set to allow for other services (for example: wireless connection) to finish initializing before SafeLinx begins its connect processing. The default value is 0, which indicates no delay.
ServicePrereqTimeout This parameter applies only to connections configured to start when Windows starts (ServiceConnection). These connections also have prerequisite applications that are configured to start before allowing the connection to start. It specifies the number of seconds the SafeLinx Client waits for prerequisite applications to start before displaying an error message and exiting. The default is 20 seconds.

Prerequisite applications are configured in the Connection section of the artour.ini file.

ServiceReconnectDelay The number of seconds the SafeLinx Client waits after an unsuccessful connection attempt before trying the connection again. This parameter applies only to a connection that is configured to start when Windows starts. The default is 10 seconds. If this value is set to 0, the SafeLinx Client will not continue to reconnect the connection after the first attempt.
ServiceResonnectRetries The number of times the service (Start When Windows Starts) tries connecting after first failure. The default is 0 which indicates unlimited connection attempts. To stop any connection attempts from happening, set ServiceReconnectDelay to 0.
ShowFlyoverBytes 1= show number of bytes sent and received in flyover text of SafeLinx Client icon in the tray
ShowFlyoverPackets 1= show number of packets sent and received in flyover text of SafeLinx Client icon in the tray.
SignalDialogPos Screen X, Y coordinates for Signal dialog box.
TraceFolder This parameter allows a customized path for the SafeLinx Client trace files to be set. This parameter is not present in the configuration file by default. It must be added to the [SAFELINX] section of the file and be set equal to a valid path on the device.
TrayUpdateInterval Minimum duration, in milliseconds, between flashes of the SafeLinx Client icon in the tray. The flash indicates network activity. The greater the value, the less often it flashes. A greater value can improve performance on high-bandwidth networks. Default is 500 milliseconds. (0= do not flash).
UserAuthorityLevel 1= user can modify the connection configuration
UseDefaultAPIBehavior 1= the SafeLinx Client toolbar uses default rules to control the API. The toolbar issues a shutdown to the SafeLinx Client after the last active interface closes and after an eMsg_Logoff event is received from a network driver. 0= the SafeLinx Client core continues to run after the last active interface closes. This setting might be useful if you are developing your own API program and want the SafeLinx Client to continue running.
Version Version of the artour.ini file. For example, 11=V1R1
Table 2. Parameters that describe a connection

Parameters that describe a connection

Parameter name Description
AccountID Value entered in User ID field of Connect window
AccountIDRequired 1= a user ID must be entered on the Connect panel if one is not already stored. If not entered, you cannot start a connection to the mobile access services. 0= a user ID is not required for this connection and is not used.
Authentication 1= authentication is enabled. This setting specifies that a password is required for a connection. 0= authentication is disabled.
AutostartDisabled If AutostartDisabled is set to 1, then the applications are ignored and no checking is done.
Autostart1...AutostartN One Autostart for each application to be automatically started after a successful logon to the SafeLinx Server. The application name includes the complete path, without parameters. The order of which application is started first is determined by the numerical order in the configuration file.
AutostartOutsideCore By default, the core autostarts the applications and the dialer will not. If you want the dialer (or another third-party application) to autostart the applications, set this value to 1.
AutostartParams1...AutostartParamsN One AutostartParams for each parameter required for the corresponding AutostartN application. Must be present, but blank, if no parameters are required for a certain application. The order of which parameters are checked first is determined by the numbered order in the configuration file.
Backup Name of backup connection.
BalanceFragments Specifies whether protocol data unit (PDU) fragments are evenly sized before they are sent over the network from the SafeLinx Client to the SafeLinx Server.
BroadcastPgmName Name of the broadcast program to start at completion of logon. This program receives broadcast messages from the mobile access services. The default value is artbcast.exe.
BroadcastPort The UDP port number on which the SafeLinx Client broadcast program listens for broadcast messages from the mobile access services. The default port is 9999.
CertificateName Specifies the name of the certificate or the name of the PKCS12 file that contains the certificate. This entry is not present in the configuration file until certificate authentication is used at least one time.
CertificateIssuer Specifies the name of the issuing authority for this certificate, for example US, International Business Machines Corporation, IBM® certificate authority. This entry is not present in the configuration file until certificate authentication is used at least one time.
CertificateStorename Specifies a string value of either pkcs12_file or Microsoft_Cert_Store used to indicate whether the certificate is stored in a PKCS12 file or in the Microsoft certificate store. This entry is not present in the configuration file until certificate authentication is used at least one time.
ClearDNSServersForAdapters List of network adapter names, separated by commas, which have their DNS registry entries temporarily removed for the duration of the SafeLinx Client connection. This setting applies only to the Windows FileNet Content Engine operating system.
Compression 1= data compression is enabled, 0= data compression is disabled. When RequestTransportProfile=1, this entry is ignored.
ConnectionTimeout Specifies the amount of time in seconds from when the SafeLinx Client starts attempting to connect to the SafeLinx Server. The timer stops when a message displays indicating that the connection is still being attempted. The default value is 120. Setting this value to zero (0) disables the timer.
CreateDefaultRoute 1= create a default route for this network when connecting to the mobile access services
DefineRoutes The set of routes to be configured which were sent to the SafeLinx Client from the SafeLinx Server the last time a connection was established.
DNSCacheSize Specifies the maximum number of domains that can be cached. The default is 100. To disable DNS caching, set EnableDNSCache to 0.
DNSCacheUpdateInterval The interval, in seconds, at which the DNS cache is updated. The default is 1.
DNSDomainName Local DNS domain name.
DomainRequired 1= an organizational unit must be entered if not already stored
EnableDNSCache 1= enable DNS caching on the SafeLinx Client. This setting is disabled by default on Windows 2000 operating systems.
EnablePacketJoining 1= enabled. This setting joins several small packets to be sent in 1 transmission. Packets are then separated again at the mobile access services. 0= disabled. Small packets are sent individually. Enabling this function can increase performance. When RequestTransportProfile=1, this entry is ignored.
EncryptedPassword Value entered in Password field, encrypted.
Encryption 1= data encryption is enabled, 0= data encryption is disabled.
FilterOtherSourceAddresses Outbound packets whose source address does not match the address of the SafeLinx Client as assigned by the SafeLinx Server are discarded. This process occurs if parameter is set to 1. Default value is 0. When RequestTransportProfile=1, this entry is ignored
GatewaySuppliesDNS 1= use MNI-configured DNS and WINS servers, if available
GWAddress TCP/IP address of the mobile access services set by SAFELINX link protocol (ALP)
HasShortCut 1= a shortcut created for this connection.
HeaderReduction Specifies whether the SafeLinx Client attempts to negotiate IP header reduction with the SafeLinx Server. The SafeLinx Server analyzes IP, UDP, and the TCP, or one of the preceding headers of a data packet. Then the SafeLinx Client strips and caches static fields in the header to reduce the packet size sent to the SafeLinx Client. When the value=1, header reduction is enabled and when the value =0, header reduction is disabled. The default value is 1 for all networks except IP connections. When RequestTransportProfile=1, this entry is ignored.
LogOffWithExit 1= logoff packet is sent to the SafeLinx Server when the SafeLinx Client disconnects. The SafeLinx Client must be connected and in range for the logoff packet to be sent. If the SafeLinx Client is in short-hold mode, then it is not considered connected and no logoff packet is sent.
MaxFragmentAge Maximum time, in seconds, to keep an unassembled packet fragment before it is discarded
MobileAddress TCP/IP address of the SafeLinx Client set by wireless link protocol (WLP)
MonitorInterval The interval, in seconds, when the SafeLinx Client checks to see whether a TCP-Lite session needs to be terminated. Default value is 15.
NetworkDLL Name of the dynamic linked library to load for this network
NTServicePort Port used to communicate with the NT artdhcp service. Default is 9898.
OneButtonConnect 1= dialer bypasses the Connect panel and instead displays the connection progress indicator only if accountID (user ID), Domain (Organizational unit), and Password were previously saved in the artour.ini file
OrgUnit Value entered in Organizational unit field of Connect window.
PasswordPort TCP/IP port number on which the mobile access services listens for password changes. If this port number changes on the mobile access services, it must be changed to match on the SafeLinx Client. The default port is 8888.
PDU2Bcast If PDU2Bcast is set to 1, then the SafeLinx Client forwards inbound packets for which the protocol is unrecognized to the UDP broadcast port.
PrereqAppName1 ... PrereqApplicationName16 One PrereqAppName for each application to be automatically checked before a successful logon to the SafeLinx Server. The application name includes the complete path. The order of which application is checked first is determined by the numerical order in the configuration file.
PrereqAppProcess1 ... PrereqAppProcess16 One PrereqAppProcess for the process name of each application to check before logging on. When a process is running, these values are found in Windows Task Manager > Processes. The order of which process is checked first is determined by the numerical order in the configuration file.
PrerequisiteDisabled If PrerequisiteDisabled is set to 1, then the applications are ignored and no checking is done.
PrimaryDNS Primary DNS server address. This value is set by the MNI on the mobile access services.
PrimaryWINS Primary WINS server address. This value is set by the MNI on the mobile access services.
PromptCertSelection Specifies whether the SafeLinx Client prompts the user to select a certificate during the login procedure. When =1, the user is prompted and when =0, the SafeLinx Client checks for the stored certificate name in the certificate store. The default value is 1.
RadiusRetryAttempts This parameter indicates how many times the client will reconnect RADIUS authentication attempts after timeout failures. Default value is set to 2.
RadiusTimeout This parameter indicates the time in seconds that the client waits for a response from a radius authentication request. Default value is set to 15.
ReceivedBytes Number of bytes received during this session
ReceivedPackets Number of packets received during this session
SavePassword 1= save the password defined for the connection. When saved, users do not need to type a password to connect to the mobile access services.
SecondaryDNS Secondary DNS server address. This value is set by the MNI on the mobile access services.
SecondaryWINS Secondary WINS server address. This value is set by the MNI on the mobile access services.
SectionType For connections, this parameter must have a value of CONNECTION.
SentBytes Number of bytes sent during this session
SentPackets Number of packets sent during this session
ShowBatteryDialog 1= If your modem supports it, show the battery strength indicator for this connection in the tray area of your desktop.
ShowSignalDialog 1= If your modem supports it, show the signal strength indicator for this connection in the tray area of your desktop.
SubnetMask Subnet mask to use for SafeLinx Client IP interface. This value is set by the mobile access services every time the connection is established.
TCP-Lite 1= the SafeLinx Client allows the SafeLinx Server to configure TCP-Lite services.
WatcherDelay Number of seconds to delay the start of automatic roaming after a login completes. Default value is set to 10.

Following each connection section are sections that describe the interfaces for that connection. Each interface section is preceded by a heading with the connection name, such as [ConnInt0]. Some interface parameters apply to all interfaces; some network types have additional parameters specific to them.

Table 3. Parameters that describe an interface

Parameters that describe an interface

Parameter name Description
ALPKeepAliveInterval This entry can exist for a connection or for an interface. The interface section is checked first, and if no entry is found, then the connection section is used.

Specifies an interval, in seconds, at which an LCP Echo packet is sent to the SafeLinx Server. It is useful when connected through an ISP that incorporates network address translation (NAT).

For IP networks, the default is 10. For all other networks, the default is 0.

When RequestTransportProfile=1, this entry is ignored.

ALPMaximumRTT This entry can exist for a connection or for an interface. The interface section is checked first, and if no entry is found, then the connection section is used.

The maximum amount of time that the SafeLinx Client waits for a wireless link protocol request to be sent and an acknowledgment to be received. This request and acknowledgment must occur before reconnecting is allowed. Measured in seconds. This parameter is used for TCP optimization. On unreliable networks where packets are frequently dropped, you might want to reduce this number to ensure that the requests are received.

For all networks except non-PPP (point-to-point protocol) IP connections, the default value is 15 seconds. For non-PPP (point-to-point protocol) IP connections, the value is 1 second.

When RequestTransportProfile=1, this entry is ignored.

ALPRetries This entry can exist for a connection or for an interface. The interface section is checked first, and if no entry is found, then the connection section is used.

Number of times to attempt sending a wireless link protocol request.

When RequestTransportProfile=1, this entry is ignored.

ALPTimeout This entry can exist for a connection or for an interface. The interface section is checked first, and if no entry is found, then the connection section is used.

The amount of time, in seconds, that the SafeLinx Client waits for a response to wireless link protocol (WLP) requests before timing out. The WLP is used to start and maintain SafeLinx Client connections.

For new connections created with SafeLinx Client version 5, the default value for this setting is 30 for all networks except IP, which is 15.

When RequestTransportProfile=1, this entry is ignored.

ConnectionType Specifies the interface type. The value for this parameter can be:
0
Default local
1
A specific LAN or WiFi adapter
2
A RAS connection
3
Automatically connect (available only on Windows PocketPC devices)
EncryptedProxyPassword When a connection is established by using a proxy server the SafeLinx Client must supply credentials for the proxy server to authenticate. This field is the password.
ExcludeAdapters Enables the SafeLinx Client to be configured to exclude specific adapters. For example, a connection that is defined to use the Default Local IP Interface can be configured to ignore specific WiFi adapters. To enable this function, set ExcludeAdapters = to a list of comma-separated adapter names. These values can be either the full adapter names or the first few characters of each adapter name. Spaces are not allowed after the comma (,) separator.
For example, to exclude two adapters, one named Intel PRO/Wireless 2200BG Network Connection and one named Sprint PCS Vision - Novatel Wireless, configure:
ExcludeAdapters= 
IntelPRO/Wireless 2200BG Network Connection,
Sprint PCS Vision

Alternatively, this exclusion might also be configured as:ExcludeAdapters=Intel,Sprint

Which would exclude any adapters that start the characters Intel or Sprint.

Handshake This setting indicates the type of modem flow control that needs to be used. 1= XON/XOFF, 0= hardware flow control.
HiSpeedWLPRetryCount SafeLinx Client reconnect value for connections 10 Mbps or faster. The default value is 5.
HiSpeedWLPTimeout SafeLinx Client timeout value used for connections 10 Mbps or faster. The default value is 4.
HttpProxyAddr Specifies either the IP address or the host name of the proxy server. This parameter is used only if you enabled proxy authentication on the SafeLinx Server.
HttpProxyPort Specifies the port number used to communicate with the proxy server. This parameter is used only if you enabled proxy authentication on the SafeLinx Server.
HttpSendPort Specifies the port number used to send data to the SafeLinx Server for an HTTP connection. The default value is 80.
InterfaceDescription Specifies the interface name or, for IP connections, the adapter name, or dial-up networking interface name.
InterfaceList Lists the set of interfaces to be opened by the SafeLinx Client for a certain connection. The parameter also shows the priority of the interfaces when the connection is enabled to roam. The order of priority is from high to low.
LowSpeedWLPRetryCount SafeLinx Client reconnect value used for connections 57600 bps or slower. The default value is 3.
LowSpeedWLPTimeout SafeLinx Client timeout value used for connection 57600 bps or slower. The default value is 15.
MaxPDUAge Age at which packets queued in the network driver (for example, Mobitex) are discarded
MedSpeedWLPRetryCount SafeLinx Client reconnect value used for connections greater than 57600 and slower than 10Mbps. The default value is 4.
MedSpeedWLPTimeout SafeLinx Client timeout value used for connections greater than 57600 bps and slower than 10 Mbps. The default value is 7.
ModemCapabilities Value used to determine capabilities of modems, such as battery or signal strength capabilities.
PowerSaverMode 1= It instructs modem to use power saver mode (if supported by the modem). 0= instructs modem to use normal mode
ProxyUsername When a connection is established by using a proxy server the SafeLinx Client must supply credentials for the proxy server to authenticate. This field is the user name.
RoamFromThreshold Specifies the number of seconds that the SafeLinx Client connection to a network was in Active status. This parameter acts as a threshold value for determining which Wait interval to use when roaming from this connection to a lesser-priority network. This aspect is only applicable if the status changes to Out of range or Unavailable.

This setting helps determine whether you are moving into or out of the coverage area of a network. If you are moving into coverage area, you might want to delay roaming from the network quickly. There might be a time when the status flips back and forth between active and inactive. This delay gives the network a chance to stabilize and establish the actual status. However, if you are moving out of a coverage area, you might want to roam from that network more quickly. Moving out of a coverage area is indicated by an inactive network status.

The default value is 0.

RoamFromWaitOverThreshold Specifies the number of seconds that the SafeLinx Client waits before roaming from this connection to another Available network of a lesser priority. When the network status was Active for less than the amount of time specified in the RoamFromThreshold setting, then the connection might be in the periphery of a network coverage area. The connection might need additional time to establish its actual status. This setting determines the number of seconds the SafeLinx Client waits until it will roam from this network to another of lesser priority.

The value of this setting needs to be more than the value of the RoamFromWaitUnderThreshold setting.

The default value is 0.

RoamSuspendInactive When an interface supports suspend/resume (short-hold mode), this value determines whether to suspend the connection when it is not the active interface. A value of 0= do not suspend, and a value of 1= suspend. The default value is 1.
RoamToWait Specifies the number of seconds that the SafeLinx Client waits after the network is available before the SafeLinx Client roams to it and makes it the Active connection. This setting allows a time for the SafeLinx Client to make sure that the connection status does not go Out of Range or Unavailable before it attempts to roam. This parameter is only applicable when the connection is being established on the periphery of a network coverage area. The default value is 0.
SaveProxyPassword When a connection is established by using a proxy server the SafeLinx Client must supply credentials for the proxy server to authenticate. When this boolean option is set to 1, the SafeLinx Client stores the password.
SectionType For interfaces, this parameter must have a value of INTERFACE.
SerialPort The Windows TAPI device name for this modem
SocketConnectionTimeout Specifies the timeout used when establishing a UDP, HTTP, or HTTPS connection with the SafeLinx Server. This value is the number of seconds to wait before the SafeLinx Client attempts to connect with another protocol.
StopTimeout Number of milliseconds the SafeLinx Client waits for a normal shutdown response from a network driver before terminating the driver abnormally.
SupportedProtocols Specifies the protocols that can be supported on the SafeLinx Client. The value for this parameter can be one or more of the following, in a comma-separated list:
Connectionless
Use UDP as a protocol to connect to the SafeLinx Server.
ConnectionOriented
Use HTTP as a protocol to connect to the SafeLinx Server.
ConnectionOrientedSecure
Use HTTPS as a protocol to connect to the SafeLinx Server
TCPIP_Ports2Filter This entry can exist for a connection or for an interface. The interface section is checked first, and if no entry is found, then the connection section is used.

List of TCP ports, separated by spaces, from which to filter packets.

UDPIP_Ports2Filter This entry can exist for a connection or for an interface. The interface section is checked first, and if no entry is found, then the connection section is used.

List of UDP ports, separated by spaces, from which to filter packets.

UseHttpProxy Used to enable or disable the use of a proxy for the SafeLinx Client to connect to the SafeLinx Server for connection-oriented (HTTP or HTTPS) connections. The default value of 0 disables proxy authentication. If you enter 1 to enable proxy authentication, you must also provide the proxy server address and port number. Use the HttpProxyAddr parameter to specify the address and HttpProxyPort for the port number, as provided by the system administrator.
UseUDPEcho This boolean parameter determines whether the UDP echo function for the SafeLinx Client and SafeLinx Server is used during the logon sequence when connecting over UDP. If UseUDPEcho=1, the UDP echo function uses a test packet to check whether the SafeLinx Client can reach the gateway. The test packet also determines what the maximum transmission unit (MTU) needs to be. If UseUDPEcho=0, then the UDP echo function is not used. This parameter is updated after each logon, based on whether the SafeLinx Server to which the SafeLinx Client is connected supports the function.

For migrated connections, the default value is 0. For new connections, the default value is 0 if only the UDP protocol is enabled. The value is 1 if HTTP, HTTPS, or both are selected in addition to the UDP protocol.

Table 4. Parameters that describe an interface to Mobitex modems.

Parameters that describe an interface to Mobitex modems

Parameter name Description
GWMAN The Mobitex access number of the SafeLinx Server.
MascVersion 1= masc1, 2= masc2
MpakNetworkAckTimeout The number of seconds the client waits for the Mobitex modem to return a network acknowledgment that an MPAK was delivered to the Mobitex network. If the parameter is not present, the default value is 15. The range of values for the parameter can be 15 through 300.
MpakQueueSize Governs how many outstanding packets can be sent to the modem without acknowledgment. If the parameter is not present, the default value is 5. The range of values for the parameter can be 1 through 10.
ProtocolNumber 147 for all current modems
Table 5. Parameters that describe an interface to GSM, PSTN, or AMPS modems

Parameters that describe an interface to GSM, PSTN, or AMPS modems

Parameter name Description
addrinf_ack_interval The number of seconds between attempts of the request/acknowledgment exchange. If the SafeLinx Client does not receive the acknowledgment of the mobile access services within the specified time period, the client attempts up to 2 times. The default value is 5 seconds.
afterCarrierDelay The amount of time, in seconds, that the SafeLinx Client waits after the carrier is gained (a connection established) before it sends data. The default value is 0.
auto-reconnect 1= SafeLinx Client attempts to reconnect to the mobile access services on connection failure, even though the SafeLinx Client has no data to send. This parameter is useful if you want to maintain a continuous connection. 0= enter short-hold mode on connection failure.
BaudRate Baud rate in bits per second.
connect-retries The number of times the SafeLinx Client attempts to reconnect to the mobile access services after the initial connect attempt fails. Connection reattempts also occur when the SafeLinx Client comes out of short-hold mode and the initial dial attempt fails to connect to the mobile access services
connect-retry-interval The amount of time, in seconds, the SafeLinx Client waits after an unsuccessful attempt to connect to the mobile access services before attempting to reconnect.
connection-timeout The amount of time, in seconds, the SafeLinx Client waits after an unsuccessful attempt to connect to the mobile access services before timing out.
DialString The number that the SafeLinx Client dials, in canonical form, to establish a connection with the mobile access services. For example, +1 (919) 254-6100
enable-addrinf-acks Enables a simple request/acknowledgment exchange between the SafeLinx Client and the mobile access services immediately following establishment of a physical connection. This exchange confirms that the mobile access services is responding to the correct SafeLinx Client. It also confirms that the mobile access services can communicate with the SafeLinx Client. The default value is 1.
enable-callback 1= enable callback from the mobile access services to the SafeLinx Client when the timer for short-hold mode expires. 0= the connection enters short-hold mode on connection failure
force_local_ac 1= force the mobile access services to use the area code when dialing the SafeLinx Client. 0= mobile access services uses a set of default rules when dialing the SafeLinx Client. These rules are based on the dialing properties used for TAPI modems.
force_local_cc 1= force the mobile access services to use the country code when dialing the SafeLinx Client. 0= Mobile access services uses a set of default rules when dialing the SafeLinx Client. These rules are based on the dialing properties used for TAPI modems.
local_ac If the connection is in short-hold mode and the callback feature is enabled, this number is the area code used by the mobile access services. This area code is used to call the SafeLinx Client when it has data to send.
local_co This number is the company code used by the mobile access services to call the SafeLinx Client when it has data to send. Applicable only when the connection is in short-hold mode and the callback feature is enabled.
local_country_value This number is the country code used by the mobile access services to call the SafeLinx Client when it has data to send. Applicable only when the connection is in short-hold mode and the callback feature is enabled
local_number This number is the subscriber number or personal number of the mobile phone used by the mobile access services. The number is used to call the SafeLinx Client when it has data to send. Applicable only when the connection is in short-hold mode and the callback feature is enabled
short-hold-timeout The amount of time, in seconds, that the connection waits before entering short-hold mode. If there is no network traffic over the connection after the specified number of seconds elapses, the connection is placed in short-hold mode. A setting of 0 disables short-hold mode.
tapi_reply_timeout The amount of time, in seconds, to wait for replies from TAPI before timing out. The default is 30.
wakeup_interval The amount of time, in seconds, that the SafeLinx Client waits after the device is resumed before attempting to reestablish the connection. This parameter gives the device time to restart before SafeLinx Client activity begins.
Table 6. Parameters that describe an interface to Dataradio modems

Parameters that describe an interface to Dataradio modems

Parameter name Description
EnableRxPortTracing Specifies whether full tracing is enabled on the Comm port. If the value is not present in the file, the default value of 0 (off) is used.
InitStates The list of modem initialization states, separated by spaces, for setting up a connection
LastBDLCAddress BDLC address of most recently used base station
ModemBufferSize Maximum size of packets, in bytes, that are sent to the modem. Values are: 256 if you have a CARMA-M modem, or 1024 if you have a DBA modem.
ModemCharacterTimeout The maximum amount of time allowed, in milliseconds, between bytes of data received from the modem.
ModemConnectTimeout The amount of time, in milliseconds, the driver waits for a connection to the modem before terminating the connection attempt.
ModemQueryTimeout The amount of time, in milliseconds, to wait for a response to a modem query
ModemResponseTimeout The amount of time, in milliseconds, the driver waist for an unsolicited response from the modem before requesting a response
ModemSendRetries The number of times to attempt sending data to the modem before a packet is discarded.
OverrideNetworkMTU Overrides the maximum transmission unit (MTU) sent to the Dataradio modem buffers. If the value is not present in the file, the default value of 256 bytes is used.
Table 7. Parameters that describe an interface to DataTAC modems

Parameters that describe an interface to DataTAC modems

Parameter name Description
CongestionTimeout The SafeLinx Client halts packet transmission for the number of seconds specified on the CongestionTimeout parameter. Only applicable when the modem reports a congested state or the SafeLinx Client stops receiving responses from the modem.
DatatacMTU The maximum size of any packet the SafeLinx Client tries to send over the DataTAC network.
KickIntoRange When set to 1, the SafeLinx Client resets the radio modem receiver if the modem is out of range for the interval specified by the parameter KickIntoRangeSecs. This action enables modems to recognize that they are back in range more quickly. This entry is not in the artour.ini file by default, and the default value is 1.
KickIntoRangeSecs When KickIntoRange is set to 1, the radio modem receiver is reset when the modem is out of range for this number of seconds. This entry is not in the artour.ini file by default, and the default value is 30 seconds.
KickIntoRangeSteps When KickIntoRange is set to 1, the radio modem receiver is reset by using these steps when the modem is out of range for KickIntoRangeSecs seconds. The step numbers correspond to the available steps listed in the NCLInitSteps entry and must begin and end with step 22. This entry is not in the artour.ini file by default, and the default value is 22 42 43 44 22.
LastBaudRate Last BAUD rate at which the modem was successfully initialized
MaximumRSSI The RSSI value you want to use to map to 100% strength of the radio signal to your modem. A percentage value 0 - 100% can then be displayed in the tray area of your desktop to indicate signal strength to the modem.
MinimumRSSI The RSSI value you want to use to map to 0% strength of the radio signal to your modem. A percentage value between 0% and 100% can then be displayed in the tray area of your desktop. This value indicates signal strength to the modem.
NCLExitSteps Specifies a numbered list of shutdown commands to be sent to the modem when the client is exiting. The default is 30 31 33. Here are the available states:
30
Shut down the modem transmitter
31
Shut down the modem receiver
33
Final shutdown state, which must be the last state in the list, even if it is the only item in the list.
NCLInitSteps A string of numbers that list the NCL initialization commands and their order for this modem. Available steps include:
0
Initial state, must always be the first state in the list.
1
Testing modem baud rate
2
NCL rebooting the modem
3
Pausing after NCL reboot of the modem (necessary to avoid losing the next cmd to the modem)
4
Setting the receive mode
5
Enabling receive data event
6
Enabling range event
7
Enabling hardware event
8
Enabling control event
9
Setting flow control to RTS/CTS
10
Setting flow control to XON/XOFF
11
Enabling receiver
12
Enabling transmitter
13
Querying product ID
14
Querying Rational® Portfolio Manager ID
15
Querying vendor ID
16
Querying software version
17
Setting modem baud rate
18
Pausing after setting baud rate
19
Enabling battery power saver mode
20
querying group ID
21
Querying range status
22
Initialized - must always be the last state in NCLInitSteps
36
NCL flushing modem queues
37
Disabling batter power saver mode (entering express mode)
NetworkVersion Version of the DataTAC network protocol implementation (4000=North America, 5000=Asia, 6000=Europe)
NumNullsToPrepend Specifies the number of null characters that are added as a prefix to messages sent to the modem. The default is 0.
PMR 1= this network is a Motorola Private Mobile Radio (PMR) network. 0= this network is not a PMR network. This value is set in the modem.PRO files and is dependent on the type of modem used.
QueuedPacketTTL Specifies how long to maintain an outgoing packet which is not written to the modem, before discarding it from the queue. This situation might occur if the modem were out of range of the network and unable to send packets for a long time. This setting does not affect packets queued within the modem. The SafeLinx Client logs an error message whenever a packet is discarded from the queue due to a timeout situation.
RespectRangeStatus When set to 1, specifies that the SafeLinx Client dies not attempt to send packets while out of range. The default value is 1, and if it is not present in file, is set to 1.
SendRetries Number of times to reattempt sending a DataTAC packet before discarding it.
SwitchToNative AT command strings used to switch the DataTAC modem from its dial interface mode into native mode. Native mode supports standard DataTAC commands in Native Control Language (NCL).
Timeout1 Number of seconds for shortest timeout value, used for most Native Control Language (NCL) modem commands to modem and some queue throttling. Default is 3.
Timeout2 Number of seconds for medium timeout value, used for AT commands to modem, NCL reboot, NCL switchoffModem, and NCL eventControl commands. Default=7
Timeout3 Number of seconds in longest timeout value, used to timeout data packets. Default=1200
UserHeader Extended address or slot number of the mobile access services as defined to the DataTAC network
VRMSimulator A VRM simulator simulates a Motorola Private Mobile Radio (PMR) network, which supports standard DataTAC commands in Native Control Language (NCL). 1= modem is an NCL simulator. 0= modem is not an NCL simulator.
Table 8. Parameters that describe an interface on private IP connections

Parameters that describe an interface on private IP connections

Parameter name Description
AdapterNameOverrideString Allows for the adapter name string sent to the gateway for transport profile selection to be overridden. The default value is null, and the parameter is not used.
AdapterSpeedOverride Allows for the connection speed sent to the gateway for transport profile selection to be overridden. The default value is null, and the parameter is not used.
ConnectionTimeout The number of seconds that the SafeLinx Client attempts to establish a connection over the interfaces defined for a connection before displaying a warning message. If there are multiple interfaces defined for a connection, then the lowest ConnectionTimeout value found among the interfaces is used. This timeout does not stop the connection attempt from continuing; it displays only the warning message. The default value is 60 seconds.
GatewayAddress IP address of the SafeLinx Server
NoStaticARP For IP-based network connections, the SafeLinx Client creates a static address resolution protocol (ARP) entry. This process is done for the local router through which UDP packets are sent to the SafeLinx Server. This setting can prevent the loss of UDP packets sent to the SafeLinx Server. Set this parameter to 1 to prevent the creation of the static ARP entry. The default setting is 0.
OverrideNetworkMTU The SafeLinx Client uses this value of the network maximum transmission unit (MTU) instead of using the actual MTU size of the physical interface used. For example, an Ethernet or RAS connection. Sometimes the SafeLinx Server sends a packet encapsulated in UDP that is greater than 1472 bytes (1500 MTU - 28 byte UDP header) in length. When that happens, the IP stack breaks up the packet into individual segments of 1472 bytes or less. Make sure that the setting accounts for the UDP header. In other words, if you want the maximum size of a packet sent over the network to be 1500, then set this value to 1472.

When RequestTransportProfile=0, then this value is used. When RequestTransportProfile=1 and the transport profile on the SafeLinx Server is set to negotiate the MTU, then this value is used. If transport profile is not set to negotiate the MTU, then the SafeLinx Server overrides it.

PreferredAdapterToUse For connections configured to use the Default Local IP Interface, this interface is used when available regardless of what other interfaces are available.
ResCallbackNumber If a RAS connection is defined, this setting is the number at which the server calls the SafeLinx Client back.
RasDomairi RAS domain name
RasNumberOfRetries Number of times to attempt failed RAS connection attempts
RasPassword User's RAS password, encrypted
RasPhoneBookEntry Name of RAS phone book entry to use to connect to the mobile access services
RasPhoneNumber Phone number to dial to establish RAS connections
RasRetryReturnCodes List of RAS return codes, separated by spaces, that cause the driver to reconnect a connection. Defined in raserror.h in Microsoft Software Developer's Kit
RasSecondsBetweenRetries Number of seconds to pause before reconnecting RAS connection
RasUserid User's RAS user ID
ReceivePort Port on which to receive packets
SendPort Port to which to send packets
Short-Hold-Timeout The amount of time, in minutes, that the connection waits before entering short-hold mode. If there is no network traffic over the connection after the specified number of seconds elapses, the connection is placed in short-hold mode. The default value is 0 and the range is 0 - 999. A setting of 0 disables short-hold mode.
SierraMinimumRSSI This value is used only by Sierra modems. The RSSI value you want to use to map to 0% strength of the radio signal to your modem. A percentage value between 0% and 100% can be displayed in the tray area of your desktop. This value indicates signal strength to the modem.
StatusDLL Status DLL for the connection. To create a status DLL, see the comments in the file artapi.h in the SafeLinx Client API Toolkit.
UseLan 1= connection uses a LAN card, 0= connection uses Dial-Up Networking
Table 9. Parameters that describe an interface on an ASTRO connection

Parameters that describe an interface on an ASTRO connection

Parameter name Description
CongestionTimeout The amount of time in seconds to refrain from sending packets after receiving an ICMP packet from the radio that indicates that it is congested. Or, the amount of time to refrain from sending packets after the internal queues reach MaxOutstandingPackets. The default value is 5 seconds.
DatatacMTU The maximum transmission unit size of any packet the SafeLinx Client attempts to send over the ASTRO network.
DelayBetweenPackets Time in milliseconds between the sending of each packet. Motorola suggests a delay between packets to reduce the chances of the buffer of the ASTRO radio from overflowing. The default value is 300.
ExitSteps A string of numbers that indicates the sequence of shutdown steps. The default value is 30. which is the standard closing interface.
Handshake The type of modem flow control that is used. 1= XON/XOFF, 0= RTS/CTS hardware flow control. The default value is 1.
InitSteps A string of numbers that indicates the sequence of initialization steps. Available values include: Start state, Initialize TAPI and comm port, Send RCP command GetInfo to radio and wait for response, and Active (initialized).
MaxOutstandingPackets The maximum number of packets that the internal client queues can hold before the client enters congested state. If set to 0, there is no limit on the queue size. The default value is 5 packets.
PacketTTL The amount of time in seconds to retain a packet in queue before the packet is discarded. During this time, the client continues to try sending the packet if the first attempt does not succeed due to congestion. After the time-to-live expires, the packet is discarded. The default value is 15.
ProfileFilename Name of the modem profile used as the basis for this ASTRO interface section in the configuration. The default value is ASTRO.PRO
RcvPort Port on which to receive packets
SendPort Port to which to send packets
UseRFAcks When set to 1, the ASTRO client relies on RCP RF_ACKS to indicate that packets were successfully transmitted. When set to 0, the ASTRO client considers packets successfully transmitted when written to the COM port. The default value is 0.