Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 10.0.1 » MobiLink - Server Administration » MobiLink Utilities

MobiLink stop utility [mlstop] Next Page

MobiLink user authentication utility [mluser]


Registers MobiLink users at the consolidated database. For SQL Anywhere remotes, the users must have previously been created at the remote databases with the CREATE SYNCHRONIZATION USER statement.

Syntax

mluser [ options ] -c "connection-string"
{ -f file | -u user [ -p password ] }

Option

Description

@data

Use this option to read in options from the specified environment variable or configuration file. If both exist with the same name, the environment variable is used. See Using configuration files.

If you want to protect passwords or other information in the configuration file, you can use the File Hiding utility to obfuscate the contents of the configuration file. See File Hiding utility (dbfhide).

-c "keyword=value;..."

Supply database connection parameters. The connection string must give the utility permission to connect to the consolidated database using an ODBC data source. This parameter is required.

-d

Deletes the user name(s) specified by -f or -u.

-dl

Display messages in the window or on the command line and also in the log file, if specified.

-f filename

Read the user names and passwords from the specified file. The file should be a text file containing one user name and password pair on each line, separated by white space. You must specify either -f or -u.

-fipsWhen set, mluser will fail if FIPS support is not installed.

-o filename

Log output messages to the specified file.

-os size

Limit the size of the output file. The size is the maximum file size for logging output messages, specified in bytes. Use the suffix k or m to specify units of kilobytes or megabytes, respectively. By default, there is no size limit. The minimum size limit is 10 KB.

-ot filename

Truncate the log file and then append output messages to it. The default is to send output to the screen.

-p password

Password to associate with the user. This option can only be used with -u.

-pc collation-id

Supply a database collation ID for character set conversion of the user name and password. This should be one of the SQL Anywhere collation labels such as those listed in Supported and alternate collations. This option is required when user names and passwords are read from a file that is encoded in a different character set than the default character set determined by locale.

-u ml_username

Specify the user name to add (or delete, if used with -d). Only one user can be specified on a single command line. This option is used with -p if passwords are being used. You must specify either -f or -u.

Remarks

Given a user/password pair, the mluser utility first attempts to add the user. If the user has already been added to the consolidated database, it attempts to update the password for that user.

There are alternative ways to register user names in the consolidated database:

The MobiLink user must already exist in a remote database. To add users at the remote, you have the following options:

See also