General Information & Notes for Omnis Developers

Legacy Java runtime is requested when using Omnis Studio with Java on Mac OS X/macOS

October 2016

If Omnis is attempting to start the Java Virtual Machine this may result in a Java dialog being shown by the system which has the following text;
To open "Omnis" you need to install the legacy Java SE 6 runtime.
This dialog will be shown if attempting to start Java with a 32-bit version of Studio ( 6.1.3 and earlier ) when the legacy Apple 1.6 SDK is not installed. Clicking the More Info button on the dialog will open the legacy 1.6 SDK page from where it can be downloaded and installed.
However, this dialog can also be shown when trying to start an Oracle JVM under a 64 bit version of Studio, i.e. Studio 8.0 and later. The default instructions set within a 64-bit version of Java do not allow it to be started from a JNI bundled app (e.g. Omnis). This will cause it to fail when Omnis tries to start the JVM and this displays the fallback legacy system dialog message.
This can be remedied in one of the following ways.

1) Install the legacy 1.6 SDK which by default sets up Java to allow it to be started by JNI bundled apps. This will solve the issue when using either a 64 bit JDK or JRE version of Java. Note that when upgrading to a new major release of OS X/macOS the legacy SDK is removed and will need to be re-installed.

2) Edit the Info.plist in an Oracle JDK to allow the JVM to be started from JNI bundled apps (e.g. Omnis). The Info.plist for a JDK is located at,
/Library/Java/JavaVirtualMachines/jdkX.X.X_XXX.jdk/Contents/Info.plist ( where X.X.X_XXX is the version, e.g. 1.8.0_101 ).
This should follow the same JDK path as used in the jvm entry in the Studio config.json file.
To allow JNI bundled apps to be used change the key:
<key>JVMCapabilities</key>
<array>
   <string>CommandLine</string>
</array>

to:
<key>JVMCapabilities</key>
<array>
   <string>CommandLine</string>
   <string>JNI</string>
   <string>BundledApp</string>
</array>

The plist file can be edited in a plain text editor such as TextEdit.
Note that if no JDK is present, i.e. a JRE version of Java is being used, then use the solution in 1).

Dropdown Lists on Windows

April 2016

Following an update Microsoft issued (KB3145739 - 4/12/2016), dropdown lists were not performing correctly in some Omnis applications. The drop list was appearing behind the main window so it appeared not to be dropping down at all. We have remedied this in a patch, Omnis Studio 5.2.3.1, which you can download here: Studio5231 (Windows only)

Patches to earlier versions of Omnis Studio (4.x & 5.0.x) are not being considered at this time.

Javascript Client and Internet Explorer 8

February 2015

In order to support Internet Explorer 8.x with Studio 6.1, please download the replacement scripts below. These should be placed inside the Studio html/scripts folder, replacing the existing files.

Non-compliance with the HTML5 standard together with various performance and compatibility issues means that Studio 6.1 is the last version that will support Internet Explorer 8. Please note that the Javascript Client will not support Internet Explorer 8 in future versions. Download replacement scripts.

Omnis Studio 5.X and Mac OS 10.10 (Yosemite)

November 2014

Removal of the Open Transport network layer from Mac OSX 10.10 means that versions of Omnis Studio prior to version 6.0 will not work on this platform. Data Access Modules and networking functions are affected.

Please be advised that you should not upgrade to Mac OSX 10.10 (Yosemite) unless you are using or plan to use Omnis Studio version 6.0 or later. We apologise for any inconvenience this may cause our developers.

Mac OS X support for Omnis Studio 5.x

October 2013

Please note that the PostgreSQL DAM in Studio 5.1 has compatiblity issues with Mac OSX 10.9 and later. This is because Open Transport was removed from the Core Services Framework in the OS X 10.9 Mavericks SDK.

To use the PostgreSQL DAM with Studio 5.1 & Studio 5.1.1, a replacement DAM is required (available from the ODPP download area). If using Studio 5.1, a replacement libpq.dylib is also required. This may be obtained from the ODPP download area or copied from a later version of Studio if preferred).

This issue does not affect Omnis Studio 5.2.

Mac OS X support for Omnis Studio 4.x

October 2013

Please note that Omnis Studio 4.x is not supported with Mac OSX 10.9 and later. This is because Open Transport was removed from the Core Services Framework in the OS X 10.9 Mavericks SDK.

As a consequence of this, the Studio 4.3 WebEnabler and FileOps components no longer work. Omnis commands TCPConnect/Send/Receive/Close, HTTP..., SMTP..., POP3, MailSplit, HTTPSplitHTML and FTP... are also affected. The trace log will warn that the web enabler external fails to load and any web enabler commands will replaced by tokens (X2345678...).
Although it may be possible to rewrite some of these commands to use TCPTalk functionality, there is no automatic process in place to achieve this. In these cases, upgrading to Studio 5 may be preferable.

This issue affects Omnis Studio versions 4.3, 4.3.1 and 4.3.2.x. Studio 5.0 and later use a more recent SDK and are not affected.

Omnis Studio oOLE2 Component

December 2014

As of Omnis Studio 6.1, the OLE2 component is no longer shipped with the product. If you wish to restore support for OLE2, please download the oole2.dll and place inside the Omnis\xcomp folder.

oOLE2 (Windows 32-bit only) oole2.dll (208KB)  


Further information on the OLE2 component can be found in the Extending Omnis Manual.

Microsoft Small Business Server (SBS) 2011

May 2011

Microsoft Small Business Server (SBS) 2011 includes server class applications such as Exchange, SharePoint and SQL Server, which can contend for system resources. Based on the level of usage of the Microsoft applications, Omnis Studio may perform at a level lower than required.

If Omnis Studio running on SBS 2011 does not perform to your requirements, it is recommended that Studio be installed on a dedicated Windows server. If you have any questions regarding the use of SBS 2011, please contact Omnis Technical Support or see the following link for the differences between "Standard" & "Essential" versions of 2011: www.microsoft.com/sbs/en/us/compare-features.aspx

JPEG & PNG images on Mac OS X platforms

September 2010

With the assistance of Michael Mantkowski of Cleintrax Software, we have discovered a limitation of the drawing code on the Mac OS X platforms (Intel & PPC).

The problem is occurring because the row size of the picture data when converted to 4 bytes per pixel pixmap is larger than 0x3FFE (16382) bytes.

We will only be able to resolve this matter when Omnis Studio for the Mac OS X platform is ported to Cocoa in the future. In the meantime, the workarounds are to ensure that you use smaller JPEG & PNG images, or re-size the existing images with a suitable third party tool.

Omnis Studio and 64-bit Operating Systems

January 2011, updated December 2014

Omnis Studio has been tested and is certified for use with Windows 64-bit operating systems: Windows XP, Vista, 7, 2003 Server and 2008 Server, as well as 64-bit editions of Mac OS X (10.5 & 10.6).

Please note that the 32-bit edition of Omnis Studio is not interoperable with 64-bit software and vice-versa. For instance, the 32-bit edition requires use of 32-bit ODBC Administrator plus 32-bit clientware with any DAMs used.

Update: Please note that as of Studio 6.1, support for Linux is 64-bit only. Versions prior to 6.1 are 32-bit only.

File Locking Issues under Mac OS X

Click here for important information regarding the use of Omnis datafiles on OS X.

Windows Support for Omnis 7

Outlines Windows XP and 2000 support for Omnis 7.3.

End of Life Notification for Old-Style (V2) DAMs

This notification pertains to the DOMNIS, DODBC, DORACLE, DORACLE8, DSYBASE, DINFORMX & DDB2 DAMs which have been superceded by the multi-threaded object DAMs. Omnis Studio 4.1 will contain the final releases of these DAMs which will no longer be updated in future versions of Omnis Studio and no longer available as of Studio 5.0. We will endeavour to provide support for OS critical issues only- as deemed appropriate.