Object REXX for Windows NT and Windows 95

Abstract.


Figures.


Tables.


Preface.


How This Document Is Organized.


The Team That Wrote This Redbook.


Acknowledgments.


Comments Welcome.


Introducing the Hacurs Company.
I. INTRODUCING CLASSIC REXX AND OBJECT REXX.

1. Introducing Classic REXX.


A Lesson in Classic REXX. Structured Programming. The Sequence. The Loop. The Selection. Procedural Programming Using Subroutines. The Subroutine. The Procedure. The Function. Host Commands. Stems and Compound Variables. Hints and Tips.

2. Introducing Object REXX.


What's New in Object REXX? Why REXX? Why Object Orientation? The Productivity Problem. The Reuse Solution. The Waterfall Method. The Spiral Method. Prototyping. The Paradigm Shift. Better Reuse from the OO Approach. Communities of Cooperative Objects. Bloated PC Software. Standard Software Components. Liberating Objects from Applications. The CORBA Standard. So Why Object REXX?

3. How Does Object REXX Implement OO?


Objects. Classes. Inheritance. Abstract Classes. Multiple Inheritance. Object REXX Variable Pools. Object Instances. Object Creation. Object Destruction. Methods. Private and Public Methods. Class and Instance Methods. Meta Classes. Polymorphism. The Object REXX Class Library. The Object REXX Class Library Browser. Experimental Class Browser. OODialog Class Browser. Tokenizing Object REXX Programs. Automatic Tokenizing.

II. THE CAR DEALER SCENARIO.

4. The Car Dealer Application.


The Car Dealer Opportunity. The Application Model. Methods and Variables. Relationships Among Objects. The Object REXX Collection Classes. Object Creation and Destruction. Implementation of the Model in Memory. Implementation Notes. Sample Class Definition. Source Code for Base Class Implementation.

5. ASCII User Interface.


Designing the User Interface. ASCII User Interface As an Object. The AUI Class. The AUI Operations. ASCII Menus as Objects. The Menu Operations. Implementing the Menus. Appearance of ASCII User Interface. Source Code for ASCII User Interface.

6. Persistent Objects on Disk.


Storing Objects in FAT Files. Format of the Objects. Implementing the Changes in Code. The Class Structure. The Requires Directive. The Persistent Class. Source Code and Sample Data for FAT Class Implementation.

7. Graphical User Interfaces with OODialog.


The Setup. Resource Workshop. Object REXX Dialog Classes. Using the Resource Workshop. Creating a Dialog with Object REXX. The UserDialog Class. Changing the Dialog Behavior. What's Going On Inside. Implementing a Method for a Push Button. Doing Graphics with OODialog. Nesting Dialogs. Summary of User Dialog. OODialog Classes. The ResDialog Class. The CategoryDialog Class. Standard Dialog Classes. Standard Dialog FunctionS. Timed Message Box. Input Box, Integer Box, Password Box. Multiple Input Box. List Choice. Multiple List Choice. Check List. Single Selection. Tokenizing OODialog Scripts. The Car Dealer GUI. Main Dialog. Customer Dialog. Vehicle Dialog. Work Orders Dialog. Add Service Items Dialog. Bill Dialog. Parts List Dialog. Service Items Dialog. Source Code for OODialog GUI Interface. How to Structure OODialog Programs. OODialog Class Files. OODialog Sample Programs.

8. Persistent Objects in DB2.


Storing Objects in DB2. Persistent Methods for DB2 Support. Implementation of DB2 Support. Implementation of Load at Application Start. Implementation of Load-on-Demand. Implementation Notes. Setting Up DB2 on Windows NT and Windows 95. Source Code for DB2 Class Implementation.

9. Using Advanced DB2 Facilities.


Multimedia in DB2 BLOBs. Using DB2 BLOBs from Object REXX. Multiple Multimedia Files in BLOBs. Multimedia in the Car Dealer Application. Implementing the DB2 Multimedia Support. Implementation Notes. Source Code for DB2 Multimedia Implementation.

10. Data Security with Object REXX and DB2.


The Security Problem. Coding Stored Procedures with Object REXX.

11. Configuration Management with Object REXX.


Breaking an Application into Multiple Files. Using Multiple Subdirectories. Configuration Files. Overall Car Dealer File Structure. Communication Among Classes. The Local Directory. Installation Program Considerations. Implementation of Configuration Files. Using the Configuration File. Configuration File for List Routines. Implementation of the Car Dealer Class. Using the Car Dealer Class. Source Code for Configuration Management.

12. Object REXX and the World Wide Web.


Hacurs Connects to the Internet. Hacurs Makes a Plan for the Web. Hacurs Designs a Home Page. The Home Page. Web Car Dealer Application. Web Common Gateway Interface. HTML Class. Customer Search Form. Program Organization. Customizing the File Organization on the Web Server. Car Dealer Common Interface Program. Multimedia on the Web. Interacting with Web Users. Adding a Web Customer. Car Dealer Home Page. Implementation Notes. Source Code.

III. OBJECT REXX AND CONCURRENCY.

13. Object REXX and Concurrency.


Object-Based Concurrency. The Object REXX Concurrency Facilities. Early Reply. Message Objects. Unguarded Methods. The Guard Instruction. Examples of Early Reply with Unguarded and Guarded Methods. Philosophers' Forks. Philosophers' Forks in an DOS Window. Visualizing Philosophers' Forks with OODialog. GUI Design of the Philosophers' Forks with OODialog. Implementation Notes.

IV. INSTALLING OBJECT REXX, DB2, AND THE SAMPLE APPLICATIONS.

14. Installing Object REXX, DB2, and the Sample Applications.


Content of the CD. Installation and Run from the CD. Installation of Object REXX. OODialog and IBM Resource Workshop. Running the Car Dealer Application from the CD. Installation of DB2 Version 2. DB2 Installation on Windows 95. DB2 Installation on Windows NT. Installing the Car Dealer Application. Prerequisites for the Car Dealer Application. Object REXX Redbook Program Group. DB2 Setup for Car Dealer Application. Define the DB2 Database. Define the DB2 Tables. Load the DB2 Tables. DB2 Setup for Remote Database Access. Server Setup for Remote Database Access. Client Setup for Remote Database Access. Cataloging the Remote Database. Authorizing Remote Users on the Server. Testing the Remote Database. Rebinding REXX Programs to a Database. Running the Car Dealer Application. Running the Car Dealer with a Remote Database. Running the Car Dealer Application on the World Wide Web. Installed Sample Applications. Car Dealer Directory. Source Code for Running the Car Dealer Application. Removing Object REXX and the Sample Applications. OODialog Samples. Video Archive. Animals Riddle. Philosophers' Forks. Graphical Demonstration. Animation Demonstration. Jack Slot Machine. Standard Dialogs. Let's Go to the Movies.

V. REFERENCE INFORMATION.

15. OODialog Method Reference.


OODialog Samples. OODialog Classes. OODialog Standard Dialog Functions. OODialog External Functions. Registering OODialog Functions. Definition of Terms. BaseDialog Class. Instance Methods of BaseDialog. Preparing and Running the Dialog. Init. InitDialog. Run. Execute. ExecuteAsync. EndAsyncExecution. IsDialogActive. StopIt. Show. ToTheTop. StartMessageHandling. HandleMessages. ClearMessages. SendMessageToItem. Connect Methods. InitAutoDetection. NoAutoDetection. AutoDetection. ConnectButton. ConnectBitmapButton. ConnectControl. ConnectList. ConnectEntryLine. ConnectComboBox. ConnectCheckBox. ConnectRadioButton. ConnectListBox. ConnectMultiListBox. AddUserMsg. AddAttribute. Get and Set Methods. GetData. SetData. Title. SetTitle. SetWindowTitle. ItemTitle. SetStaticText. GetEntryLine. SetEntryLine. GetListLine. SetListLine. GetMultiList. SetMultiList. GetComboLine. SetComboLine. GetRadioButton. SetRadioButton. GetCheckBox. SetCheckBox. GetValue. SetValue. GetAttrib. SetAttrib. MakeArray. SetDataStem. GetDataStem. Combo Box Methods. AddComboEntry. InsertComboEntry. DeleteComboEntry. FindComboEntry. GetComboItems. GetCurrentComboIndex. SetCurrentComboIndex. ChangeComboEntry. ComboAddDirectory. ComboDrop. List Box Methods. AddListEntry. InsertListEntry. DeleteListEntry. FindListEntry. GetListItems. GetCurrentListIndex. SetCurrentListIndex. ChangeListEntry. SetListTabulators. ListAddDirectory. ListDrop. Scroll Bar Methods. GetSBRange. SetSBRange. GetSBPos. SetSBPos. ConnectScrollBar. CombineELwithSB. Methods for Window Handles, Sizes, and Positions. Get. GetItem. GetSize. GetPos. GetButtonRect. GetWindowRect. Window Draw Methods. Draw. DrawButton. RedrawRect. RedrawButton. RedrawWindowRect. ClearRect. ClearButtonRect. ClearWindowRect. Bitmap Methods. LoadBitmap. RemoveBitmap. ChangeBitmapButton. GetBitmapSizeX. GetBitmapSizeY. DrawBitmap. ScrollBitmapFromTo. TiledBackgroundBitmap. BackgroundBitmap. DisplaceBitmap. GetBmpDisplacement. Device Context Methods. GetWindowDC. GetDC. GetButtonDC. FreeWindowDC. FreeDC. FreeButtonDC. Text Methods. WriteDirect. TransparentText. OpaqueText. WriteToWindow. WriteToButton. Write. ScrollText. ScrollInButton. ScrollButton. CreateFont. FontToDC. DeleteFont. FontColor. GetTextSize. Graphics Methods. GraphicExtension. CreateBrush. CreatePen. ObjectToDC. DeleteObject. Graphic Drawing Methods. Rectangle. DrawLine. DrawPixel. GetPixel. DrawArc. GetArcDirection. SetArcDirection. DrawPie. FillDrawing. DrawAngleArc. Enable/Disable and Show/Hide Methods. EnableItem. DisableItem. HideItem. HideItemFast. ShowItem. ShowItemFast. HideWindow. HideWindowFast. ShowWindow. ShowWindowFast. ResizeItem. Resize. MoveItem. Move. Center. Update. Animated Buttons. AddAutoStartMethod. ConnectAnimatedButton. Standard Event Methods. OK. Cancel. Help. Validate. DeInstall. Public Routines. Play. UserDialog Class. Instance Methods of Class UserDialog. Init. InitAutoDetection. Create. CreateCenter. CheckFile. CheckID. ErrorFile. DefineDialog. Load. LoadFrame. LoadItems. Add... Methods. AddButton. AddBitmapButton. AddText. AddGroupBox. AddEntryLine. AddPasswordLine. AddListBox. AddComboBox. AddCheckBox. AddRadioButton. AddRadioGroup. AddCheckGroup. AddInput. AddInputGroup. AddComboInput. AddInputStem. AddCheckBoxStem. AddRadioStem. AddScrollBar. AddButtonGroup. Frames and Rectangles. AddWhiteRect. AddWhiteFrame. AddGrayRect. AddGrayFrame. AddBlackRect. AddBlackFrame. OK and Cancel Push Buttons. AddOkCancelRightBottom. AddOkCancelLeftBottom. AddOkCancelRightTop. AddOkCancelLeftTop. Dialog Control Methods. GetDefaultOpts. GetStaticID. StartIt. StopIt. ResDialog Class. Instance Methods. Init. StartIt. CategoryDialog Class. Instance Methods of Class CategoryDialog. Setting Up the Dialog. Init. InitCategories. DefineDialog. CategoryPage. CreateCategoryDialog. InitDialog. GetSelectedPage. CurrentCategory. NextPage. PreviousPage. ChangePage. PageHasChanged. StartIt. Connect... Methods. Methods for Dialog Items. Get and Set Methods. SetCategoryStaticText. GetCategoryEntryLine. SetCategoryEntryLine. GetCategoryListLine. SetCategoryListLine. GetCategoryMultiList. SetCategoryMultiList. GetCategoryComboLine. SetCategoryComboLine. GetCategoryRadioButton. SetCategoryRadioButton. GetCategoryCheckBox. SetCategoryCheckBox. GetCategoryValue. SetCategoryValue. GetCategoryAttrib. SetCategoryAttrib. Combo Box Methods. AddCategoryComboEntry. InsertCategoryComboEntry. DeleteCategoryComboEntry. FindCategoryComboEntry. GetCategoryComboItems. GetCurrentCategoryComboIndex. SetCurrentCategoryComboIndex. ChangeCategoryComboEntry. CategoryComboAddDirectory. CategoryComboDrop. List Box Methods. AddCategoryListEntry. InsertCategoryListEntry. DeleteCategoryListEntry. FindCategoryListEntry. GetCategoryListItems. GetCurrentCategoryListIndex. SetCurrentCategoryListIndex. ChangeCategoryListEntry. SetCategoryListTabulators. CategoryListAddDirectory. CategoryListDrop. Enable/Disable and Show/Hide Methods. EnableCategoryItem. DisableCategoryItem. ShowCategoryItem. HideCategoryItem. Standard Dialog Classes and Functions. TimedMessage Class. Init. DefineDialog. Execute. TimedMessage Function. InputBox Class. Init. DefineDialog. AddLine. Execute. InputBox Function. PasswordBox Class. AddLine. PasswordBox Function. IntegerBox Class. Validate. IntegerBox Function. MultiInputBox Class. Init. MultiInputBox Function. ListChoice Class. Init. ListChoice Function. MultiListChoice Class. MultiListChoice Function. CheckList Class. Init. CheckList Function. SingleSelection Class. Init. SingleSelection Function. AnimatedButton Class.

16. Windows Program Manager and Registry.


Windows Program Manager Class and Methods. Windows Registry Class and Methods.

17. Object REXX Demonstration Workbench.


Starting the Object REXX Workbench. Debugging a Program with the Workbench. Workbench Function.

VI. APPENDIXES.

Appendix A.


New Features in Object REXX and Migration. Object-Oriented Facilities. New Special Variables. Special and Built-In Objects. Directives. Class Directive. Method Directive. Routine Directive. Requires Directive. The REXXC Utility. New and Enhanced Instructions. CALL (Enhanced). DO (Enhanced). EXPOSE (New). FORWARD (New). GUARD (New). PARSE (Enhanced). RAISE (New). REPLY (New). SIGNAL (Enhanced). USE (New). New and Enhanced Built-In Functions. ARG (Enhanced). CHANGESTR (New). CONDITION (Enhanced). COUNTSTR (New). DATATYPE (Enhanced). DATE (Enhanced). STREAM (Enhanced). TIME (Enhanced). VAR (New). New Condition Traps. CALL/SIGNAL (Enhanced). New REXX Utilities. Utilities for Semaphores. Utilities for REXX Macros. Utilities for Windows Systems. Migration Considerations.

Appendix B.


Car Dealer Source Code. Directory Structure. Car Dealer Application. Philosophers' Forks and OODialog Samples. Sample Data. Sample Customer Data. Sample Vehicle Data. Sample Work Order Data. Sample Service Item Data. Sample Part Data. Multimedia Setup. Multimedia Data Definition File. Base Classes. Base Customer Class. Base Vehicle Class. Base Work Order Class. Base Service Item Class. Base Part Class. Persistent Class. Cardeal Class. Persistence in Files. Configuration for File Storage. File Customer Class. File Vehicle Class. File Work Order Class. File Service Item Class. File Part Class. Persistence in DB2. Configuration for DB2 Storage. DB2 Customer Class. DB2 Vehicle Class. DB2 Work Order Class. DB2 Service Item Class. DB2 Part Class. Running the Car Dealer Application. Program to Run the Car Dealer Application.

Appendix C.


Definition for Syntax Diagram Structure.

Appendix D.


Special Notices.

Appendix E.


Related Publications. International Technical Support Organization Publications. Other Publications. How to Get ITSO Redbooks. How IBM Employees Can Get ITSO Redbooks. How Customers Can Get ITSO Redbooks. IBM Redbook Order Form. Sample Code on the Internet.

Index.