In case a Uniface application is started and the adm directory is not set to UnifaceAPSInstallDir\uniface\adm (e.g. C:\Program Files\Uniface\Uniface 10 10.4.01\uniface\adm) then using the Uniface Debugger from the application might not work. The Debugger relies on finding its configuration files (udbg.asn & usys.ini) that is located in UnifaceAPSInstallDir\uniface\adm. Without the required settings from these configuration files the Debugger will fail to start with the following error message:
0008 - Failed to activate Start-up shell screen.
One way to prevent this problem is by creating a udbg.asn file in UnifaceAPSInstallDir\common\adm (the default application configuration directory if nothing else is specified) and add the following line:
#file usysuniface:udbg.asn
With this simple change the Debugger should be able to start regardless of if the adm directory is set to UnifaceAPSInstallDir\uniface\adm.
In older versions of Uniface (<= 10.3) it is also possible that the default usys.ini in UnifaceAPSInstallDir\common\adm does not include all the settings (such as logical widget definitions) required by the Debugger. In this case the Debugger will not show all the command buttons on some of the forms correctly. This problem can be resolved by adding the following logical widget settings to the [widgets] section of the usys.ini in UnifaceAPSInstallDir\common\adm:
; Logical widgets Uniface 9:
; Note: These widgets cannot be used from the Uniface development environment.
IDFSpeedSearch=ueditbox(font=editfont;onedit=T)
IDFTextCell=ueditbox(font=editfont)
IDFButtonBottom=ucmdbutton(representation=Uniface;cursor=uhand;frametype=off;font=IDFButtonText;labelfont=IDFButtonText;backcolor=#01A7E1;backcolorselect=#97D5EC;backcolorhover=#55C1E8;backcolorfocus=#0084CC;forecolor=white;forecolorselect=black;vsize=80;autolabel=F;position=center;valign=center)
IDFButtonSide=ucmdbutton(representation=Uniface;cursor=uhand;frametype=off;font=IDFButtonText;labelfont=IDFButtonText;backcolor=#01A7E1;backcolorselect=#97D5EC;backcolorhover=#55C1E8;backcolorfocus=#0084CC;forecolor=white;forecolorselect=black;vsize=80;autolabel=F;position=top)
IDFButtonHeader=ucmdbutton(representation=Header;cursor=uhand;halign=left;valign=center;font=label)
IDFButtonImage=ucmdbutton(representation=Uniface;cursor=uhand;frametype=off;transparency=T)
IDFButtonSpecial=ucmdbutton(representation=Uniface;cursor=uhand;frametype=off;font=IDFButtonText;labelfont=IDFButtonText;backcolor=#01A7E1;backcolorselect=#97D5EC;backcolorhover=#55C1E8;backcolorfocus=#0084CC;forecolor=white;forecolorselect=black;vsize=80;POSITION=CENTER)
IDFOpenProfile=ueditbox(frame=T;font=editfont;autoselect=on;dimmedbackcolor=off;dblclk=detail;multiline=F)
Alternatively, one could also make a copy of the usys.ini in UnifaceAPSInstallDir\uniface\adm, rename it to udbg.ini, and copy the INI file to UnifaceAPSInstallDir\common\adm.
------------------------------
Daniel Iseli
Principal Technical Support Engineer
Uniface Services
Rocket Software, Switzerland
------------------------------