Checks the integrity of EntitySet or relationship files and, optionally, repairs any damage found.
Syntax
ZIMFIX [object [dirname]] [O=filename] [-r]
Parameters
object
The name of an EntitySet, a relationship with fields, or an application directory. A role name can be used. If omitted, the software prompts for the information.
dirname
The name of the application directory in which object is located. If omitted, ZIMFIX searches for object in any application directory. If object corresponds to more than one database file, you must supply the dirname.
O=filename
An option that causes ZIMFIX to write progress and error messages into filename rather than displaying them on the terminal screen.
-r
An option (“repair mode”) that instructs ZIMFIX to attempt to repair any damage it detects. If omitted, the damage is reported, but no repairs are attempted.
Comments
ZIMFIX can check either files or directories for damage, or check for and repair damage. ZIMFIX first addresses the structural integrity of the database file, then addresses the correspondence between data and indices in the file.
If a system failure occurs, ZIMFIX should be used to determine if data has been lost or the integrity of the database corrupted. If so, ZIMFIX can repair the damage, if possible.
The messages output by ZIMFIX identifies a damaged record by its record number. You should examine the content of all records repaired by ZIMFIX, as lost data cannot always be reconstructed.
Warning: ZIMFIX with the repair option (-R) repairs a database file in place. Before running ZIMFIX, you must run ZIMDD to ensure that the list of database files is current. Furthermore, you should make a backup copy of the damaged database before proceeding.
Example
zimfix customers -r
The preceding command causes ZIMFIX to check and repair the database file that corresponds to the Customers EntitySet.
find 25 customers
bottom
list
The ZIMFIX command in the above example reports that it repaired record number 25 in the EntitySet.
Processes application directory files, listing all objects and their associated disk files.
Syntax
ZIMFILES [option]
Parameters
option
Can be No options +v [-h] +a [-h] +f [+s] +p [+s] +u [+s=delimiter] +i
Option
Description
No options
If no options are used, only the names of the disk files created by the software are displayed.
+v [-h]
+v displays all objects in the application database that have corresponding disk files. -h (used with +v) suppresses headings for the columns of information being displayed.
+a [-h]
+a displays all objects in the application database regardless of whether they have corresponding disk files. -h (used with +a) suppresses the display of headings for the columns of information being displayed.
+f [+s]
+f displays a list of all defined fields in the application database. The fields are displayed under headings that correspond to the field names in the Fields EntitySet. An additional heading, SFN, provides the index number for indexed fields (used in conjunction with the Programming Language Interface). +s displays system-defined objects as well as user-defined objects.
+p [+s]
+p displays the permissions for objects in the application database. (This option is available only to the superuser.) +s (used with +p) displays system-defined objects in addition to user-defined objects, and displays the database encryption key.
+u [+s=delimiter]
+u displays list of the users defined in the Users EntitySet in the application database. (This option is available only to the superuser.) The +s=delimiter option prints all user information separated by the indicated delimiter, where delimiter is a single character.
+i
+i displays the system numbers for all objects in the ZIM:X directory. The limit is 65 000 create functions in a ZIM:X directory. Use the +i switch to determine how close to the limit you are.
Comments
If an application program has been compiled, its name has a -c suffix in the ZIMFILES listing.
ZimPrompt is a text-based utility that enables you to run zim programs from the command line. It provides a basic language interaction with a Zim-X database.
is one of the database names provided in the zimdb.zim configuration file when Zim Server was started. This parameter is obligatory
-p password
is the password for this user as known by Zim:X. The users ZIM and super don’t have a password; just provide the parameter as -p “”. If omitted, it is assumed the null string (“”)
-u user
is a user name known by Zim:X. Usually, any Zim database contains, by default, the users ZIM and super. If omitted, this parameter is assumed “ZIM”
-c command
is the Zim:X command you want to execute when Zim starts. If omitted, it is assumed “zimprof”
-o port
is the server port number used to connect to Zim Server as specified in zimconfig.srv configuration file. It omitted, this port is “6002”
-h hostname
is the name of the machine where Zim Server is running. It can be a name or an IP address known to the network. If omitted, it is assumed “localhost”
-w work path
is an operating system absolute address where temporary files used by this Zim session will be placed. If omitted, it is assumed the null string (“”)
Comments
When Zim:X starts, it connects to ZimServer using the database name specified, takes the appropriate parameters from the database configuration file, and then either executes immediately the Zim command specified in the parameters or prompts the user.
If one or more parameters are missing, then Zim:X will prompt the user to provide the correct information.
Note: The parameter “-w” is provided to allow administrators to determine exactly which directory of the operating system should be used as the work path for the current Zim session.
ZimPrompt only processes statements like a FIND, ADD, and so on whereas Forms, Windows, and Menu operations are not allowed because the utility is only text-based.
Produces structural information about database files.
Syntax
ZIMDD
Comments
ZIMDD analyzes the application directory files in your database, producing information about the structure of the files. The information is written to two output files whose names are system-dependent.
ZIMDD should be used immediately before executing a ZIMFIX, because ZIMFIX needs the structural information produced by ZIMDD.
To use the graphical version, activate the Administrative Utilities icon in the Zim program group. When the window containing the utilities opens, activate the File Repair icon and complete the dialog box appropriately.
The disk directory where the new Object Dictionary is to be initialized. This directory must exist before ZIMBOOT is executed
encryption_key
A key that the software uses later to encrypt the disk files created as objects are created in the Object Dictionary. You must provide ZANTHEZIM if you DO NOT want the database to be encrypted.
encoding
Whether the database will be initialized with the ANSI or UTF-8 encoding. If not provided, the default is ANSI.
Comments
If an Object Dictionary already exists in the specified location, ZIMBOOT asks you to confirm that you want to overwrite the existing database.
The newly created ZIM:X database will only contain the basic content for a ZIM:X application to be built. Prior to any work on this database, the developer must start ZIMQTC on this database and then execute
ZOMEnable
to populate the database with the remaining objects needed for the development of the application.
ZimAdmin is a powerful graphical management console designed to simplify the configuration, monitoring, and management of all Zim databases and Zim Server machines within your network. With its intuitive interface, ZimAdmin provides a seamless experience for database administrators.
Key Features
Activate Zim Products: Easily view and activate your Zim products.
View Server Log: Access the Zim Server log file to monitor server activities.
Manage User Connections: See all users connected to Zim Server-managed databases.
Zim Server Configuration: View and edit the Zim Server configuration file.
View Zim Server Statistics: Get detailed statistics for your Zim Server.
View File Statistics: Analyze statistics for each file in your databases.
Customize Database Language: Personalize language settings for various database elements.
Database Configuration: Display and manage the Zim database configuration file.
View Database Objects: Navigate and query database objects with ease.
User Interface
The ZimAdmin interface is designed for efficiency and clarity:
Tree View: On the left, Zim Servers, databases, and objects are organized in a hierarchical tree view.
Grid Area: On the right, detailed information is displayed in a grid, depending on the selected utility.
Creating a New Database
To create a new Zim database, right click on the Database folder and select “Create Database” option and follow the prompts.
ZimAdmin is your go-to tool for managing complex database environments with ease and precision. Explore the full potential of your Zim network with ZimAdmin today!
The Zim Database Language Customizer utility displays and enables editing the contents of the zimlang.zim customization file for the selected Zim database.
Click on the cell in the Current Value column along the row corresponding to the language customization item you wish to change
Type in the new value for the language customization item. The updated value will appear in bold. Click on Save to store the new language customization file
The Zim language customization changes for the selected database have been accepted and will take effect as soon as Zim Server restarts.
The operating system for which the product was licensed
Start Date
The date on which the product license was activated
End Date
The date on which the product license will expire
Company
The name of the company for which the activation key was issued
Activating a New Product
New Zim products can be activated by clicking on Activate a New Product and providing the correct information in the dialog:
Note: You will always receive, via e-mail, the required activation information (Serial Number, Activation Key and Registration Name) for any Zim product licensed to you..
The File Statistics utility displays statistics for all open files that belong to any of the databases managed by the selected Zim Server.
Each Zim file is displayed in a single row in the File Statistics grid, whose column headers are described in the table below:
Column
Description
File
An identifying number that represents the chronological order in which files have been opened
Use
Indicates whether the file is IN USE or NOT IN USE
Reads
The number of times this file has been read since the selected Zim Server session was initiated
Writes
The number of times this file has been written to since the selected Zim Server session was initiated
Read Locks
The number of times this file has had a read lock since the selected Zim Server session was initiated. (A read lock happens when a 1kb page within the file is locked for reading)
Write Locks
The number of times this file has had a write lock since the selected Zim Server session was initiated. (A write lock happens when a 1kb page within the file is locked for writing)
File Locks
The number of times this file has been locked since the selected Zim Server session was initiated. (A file lock happens when the entire file is locked for reading)
File Path
The full path to the file
Note: You can sort the grid by clicking on its corresponding header tab. The first click sorts the table in ascending order and the second in descending order.
English 
Portuguese