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

SQL Anywhere 10.0.1 » UltraLite - Database Management and Reference » UltraLite Utilities Reference

UltraLite Engine utility (uleng10) Next Page

UltraLite Information utility (ulinfo)


This utility performs the following functions:

Syntax

ulinfo -c "connection-string" [ options ]

Option

Description

-c "connection-string"

Required. Connect to the database as identified in the DBF or file_name parameter of your connection-string. If you do not specify both a user ID and a password, the default UID of DBA and PWD of sql are assumed.

-g ID

Set the initial global database ID to the value you assign. This value is used by the database for all new rows that have global autoincrement columns. The database uses this base value to autoincrement IDs associated with each additional row and/or column.

When deploying an application, you must assign a different identification number to each database for synchronization with the MobiLink server.

-or

Open the database in read-only mode. UltraLite makes a copy of the original file, which you can then use to test your scripts without altering the database. Changes to the copied file are discarded upon completion.

If you are connecting directly from the desktop to a database already deployed to a CE device, this option is not supported.

-q

Run in quiet mode—do not print messages.

-r ID

Set the initial ml_remote_id to the value you assign. By default, new UltraLite databases set the MobiLink remote ID to NULL. You can keep this default if you choose: both UltraLite and dbmlsync automatically set the MobiLink remote ID to a unique user ID (UUID) at the start of synchronization.

-rc

Clear the existing remote database ID and set the MobiLink remote ID to NULL.

-v

Print verbose messages. Display current database properties in addition to the database internals for the named database.

Remarks

Warning messages generated when opening an UltraLite database are always displayed unless you use the -q option.

See also
Example

Show basic database internals for a file named sample.udb that has already been synchronized:

ulinfo -c DBF=sample.udb
SQL Anywhere UltraLite Database Attribute Utility Version 10.0.0.xxxx Database name: cv_dbattr Disk file 'run\script\cv_dbattr.udb'
Collation: 1252LATIN1
Number of Users: 1
  1. User: 'DBA'
Page size: 4096
Remote ID: JohnD
Global database ID: 1000
Global autoincrement usage: 0%
Number of tables: 3
Number of columns: 7
Number of publications: 3
Number of tables that will always be uploaded: 0 
Number of tables that are never synchronized: 0 
Number of primary Keys: 3 
Number of foreign Keys: 0 
Number of indexes: 0 Last synchronization completed successfully 
Download occurred: 2005-12-07 15:01:28.615000 
Upload OK 
Upload rows not ignored 
Partial download retained for subsequent sync 
Actual MobiLink Authentication value: 1000 
Authentication valid 
Synchronization by publication number:
  1. Publication cv_sync
      Mask: 0x01
      Number of rows in next upload: 0
      Last download: 1900-01-01 00:00:00.000
  2. Publication cv_syncPub2
      Mask: 0x02
      Number of rows in next upload: 0
      Last download: 1900-01-01 00:00:00.000
  3. Publication cv_syncPub3
      Mask: 0x04
      Number of rows in next upload: 0
      Last download: 1900-01-01 00:00:00.000

Show database internals for a file named CustDB.udb and display database properties by enabling verbose messaging:

ulinfo -c DBF=CustDB.udb -v
SQL Anywhere UltraLite Database Attribute Utility Version 10.0.0.xxxx
Database information
Database name: custdb
Disk file 'C:\Documents and Settings\All Users\Shared Documents\SQL Anywhere 10\Samples\UltraLite\CustDB\custdb.udb'
Collation: 1252LATIN1
Number of Users: 1
  1. User: 'DBA'
Page size: 4096
Default index maximum hash size: 8
Checksum level: 0
MobiLink Remote ID: not set
Global database ID: not set
Encryption: None
Character encoding set: 1252LATIN1
Case sensitive: OFF
Date format: YYYY-MM-DD
Date order: YMD
Nearest century: 50
Numeric precision: 30
Numeric scale: 6
Time format: HH:NN:SS.SSS
Timestamp format: YYYY-MM-DD HH:NN:SS.SSS
Timestamp increment: 1
Number of tables: 6
Number of columns: 16
Number of publications: 1
Number of tables that will always be uploaded: 0
Number of tables that are never synchronized: 1
Number of primary Keys: 6
Number of foreign Keys: 2
Number of indexes: 3
This database has not yet been synchronized.
Synchronization by publication number:
  1. Publication test
      Mask: 0x01
      Number of rows in next upload: 0
      Last download: 1900-01-01 00:00:00.000
Done.

Clear the ml_remote_id for a file called sample.udb:

ulinfo -c DBF=sample.udb -rc