Transmit Configuration

The decisions to make when defining a transmit configuration include:

What actions to take, if any, in the event of a communications error.
Whether or not data tables and complex tables are synchronized.
Whether or not the client remains logged in for real-time communications.
How the application behaves if using a modem, what to do if not currently connected, and when to close the connection.

Define a transmit configuration for all available communications methods on the client device. For example, if a wireless LAN connection is available to client devices in the deployment, define a transmit configuration for this connection. If a wireless WAN connection is also available, define a transmit configuration for this connection.

Transmit Configuration Attributes

Table 1: General Settings
Setting	Description
Name	The unique name of the transmit configuration. This value must be unique for all transmit configurations defined for the application.
Display Name	Each transmit configuration defined in the application is listed in the Transmit Dialog on the Agentry application, so choose an appropriate Display Name that is clear to the application end user.
Connect Type	WebSockets over HTTPS, which is the communications protocol used when synchronizing with SAP Mobile Platform Server.
Group	The group into which the transmit configuration is organized within the application. Two default options are provided, Fast and Slow, or you can create a new group by entering a name in this field. It is then available in the drop-down list for all transmit configurations within the same application project.
Failover to	If the Agentry application is unable to connect the server using the first transmit configuration, you can select a failover transmit configuration.You can set to this attribute to any other transmit configuration within the application.
Check Data Tables	Specifies whether the data tables within the application are synchronized when the transmit configuration is used. Note Consider not selecting this attribute for transmit configurations intended for slower connection types. .
Check Complex Tables	Specifies whether complex tables within the application are synchronized when the transmit configuration is used. Note Consider not selecting this attribute for transmit configurations intended for slower connection types.

Table 2: Server Address Settings
Setting	Description
Address	Disabled for WebSockets.
Port	Disabled for WebSockets.

Transmit Configuration - Session Attributes

Table 3: General Settings
Setting	Description
Stay Logged In	Select to indicate that the client user remains logged in and the application remains connected to the server to support real-time communications within the mobile application, which includes background sending and push behaviors. Set this attribute when an Agentry application requires a constant network connection to the back-end data. Note You must set this attribute before you can set the other Session attributes for the transmit configuration.
Prompt on Log In	Select to display a prompt when the connection between the application and the server is lost, and the application attempts to reconnect.
Prompt on Log Out	Select to display a prompt when the Agetnry application is logged out of the server.
Inactive Timeout	Specifies the time limit, in hours, minutes, and seconds to keep the application connected to the server when there is no data transmission activity between the client and server.
When Off-line	If the connection to the server is lost, indicates whether to stay offline or attempt to reconnect at the specified interval.
Attempts	If you select to reconnect when offline, indicate the number attempts to reconnect. If the reconnect attempts fail, how the application responds depends on the Transmit Configuration attributes you defined. For example, the application can display a prompt or switch to the failover transmit configuration.

Table 4: Background Sending
Setting	Description
Allow background sending from client	Enables background sending of pending transactions from the application to the server as soon as they are applied. Note You must set this attribute before you can set the other Background Sending attributes for the transmit configuration.
Retry Period	If background sending is enabled, specifies the amount of time in hours, minutes, and seconds to wait between failed attempts to send a transaction.
Attempts	If background sending is enabled, specifies the number of attempts at sending a transaction.

Table 5: Push
Setting	Description
Allow server to push data to client	Select to allow the server to push data to the application. A Pushes module definition must exist for the application. Users connecting to the server are logged in as Push Users. Note You must set this attribute before you can set the other Push attributes for the transmit configuration.
Retry Period	If Allow Server to Push Data to Client is selected, specifies how long the server waits before attempting to resend data for a push when a failure occurs.
Attempts	If Allow Server to Push Data to Client is selected, specifies how many attempts to push data to the application when a failure occurs.
Client Port	Disabled for WebSockets.

Transmit Configuration - Modem Connection Attributes

Table 6: Modem Settings
Setting	Description
Check for Modem Connection	Select to specify whether that the Agentry application checks for a modem connection when using the transmit configuration prior to beginning the transmit. Note You must set this attribute before you can set the other Modem Connection attributes for the transmit configuration.
Connection Name	Two options: Any Dial-up Connection requires that the user establishes the network connection manually outside the mobile application before beginning the transmit. In this case, the remaining modem connection attributes are disabled. Name of any Windows network connection configured on the client device. This option uses the settings of the specified connection to establish the modem connection to the network.
If Not Connected	Specifies that the application attempts to create a connection using the specified Windows network connection when there is no current connection. If this option is not selected, the remaining modem connection attributes are disabled.
Connect Prompt	Provides a message or instructions to the user on the client prior to attempting ot create a modem connection. Leave blank if no message is required.
Prompt User for Dial-up Username	If selected, prompts the user to enter a user name for the network connection, which is used as the login name for the network connection once the modem’s hand shaking processes are successful. If this option is not selected, the Agentry application login is used.
Prompt User for Dial-up Password	If selected, prompts the user to enter a password for the network connection. If this option is not selected, the Agentry application password is used.
Modem Init Wait	Specifies the amount of time in milliseconds to wait for the client device’s modem to initialize before beginning the dial-up process.
Post-connect Wait	Specifies the amount of time in milliseconds to wait after the network connection is made before beginning the transmit process between the client and server.
Close Connection	Specifies when to close the modem connection once no more data is being transmitted between client and server: Never If the connection is idle for the specified number of minutes and seconds.