SG24-2216-00 Creating Java Applications Using NetRexx September 1997 IBML International Technical Support Organization SG24-2216-00 Creating Java Applications Using NetRexx September 1997 Take Note! Before using this information and the product it supports, be sure to read the general information in Appendix B, “Special Notices” on page 273. First Edition (September 1997) This edition applies to Version 1.0 and Version 1.1 of NetRexx with Java Development Kit 1.1.1 for use with the OS/2 Warp, Windows 95, and Windows NT operating systems. Because NetRexx runs on any platform where Java is implemented, it applies to other platforms and operating systems as well. SAMPLE CODE ON THE INTERNET The sample code for this redbook is available as nrxredbk.zip on the ITSO home page on the Internet: ftp://www.redbooks.ibm.com/redbooks/SG242216 Download the sample code and read “Installing the Sample Programs” on page 4. Comments may be addressed to: IBM Corporation, International Technical Support Organization Dept. QXXE Building 80-E2 650 Harry Road San Jose, California 95120-6099 When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. Copyright International Business Machines Corporation 1997. All rights reserved. Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. Contents Figures . xi Tables . xv Preface . xvii How This Document is Organized ................................ xviii The Team That Wrote This Redbook ................................ xix Comments Welcome . xix Chapter 1. Introduction . 1 What Is NetRexx? ............................................ 1 Design Objectives . 1 Why NetRexx? . 1 Installation . 2 Installation Verification . 3 Software Prerequisites . 4 Installing the Sample Programs .................................... 4 Installing the Packages of this Redbook ............................... 5 NetRexx Documentation . 5 NetRexx Home Page on the Internet ................................. 6 Java Toolkit Documentation ...................................... 6 Chapter 2. Starting with NetRexx ................................ 7 Our First NetRexx Program ...................................... 7 File Types Used by NetRexx ...................................... 9 Chapter 3. The NetRexx Compiler ............................... 11 Command Files . 11 Arguments and Return Codes .................................... 12 How Does the Compiler Work? ................................... 13 Invoking the Compiler from NetRexx or Java ........................... 14 Compile Options . 14 Compiler-Only Options . 14 Options Keyword . 15 More Details on Options ...................................... 16 Chapter 4. The NetRexx Language .............................. 19 Case Sensitivity . 19 Comments . 19 Continuation Character . 20 Input and Output ............................................ 20 Data Types . 20 Operators and Expressions ..................................... 22 String Expressions . 22 Arithmetic Expressions . 22 Comparative Expressions . 23 Normal Comparative Operators ................................ 23 Strict Comparative Operators ................................. 23 Logical Expressions . 23 Copyright IBM Corp. 1997 iii Variables . 24 Class Definition . 25 Class Instruction . 25 Properties Instruction . 26 Method Instruction . 28 Special Keywords Used in Methods ............................... 29 Exceptions . 30 The Rexx Class for Strings ...................................... 30 Parsing a String ........................................... 30 Built-In Methods . 31 Abbrev . 31 Abs . 32 B2x . 32 Center . 32 Changestr . 32 Compare . 32 Copies . 32 Countstr . 32 C2d . 32 C2x . 32 Datatype . 33 Delstr . 33 Delword . 33 D2c . 33 D2x . 33 Exists . 34 Format . 34 Insert . 34 Lastpos . 34 Left . 34 Length . 34 Lower . 35 Max . 35 Min . 35 Overlay . 35 Pos . 35 Reverse . 35 Right . 35 Sequence . 35 Sign . 36 Space . 36 Strip . 36 Substr . 36 Subword . 36 Translate . 36 Trunc . 36 Upper . 36 Verify . ..