Table of Contents at a Glance

Transcription

1 Table of Contents at a Glance Preface... xix Chapter 1 What Is CL?... 1 Chapter 2 Control Language Command Names... 7 Chapter 3 Command Parameters Chapter 4 The IBM i User Interface Chapter 5 Creating CL Programs Chapter 6 The Structure of a CL Program Chapter 7 Declaring Program Variables Chapter 8 Manipulating Variables with the CHGVAR Command Chapter 9 CL Control Structures Chapter 10 Expressions Chapter 11 Controlling Workflow Chapter 12 Basic Error Handling Chapter 13 Passing Parameters Chapter 14 Retrieving and Changing External Attributes Chapter 15 Files and Data Areas Chapter 16 Advanced Message Handling Chapter 17 Advanced File Techniques Chapter 18 Advanced Command Prompting Chapter 19 Using IBM-Supplied APIs Chapter 20 Displaying and Changing Command Properties Chapter 21 Understanding the Job Log Chapter 22 Understanding the Integrated Language Environment Chapter 23 User-Defined Commands Chapter 24 Command Processing Programs Chapter 25 Advanced Command Facilities Appendix A The Most-Often-Used CL Commands Appendix B Program Development Tools Appendix C Program Testing and Debugging...551

2 vii Table of Contents [Italic type indicates a sidebar.] Preface...?? INTRODUCTION TO CONTROL LANGUAGE Chapter 1 What Is CL?...1 Chapter Overview... 1 What CL Is... 1 What CL Is Not... Controlling Workflow with CL... 3 CL Execution Environment and Restrictions... 3 An Introductory Program... 3 Chapter Summary... 4 Key Terms... 4 Review Questions... 5 Chapter 2 Control Language Command Names...7 Chapter Overview... 7 Verbs and Subjects... 7 Modifiers and Subject Phrases... 9 Command Aliases...11 Chapter Summary Key Terms Review Questions Chapter 3 Command Parameters...13 Chapter Overview Command Parameters Required and Optional Parameters Entering Parameters with Keyword Notation Entering Parameters with Positional Notation The Order of Parameters Positional Keyword Limits Using *N Mixing Keyword and Positional Notation Types of Command Parameters Parameter Special Values Qualified Values Value Lists...20 Complex Lists Chapter Summary... 21

3 viii Programming in RPG IV, Fourth Edition Key Terms Review Questions Exercises...22 Chapter 4 The IBM i User Interface...25 Chapter Overview The IBM i Menu System Command-Line Operations Command-Line Function Keys The Prompt Facility The Command Prompt Display Determining Allowable Values Command-Prompt Function Keys Additional Parameters Prompt Special Characters Finding the Right CL Command Using the CMD Menus Chapter Summary Key Terms Review Questions Exercises...47 BASIC CL PROGRAMMING Chapter 5 Creating CL Programs...49 Chapter Overview The Capabilities of CL Programs Using a Source Physical File How to Create a CL Program Adding a Source Member Using WDSc to Add a Source Member Using PDM to Add a Source Member Entering CL Commands into a Source Member Compiling the CL Source Using the CL Compiler CL Compiler Options CL Compiler Reports Analyzing Compiler Reports Diagnosing Compile-Time Errors Diagnosing Errors with WDSc Binding a Program Using a Shortcut CL and the Original Program Model...70 Chapter Summary Key Terms... 71

4 Contents ix Review Questions Programming Assignments Chapter 6 The Structure of a CL Program...77 Chapter Overview Entering CL Source Statements Free-Format Statement Entry Upper and Lower Case Blank Lines Keyword and Positional Notation Entering Program Comments Command Continuation (+ and ) Using Labels The Sections of a CL Source Member Program Information Section Program Linkage Section Declarations Section Procedure Section Putting It All Together Chapter Summary Key Terms Review Questions Programming Assignments Chapter 7 Declaring Program Variables...93 Chapter Overview What Is a Program Variable? How to Declare a Variable The DCL Command Naming Variables Specifying the Data Type Specifying the Variable Size Coding in Style...96 Initializing the Value of a Variable Assigning Values to *CHAR Variables Assigning Values to *LGL Variables Assigning Values to Numeric Variables Miscellaneous Rules for Initial Values Using DCL with Pointers Declaring Based Variables Declaring Defined Variables More DCL Examples The DCLF Command DCLF Examples...104

5 x Programming in RPG IV, Fourth Edition Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 8 Manipulating Variables with the CHGVAR Command Chapter Overview The CHGVAR (Change Variable) Command Using CHGVAR with Character Variables Using CHGVAR with Numeric Variables Using CHGVAR with Logical Variables Performing Data Conversion with CHGVAR Converting Numeric Data to Character Data Converting Character Data to Numeric Data Using a Variable to Specify VALUE Using an Arithmetic Expression to Specify VALUE Using a Character String Expression to Specify VALUE Using Built-In Functions Using %SUBSTRING Using %BINARY Using Built-In Functions in the Receiver Variable The DMPCLPGM Command Using Functions with Pointers Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 9 CL Control Structures Chapter Overview CL and Structured Programming The GOTO Command IF/ELSE Structure Nested IF Structures Using the ELSE Command Nested IF/THEN/ELSE Structures DO Groups SELECT/WHEN/OTHERWISE Structure Program Looping and Iteration DOWHILE Command DOUNTIL Command DOFOR Command Loops and Early Exits...143

6 Contents xi Using Subroutines The CALLSUBR Command Leaving a Subroutine Using a Return Value The DCLPRCOPT Command Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 10 Expressions Chapter Overview What Is an Expression? Using Arithmetic Expressions Arithmetic Order of Operations Using the %BIN Function Using Character String Expressions Using the %SST Function Using Relational Expressions Relational Operators Character Operands of Different Lengths Using Relational Expressions with the CHGVAR Command Using Logical Expressions Evaluating Logical Relationships Using Logical Variables and Logical Constants Using More Than Two Operands Expression Order of Evaluation Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 11 Controlling Workflow Chapter Overview Work Management Overview What Is a Job? What Is a Job Description? What Is a Job Queue? What Is a Library List? Executing Programs with the CALL Command ILE Considerations The Call Stack...178

7 xii Programming in RPG IV, Fourth Edition Executing Programs with the TFRCTL Command The RETURN Command High-Level Language Considerations Executing Commands in Batch Using SBMJOB The CMD Parameter of the SBMJOB Command Other SBMJOB Parameters Job Definition Parameters for SBMJOB Library List Parameters for SBMJOB SBMJOB Output Parameters Scheduling Parameters for SBMJOB The Self-Submitting Program Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 12 Basic Error Handling Chapter Overview Types of Errors Error Messages Message Files The CHKOBJ Command The MONMSG Command Command-Level MONMSG Program-Level MONMSG Mixing Command- and Program-Level MONMSGs Monitoring for Generic Messages Specifying Multiple MONMSG Commands Errors Within a MONMSG The Interactive Job Log Ignoring Error Messages Receiving Escape Message Text Chapter Summary Key Terms Review Questions Exercises Programming Assignments INPUT/OUTPUT IN A CL PROGRAM Chapter 13 Passing Parameters Chapter Overview What Are Parameters? Defining Parameters in a Called Program

8 Contents xiii Passing Constants to a Called Program Passing Character Constants Passing Logical Constants Passing Decimal Constants Passing Variables to a Called Program The Mechanics of Passing Variables Passing Parameters Using the TFRCTL Command Passing Parameters Using the SBMJOB Command Using Hexadecimal Notation Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 14 Retrieving and Changing External Attributes Chapter Overview Return Variables The RTVJOBA Command The CHGJOB Command System Values The RTVSYSVAL Command The CHGSYSVAL Command Categories of System Values Date/Time System Values System Control System Values245 Library List System Value Other System Values The RTVUSRPRF Command The CHGUSRPRF Command Other RTV Commands Date Conversion Using the CVTDAT Command Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 15 Files and Data Areas Chapter Overview Working with Files Database Files Display Files CL and SQL...259

9 xiv Programming in RPG IV, Fourth Edition File Existence Requirements for CL Data Description Specifications DDS for Physical Files DDS for Logical Files DDS for Display Files Files Without DDS CL File Processing The DCLF Command The SNDRCVF Command The SNDF Command The RCVF Command The WAIT and ENDRCV Commands CL OUTFILE Support Data Areas Creating and Deleting a Data Area Displaying a Data Area s Contents Retrieving the Contents of a Data Area Changing the Contents of a Data Area The Local Data Area Chapter Summary Data Queues Key Terms Review Questions Exercises Programming Assignments ADVANCED CL PROGRAMMING Chapter 16 Advanced Message Handling Chapter Overview Messages What Is a Message? Message Queues Types of Messages Commands Used to Send Messages The SNDMSG Command The SNDBRKMSG Command The SNDPGMMSG Command The SNDUSRMSG Command Receiving Messages The TOPGMQ Parameter RCVMSG Examples Removing Messages RMVMSG Examples Standard Error-Handling Routines

10 Contents xv Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 17 Advanced File Techniques Chapter Overview Using Files in a CL Program Using File Overrides Using the OVRDBF Command Using the DLTOVR Command Using the OVRPRTF Command Positioning Database Files Preopening Database Files Using OPNQRYF Using CPYFRMQRYF Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 18 Advanced Command Prompting Chapter Overview Reviewing the Prompt Facility Simple Command Prompting Selective Prompting Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 19 Using IBM-Supplied APIs Chapter Overview Introduction to APIs Using QCMD Using QUSCMDLN Using QCMDCHK Prompting with QCMDCHK Using QCMDEXC QCMDEXC and Call Levels Other APIs...358

11 xvi Programming in RPG IV, Fourth Edition ILE Bindable APIs Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 20 Displaying and Changing Command Properties Chapter Overview Displaying the Properties of a CL Command Changing the Properties of a CL Command Changing Parameter Default Values Changing IBM-Supplied Commands Chapter Summary Key Terms Review Questions Exercises Chapter 21 Understanding the Job Log Chapter Overview What Is a Job Log? The LOG Attribute Logging CL Commands Analyzing the Job Log Keeping a Lean Job Log Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 22 Understanding the Integrated Language Environment Chapter Overview What Is ILE? What Is a Procedure? What Is a Module? What Is a Program? Creating ILE Modules and Programs One-Step Program Creation Multiple-Module Programs Updating ILE Programs Adding Modules Calling ILE Programs and Procedures Calling ILE Procedures Using a Static Call

12 Contents xvii Using Service Programs Understanding Activation Groups Default Activation Group User-Named Activation Group System-Named Activation Group *CALLER Activation Group Option *ENTMOD Activation Group Option Activation Groups Made Easy Activation Groups and File Overrides Call Stack Level Scoping Activation Group Scoping Job Scoping ILE Error Handling ILE Error-Handling Tips Chapter Summary Key Terms Review Questions Exercises Programming Assignments CREATING YOUR OWN COMMANDS Chapter 23 User-Defined Commands Chapter Overview Why Commands? The Components of a Command Command Definition Statements The CMD Statement The PARM Statement The QUAL Statement Other Command Definition Statements The CRTCMD Command Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 24 Command Processing Programs Chapter Overview Writing a Command Processing Program Parameters in the CPP Analyzing the CPP Processing List Parameters in the CPP Using QCMDEXC as a CPP

13 xviii Control Language Programming for IBM i, Third Edition Chapter Summary Key Terms Review Questions Exercises Programming Assignments Chapter 25 Advanced Command Facilities Chapter Overview Adding Help to Your Commands Using the GENCMDDOC Command UIM Tag Language Associating a Panel Group with a Command Validity Checking Programs Other Advanced Command Topics Chapter Summary Key Terms Review Questions Exercises Programming Assignments APPENDICES Appendix A The Most-Often-Used CL Commands Appendix B Program Development Tools Appendix C Program Testing and Debugging INDEX...561