CREATE SYNCHRONIZATION SUBSCRIPTION statement [MobiLink]

CREATE SYNCHRONIZATION SUBSCRIPTION[ subscription-name ]
TO publication-name
[ FOR ml-username, ... ]
[ TYPE network-protocol ]
[ ADDRESS protocol-options ]
[ OPTION option=value, ... ]
[ SCRIPT VERSION script-version ]

subscription-name : identifier

ml-username : identifier

network-protocol : http | https | tls | tcpip

protocol-options : string

value : string | integer

script-version : string

subscription-name A unique name that you can use to identify this subscription. It is strongly recommended that you name all your subscriptions.
TO clause This clause specifies the name of a publication.
FOR clause This clause specifies one or more MobiLink user names. If you specify more than one user name, a separate subscription is created for each user. If you specify a subscription name, only one MobiLink user name can be specified.
ml-username is a user who is authorized to synchronize with the MobiLink server.

Omit the FOR clause to set the protocol type, protocol options, and extended options for a publication. If the FOR clause is omitted, you cannot specify a subscription name or use the SCRIPT VERSION clause.
TYPE clause This clause specifies the network protocol to use for synchronization. The default protocol is tcpip.
ADDRESS clause This clause specifies network protocol options such as the location of the MobiLink server. Multiple options must be separated with semicolons.
OPTION clause This clause allows you to set extended options for the subscription. If no FOR clause is provided, the extended options act as default settings for the publication.
SCRIPT VERSION clause This clause specifies the script version to use during synchronization. Typically, you must specify a new script version for each schema change you implement.
You cannot use the SCRIPT VERSION clause if the FOR clause is omitted.

If no subscription-name is specified, a unique name is generated. The generated subscription name is the same as the publication name, provided it is unique. Otherwise, a unique name is formed by adding a number to the end of the publication name, for example, pub001, pub002, and so on.

The network-protocol, protocol-options, and option values can be set in several places.

This statement causes options and other information to be stored in the SQL Anywhere ISYSSYNC system table. Anyone with privileges to view data in the SYSSYNC system view can view the information, which could include passwords and encryption certificates. To avoid this potential security issue, you can specify the information on the dbmlsync command line.

You must have exclusive access to all tables referenced in the publication to execute the statement.

You must have the SYS_REPLICATION_ADMIN_ROLE system role.

Automatic commit.

ALTER SYNCHRONIZATION SUBSCRIPTION statement [MobiLink]
DROP SYNCHRONIZATION SUBSCRIPTION statement [MobiLink]
SQL Anywhere MobiLink clients: Synchronization subscription creation
UltraLite MobiLink clients: UltraLite client synchronization design
MobiLink users
MobiLink client network protocol options
MobiLink SQL Anywhere client extended options
CommunicationType (ctp) extended option
SYSSYNC system view
Priority order
Script versions
dbmlsync syntax

SQL/2008 Vendor extension.

The following example creates a subscription named sales between the MobiLink user SSinger and the publication called sales_publication owned by user. When the subscription is synchronized, the script version sales_v1 is used and tables are locked in exclusive mode:

CREATE SYNCHRONIZATION SUBSCRIPTION sales
TO user.sales_publication
FOR SSinger
OPTION locktables='exclusive'
SCRIPT VERSION 'sales_v1'

The following example omits the FOR clause and stores settings for the publication called sales_publication:

CREATE SYNCHRONIZATION SUBSCRIPTION
TO user.sales_publication
ADDRESS 'host=test.internal;port=2439;
OPTION locktables=exclusive';

CREATE SYNCHRONIZATION SUBSCRIPTION statement [MobiLink]

Syntax

Parameters

Remarks

Privileges

Side effects

See also

Standards and compatibility

Examples