Category: ZIM Product Suite

run backup server [yes | no]

Instructs ZimServer to start saving records to be used by ZimBackup Server. It also starts a process that communicatos with ZimBackup to feed these records to a database serving as a backup.

For ZimBackup to run correctly, it requires other parameters and procedures. Visit the document Database Backup for more information.

Conditional Color Assignment Using $rgb()

Purpose

In Zim, you can use conditional logic to dynamically change the color of form objects based on runtime conditions such as user input, system status, or validation results. This is achieved using the if, elseif, else, and endif control structures in combination with the $rgb function.

Syntax

if condition
    action
elseif condition
    action
else
    action
endif

Example: Status-Based Field Coloring

if $status = "error"
    form set (fillcolor rgb $rgb(255, 0, 0)) MyForm.MyFormField
elseif $status = "warning"
    form set (fillcolor rgb $rgb(255, 165, 0)) MyForm.MyFormField
else
    form set (fillcolor rgb $rgb(0, 255, 0)) MyForm.MyFormField
endif

Explanation

• If the status is "error", the field is colored red.
• If the status is "warning", the field is colored orange.
• For all other statuses, the field is colored green.

Use Cases

• Form validation feedback (e.g., highlight invalid fields).
• User role–based UI customization (e.g., different colors for admin vs. guest).
• System alerts and notifications (e.g., color-coded warnings).
• Real-time sensor feedback (e.g., temperature thresholds triggering color changes).

Best Practices

• Keep RGB values consistent with your UI design system.
• Use descriptive variable names for conditions.
• Avoid deeply nested conditionals—break logic into reusable procedures if needed.

web port number port

This configuration option establishes the port number used by Zim applications running on a Web browser. It’s reserved for future use.

Valid Settings

A number from 1024 to 32765.

java options <options>

The options are any valid parameters that are understood by Java when a Java instance is started. This occurs when ZimServer performs a connection to the JDBC Driver or JDBC SAM. The valid options are the ones described by the Java documentation.

Example

java options "-Xmx64M"

backup server name <name or IP address>

The name or IP address is the location in the network where ZimBackup Server is responding to perform an online application of the data just updated by ZimServer. These files correspond to committed transactions from all databases being served by Zim Server and can be placed anywhere in the network so that they are saved in case of a disk crash.

It should be used in conjunction with Backup Port Number configuration option.

Valid Settings

A valid Internet address.

backup port number <port number>

The backup port number establishes the port number used by Backup Server to interact with Zim Server when applying the backup blocks to the backup databases.

Together with Backup Server Name, Zim Server establishes a connection to ZimBackup to keep sending backup blocks of data as soon as these data blocks are committed by ZimServer in its local databases.

Valid Settings

A valid number between 1024 and 65535 not conflicting with the Server Port Number configuration option.

maximum log size file-size

The number file-size, expressed in Kb, indicates the maximum size the log file ZIMSVLOG.ZIM can reach until the log rotation happens.

Valid Settings

A number from 1,000 to 10,000,000 (or, between 1 Mb and 10 Gb) for both Windows and Linux. The default is 10,000, or 10 Mb.

Log Rotation

After the file ZIMSVLOG.ZIM reaches the limit here set, the file is renamed to one with a timestamp and a new file is created.

The log file zimsvlog.zim, located in the directory pointed to by the ZIM environment variable, records all events happening with Zim Server like, its start, its end, errors, tracing, and other information.

You can browse its contents using a text editor or using ZimAdmin.

After some time using ZimServer, this file can become very large. You should check the size of it from time to time, archive it (if you wish) and erase it. It can be erased at any time, even when Zim Server is running. Next time ZimServer needs to log some information, the file will be recreated.

Where:

Valid Zim object names can be 1 to 18 characters in length. Valid characters for inclusion in an object name include the dollar sign ($), the underscore character (_), the letters a through z and A through Z, and the digits 0 through 9. The first character of an object name must be either a letter or a dollar sign.