Eloquence A.05.00 Release Notes

cvdlg

Cvdlg is a HP-UX utility, which converts Eloquence dialog files into Dialog Manager dialog files.
Eloquence dialog files, if accessed by a driver, will be converted temporarily into Dialog Manager format each time a dialog is loaded. However this is a time consuming process and you may also wish to optimize the dialog layout using the Dialog Manager graphical editor. You may use cvdlg to convert Eloquence dialog files into Dialog Manager dialog files.

File name extensions

The following file name extensions are recommended:

.dlg: Eloquence dialog file
.idm: Dialog Manager dialog file
.idc: compiled Dialog Manager dialog file.

The default filename extensions may be re-defined using the eloq.ini file.

Compiled Dialog Manager dialog files are platform specific.

Using cvdlg

Syntax of the cvdlg command is as follows:

   /usr/eloquence/cvdlg [options] outfile infile [...]

The parameters are:

-help: show usage.
-debug[n]: set debug level. This is used to debug cvdlg itself.
-driver driver: specifies driver. The default driver is motif.
+arg 'driver args': set optional driver arguments Multiple arguments must be enclosed in single or double quotes.
outfile: This specifies destination file name. A file name extension of .idm is recommended. The target file may not already exist.
infile ...: This is a list of Eloquence dialog files. At least one must be specified.

&empty

Cvdlg uses Eloquence drivers to convert dialog files.
If using the network driver, the output files will be created on the system running DLGSRV. So the destination file name must be specified according to the remote system requirements. If you specify only a relative filename, the target file will be created relative to the directory specified in the eloq.ini file.

Example 1:

   cvdlg -driver motif +arg "-IDMtracefile trace" sample.idm sample.dlg

This example will convert a Eloquence dialog file named sample.dlg into a Dialog Manager dialog file named sample.idm using the motif driver. An additional argument has been specified for the driver (instructing driver to create a trace file named 'trace').

Example 2:

   cvdlg -driver @pc C:\\sample.idm sample1.dlg sample2.dlg

This example will convert two Eloquence dialog files named sample1.dlg and sample2.dlg into one Dialog Manager dialog file named sample.idm using the network driver running on a system named "pc".
Please note the double backslash character. This is necessary, because the shell uses a backslash character as an escape character. You may also use the regular HP-UX slash character as a directory separator. It will be mapped by the dialog driver.

Conversion process

A Eloquence dialog file is translated in a sequence of DLG NEW and DLG SET statements which are executed by the driver process.
The following example script file will show a possible usage of the cvdlg utility using the motif driver. It will convert .dlg files to .idm files renaming dialog name.
If no file names are given on command line, it will convert all .dlg files, which have no corresponding .idm files. If file names are specified on the command line, it will overwrite the corresponding .idm file.



#! /bin/sh
echo "mkidm.sh"
force=n
defaults=defaults.eq


if [ -z "$DISPLAY" ]
then
   echo "Motif display required!"
   exit 1
fi


if [ $# != 0 ]
then
   list=$*
   force=y
else
   list="*.dlg"
fi


for i in $list
do
   base=`basename $i .dlg`
   idm=$base.idm
   idc=$base.idc


   if [ ! -f $idm -o $force = y ]
   then
      echo "\n$i -> $idm"


      rm -f $idm $idc


      /usr/eloquence/cvdlg -driver motif +arg $defaults $idm $i
      if [ $? != 0 ]
      then
         echo "failed!!"
         exit
      fi


      sed -e "s/EqDialog/Dlg_$base/g" <$idm >$$
      if [ $? != 0 ]
      then
         echo "sed failed!!"
         exit
      fi
      mv $$ $idm
   fi
done

Last update: 95/11/08