Tuesday October 2, 2012 ub2dl4 1.4.5 Release All Rights Reserved. Copyright (c) 2002 - 2012 by: Dynamic Concepts, Inc. Aliso Viejo, CA 92656 USA Email address: techsupport@dynamic.com Information: www.dynamic.com Downloads: www.dynamic.com or ftp.dynamic.com Product Description =================== ub2dl4 is a UniBasic to dL4 conversion tool. It can convert UniBasic programs, printer scripts, terminal drivers, and UNIX profile files. It can also generate a program conversion analysis report. Pre-installation instructions ============================= o ub2dl4 should be used with dL4 version 7.1 or higher. dL4 6.x can be used but some user CALLs may not be supported. Highlights of This Release ========================== o ub2dl4 can convert UniBasic source text files to dL4 programs. o ub2dL4 can be used on Windows if the UniBasic programs are provided as source text files. o This version does not support optional UniBasic data file conversion. Release instructions ==================== o This release should be used with dL4 version 7.1 or greater. The product will not run properly without a proper dL4 version. o This release requires an SSN authorized for release 7 of dL4. Without such an SSN, dL4 can only be used in single user demo mode. o Problem reports should be emailed to techsupport@dynamic.com. All problems reports should contain a description of the problem, the operating system name/revision, and, if at all possible, a reproducible sequence. Unix/Linux installation and usage instructions ============================================== 1. Check that UniBasic and dL4 have been installed and licensed on the system. 2. Unpack the distribution file using the command "cpio -imcdu filename 7. The main menu screen is displayed by typing the following from a UNIX shell: run path_of_ub2dl4/ub2dl4.dl4 "path_of_ub2dl4" is the path of the directory where ub2dl4 was unpacked in step 2. 8. Follow the menu options sequentially, meaning run menu option 1, then menu option 2, then menu option 3, and so on. Windows installation and usage instructions ============================================== 1. Check that UniBasic is installed on the source Unix or Linux system and that dL4 is installed on the Windows system. 2. On the Unix or Linux system, unpack the distribution file using the command "cpio -imcdu filename Copy the environment variable file to the Windows system. 6. On the Windows system, create a new directory. The directory name can be anything as long as it does not contain spaces. 7. On the Windows system, start "scopew". 8 At the scopew command line, change (cd) to the directory created in step 6 and then run ub2dl4.dl4: cd directory_name path_of_ub2dl4\ub2dl4.dl4 "path_of_ub2dl4" is the path of the directory where ub2dl4 was copied to in step 3. 9. Follow the displayed menu options sequentially, meaning run menu option 1, then menu option 2, then menu option 3, and so on. File list ========= ub2dl4.dl4 Master menu program convertpgms.lib Library program convertprinters.lib Library program dumpubpgms.lib Library program misc.lib Library program mkconvprofile.lib Library program mkpgmfilelist.lib Library program ub2dl4term.lib Library program convert.prf Master conversion profile file printubenv.sh Unix shell script to print UniBasic environment variable values ubenv.txt Template file for manually defined UniBasic environment variable values readme.txt Readme file license.txt License terms and conditions New in This Release ================================================================================ Oct 2 2012 (Maintenance Release 1.4.5) o Enhancement: the standard conversion profile now includes edit commands to change variables named ERRMSG$ to ERRMSG_$ to avoid a name conflict with the ERRMSG$() intrinsic function. o Bug fixed: two "[Edit]" sections were written to the conversion profiles. Sep 10 2012 (Maintenance Release 1.4.4) o Bug fixed: ub2dl4 could not be used with version 10 or later of dL4. Jun 14 2012 (Maintenance Release 1.4.3) o Bug fixed: the LOCKRETRY environment variable was converted to an incorrect and very short timeout length. o Bug fixed: the ERM function was not converted to ErrMsg$(). o Bug fixed: CALL $CALLSTAT was not defined in convert.prf. o Bug fixed: ub2dl4 could not be used with older versions of uniBasic if port 0 was in use. Dec 6 2007 (Maintenance Release 1.4.2) o Bug fixed: if an unsupported CALL was used in a UniBasic program without an argument list, the CALL name or number was reported with the last character missing. o Bug fixed: if the ALTCALL environment variable value translated a CALL number to an unsupported CALL number, an improperly formatted line was written to the conversion profile causing errors to be reported on each program that was analyzed or converted. o Bug fixed: errors in a conversion profile were reported as format errors in each program being analyzed or converted. Errors in the conversion profile are now reported using a special error message that identifies the profile file. Oct 31 2007 (Maintenance Release 1.4.1) o An error display has been added for systems where UniBasic programs could not be converted because UniBasic wasn't installed. Sep 5 2007 (Release 1.4) o The convert.prf file has been updated to include features from dL4 7.1. o Behavior change: the final confirmation prompt in each conversion step no longer uses a default of "N" ("NO"). The user is now required to type either "Y" or "N". o The data file conversion option now refers users to the dL4 MAKEUNIV utility. Data file conversion, if desired, should be performed as a separate step after converting to dL4. o Bug fixed: when converting printer scripts, the lock file name was set incorrectly to "Scriptname$" and scripts were truncated at the first empty line. o Bug fixed: user specified directory paths are now verified when input and converted to absolute paths. Using absolute paths corrects problems with LUST when dumping program files, but may introduce problems if parent paths contain spaces. Paths containing spaces cannot be used with either UniBasic or ub2dl4. o Bug fixed: the PORT and PORTS environment variables were not cleared before running unibasic to dump programs to text files. This caused errors if the port was already in use. Jun 8 2007 (Release 1.3) o Multiple separate ub2dl4 sessions can now run on a single system by using separate copies of the ub2dl4 package and setting the TEMP environment variable to different temporary file directories. o The convert.prf file has been updated to include features from dL4 6.1. Feb 10 2004 (Release 1.2) o ub2dl4 can now convert UniBasic source text files to dL4 programs. This feature makes it possible to dump UniBasic programs to text files on a current application server and then perform the conversion to dL4 on a different system even if it uses a different platform type. When performing such a conversion, the printubenv.sh script should be run on the UniBasic application server to produce a file listing the environment variables. The script should be run with the normal UniBasic profile using the command sh ./printubenv.sh >filename If the environment variable "LUST" is not set when ub2dl4.dl4 is run, the utility will ask for the name of a file containing the environment variables. This can be the file produced by printubenv.sh or an edited copy of ubenv.txt. UniBasic programs can be easily dumped to text files using the UniBasic DIR and MAKECMND utilities. For example, the following commands typed in UniBasic in IRIS mode would dump all programs in the current directory to the subdirectory text: dir T=B /L=pgms.lst makecmnd pgms.cmd using pgms.lst Line #1: BASIC ? Line #2: DUMP text/? Line #3: EXIT Line #4: mkdir text exec pgms.cmd o ub2dL4 can now be used on Windows. This feature would typically be used to convert UniBasic source text files produced on a UniBasic application server (see the description of text conversion above). o Bug fixed: program file selection with wildcards did not work for some cases including "a*" and "ab*bd". Jul 31 2002 (Release 1.1) o First production release. Notes ===== o UniBasic programs can be dumped to text files using the UniBasic DIR and MAKECMND utilities. For example, the following commands typed in UniBasic in IRIS mode would dump all programs in the current directory to the subdirectory text: dir T=B /L=pgms.lst makecmnd pgms.cmd using pgms.lst Line #1: BASIC ? Line #2: DUMP text/? Line #3: EXIT Line #4: mkdir text exec pgms.cmd See the UniBasic manual for detailed instructions on using DIR and MAKECMND.