C:\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\DEBUGGER\BASBTITL.fm March 8, 2010 10:30 am Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta UniData Using the UniBasic Debugger UDT-720-UDEB-1 C:\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\DEBUGGER\BASBTITL.fm March 8, 2010 10:30 am Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Notices Edition Publication date: July 2008 Book number: UDT-720-UDEB-1 Product version: UniData 7.2 Copyright © Rocket Software, Inc. 1988-2008. All Rights Reserved. Trademarks The following trademarks appear in this publication: Trademark Trademark Owner Rocket Software™ Rocket Software, Inc. Dynamic Connect® Rocket Software, Inc. RedBack® Rocket Software, Inc. SystemBuilder™ Rocket Software, Inc. UniData® Rocket Software, Inc. UniVerse™ Rocket Software, Inc. U2™ Rocket Software, Inc. U2.NET™ Rocket Software, Inc. U2 Web Development Environment™ Rocket Software, Inc. wIntegrate® Rocket Software, Inc. Microsoft® .NET Microsoft Corporation Microsoft® Office Excel®, Outlook®, Word Microsoft Corporation Windows® Microsoft Corporation Windows® 7 Microsoft Corporation Windows Vista® Microsoft Corporation Java™ and all Java-based trademarks and logos Sun Microsystems, Inc. UNIX® X/Open Company Limited ii Using the UniBasic Debugger The above trademarks are property of the specified companies in the United States, other countries, or both. All other products or services mentioned in this document may be covered by the trademarks, service marks, or product names as designated by the companies who own or market them. License agreement This software and the associated documentation are proprietary and confidential to Rocket Software, Inc., are furnished under license, and may be used and copied only in accordance with the terms of such license and with the inclusion of the copyright notice. This software and any copies thereof may not be provided or otherwise made available to any other person. No title to or ownership of the software and associated documentation is hereby transferred. Any unauthorized use or reproduction of this software or documentation may be subject to civil or criminal liability. The information in the software and documentation is subject to change and should not be construed as a commitment by Rocket Software, Inc. Restricted rights notice for license to the U.S. Government: Use, reproduction, or disclosure is subject to restrictions as stated in the “Rights in Technical Data- General” clause (alternate III), in FAR section 52.222-14. All title and ownership in this computer software remain with Rocket Software, Inc. Note This product may contain encryption technology. Many countries prohibit or restrict the use, import, or export of encryption technologies, and current use, import, and export regulations should be followed when exporting this product. Please be aware: Any images or indications reflecting ownership or branding of the product(s) documented herein may or may not reflect the current legal ownership of the intellectual property rights associated with such product(s). All right and title to the product(s) documented herein belong solely to Rocket Software, Inc. and its subsidiaries, notwithstanding any notices (including screen captures) or any other indications to the contrary. Contact information Rocket Software 275 Grove Street Suite 3-410 Newton, MA 02466-2272 USA Tel: (617) 614-4321 Fax: (617) 630-7100 Web Site: www.rocketsoftware.com Using the UniBasic Debugger iii Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Table of Contents Table of Contents Chapter 1 Using the Debugger In This Chapter . 1-4 Getting Started . 1-5 Locating the Source Code . 1-5 Linking the Symbol Table . 1-6 BASIC Options . 1-7 Loading the Symbol Table. 1-7 Displaying the Symbol Table . 1-8 Invoking the Debugger . 1-9 Getting Debugger Help. 1-11 Exiting from the Debugger . 1-11 Displaying Program Code and Output. 1-12 Querying the Debugger . 1-13 Printing and Changing Variables . 1-14 Watching Variables Change . 1-15 Using Breakpoints and Tracepoints . 1-16 What Are Breakpoints?. 1-16 What Are Tracepoints? . 1-16 What You Can Trace and Break On . 1-16 Breakpoint and Tracepoint Commands . 1-17 Examples . 1-17 Saving and Loading the Debug Environment . 1-20 Accessing Data in Files . 1-21 Debugger Open File Commands . 1-21 Accessing a UniData File . 1-21 Executing Programs from the Debugger . 1-23 Accessing ECL and the Operating System . 1-24 Colon . 1-24 EXEC Command . 1-24 ! (Bang) Command . 1-25 :\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\DEBUGGER\BASBTOC.fm (bookTOC.template) March 8 2010 10:26 am C:\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\DEBUGGER\BASBTOC.fm (bookTOC.template) Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Using Dual-Terminal Debugging . 1-26 Initiating Dual-Terminal Debugging (UNIX) . 1-26 Initiating Dual-Terminal Debugging (Windows Platforms) . 1-29 Ending Dual-Terminal Debugging . 1-32 Chapter 2 Debugger Commands Reference Elements of Syntax Statements . 2-5 Summary of Debugger Commands . 2-6 Display Variables and Break to Debugger . 2-6 Display and Change . 2-7 Execute . 2-7 End . 2-8 External Execute . 2-8 Open File. 2-9 Dual-Terminal Debugging . 2-9 Utilities . 2-10 !. 2-11 $. 2-12 :. 2-13 ?. 2-14 \* . 2-15 \array . 2-16 \variable . 2-18 ABORT . 2-20 B. 2-21 BASIC . 2-24 BC . 2-27 BD . 2-28 BE . 2-29 BG . 2-31 BL . 2-33 BP . 2-35 BU . 2-36 D. 2-37 DEBUG. 2-39 DI. 2-40 DL . 2-41 E. 2-42 EL . 2-44 END . 2-45 ES . 2-46 v Using the UniBasic Debugger C:\Program Files\Adobe\FrameMaker8\UniData 7.2\7.2rebranded\DEBUGGER\BASBTOC.fm (bookTOC.template) Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta EXEC . 2-47 FI . 2-48 G. 2-49 H. 2-50 L. 2-51 LA . 2-53 LD . 2-54 LI. 2-55 LS . 2-56 LU . 2-57 N. 2-58 OUT . 2-60 P. 2-62 PG . 2-63 PL . 2-64 PP . 2-65 SF . 2-67 SL . 2-69 SO . 2-71 SS . 2-72 SZ . 2-74 T. 2-75 TC . 2-77 TD . 2-79 TE . 2-81 TG . 2-83 TL . 2-86 TP . 2-89 TU . 2-91 V. 2-92 W. 2-93 WC . 2-95 WD . 2-96 Z. 2-97 vi Using the UniBasic Debugger Chapter Using the Debugger 1 In This Chapter . 1-4 Getting Started . 1-6 Locating the Source Code . 1-6 Linking the Symbol Table . 1-7 BASIC Options . 1-8 Loading the Symbol Table . 1-8 Displaying the Symbol Table . 1-9 Invoking the Debugger . 1-10 Getting Debugger Help . 1-12 Exiting from the Debugger . 1-13 Displaying Program Code and Output . 1-14 Querying the Debugger. 1-15 Printing and Changing Variables . 1-16 Watching Variables Change . 1-17 Using Breakpoints and Tracepoints . 1-18 What Are Breakpoints? . 1-18 What Are Tracepoints? . 1-18 What You Can Trace and Break On . 1-18 Breakpoint and Tracepoint Commands . 1-19 Examples. 1-20 Saving and Loading the Debug Environment . 1-22 Accessing Data in Files. 1-23 Debugger Open File Commands . 1-23 Accessing a UniData File. 1-23 Executing Programs from the Debugger . 1-25 Accessing ECL and the Operating System . 1-26 Colon . 1-26 EXEC Command . 1-26 ! (Bang) Command . 1-27 Using Dual-Terminal Debugging . 1-28 Initiating Dual-Terminal Debugging (UNIX). 1-28 Initiating Dual-Terminal Debugging (Windows Platforms) . 1-31 Ending Dual-Terminal Debugging . 1-34 1-2 Using the UniBasic Debugger You can use the UniBasic debugger to interactively examine the source code and the value of variables. This chapter introduces the terms and concepts you need to begin using the debugger. For the syntax of debugger commands, including descriptions and examples, see Chapter 2, “Debugger Commands Reference.” 1-3 In This Chapter This chapter includes the following sections: “Getting Started” – Prepare your program for a debugging session and learn how to get in and out of the debugger. “Displaying Program.