Manuals / IBM / Kitchen Appliance / Frozen Dessert Maker

IBM AS/400 manual How to Ignore Status and Notify Messages, Handling Exceptions249

Models: AS/400

1 489

Page 273

	*----------------------------------------------------------------
	* Handle information or warning messages, otherwise percolate
	*----------------------------------------------------------------
C	IF	MsgSev <= Warning
C	EVAL	Action = Handle
C	ELSE
C	EVAL	Action = Percolate
C	ENDIF
C	RETURN

Figure	121. How to Ignore Status and Notify Messages

Chapter 12. Handling Exceptions249

Page 273

Image 273

IBM AS/400 manual How to Ignore Status and Notify Messages, Handling Exceptions249

Contents

ILE RPG for AS/400 Programmers Guide AS/400eVersion Page ILE RPG for AS/400 Programmers Guide AS/400eVersion Edition Third1999 commentsRPG Introduction Contentswith a Service Program ChapterCreating vi ILE DebuggingHandling Chapter 14. Defining Files Working with Files and DevicesFiles FilesAppendix B. Using the RPG III to RPG AppendixesChapter 19. Example of an RPG forCOPY Indexcountry Noticessuch provisions are inconsistentProgramming Interface Information Trademarks and ServiceNotices xiv ILE RPG for AS/400 Programmers Guide About This Guide GuideWho Should Use This Prerequisite and Related Information How to Send Your CommentsWhat s New ThisRelease? EVAL NODEBUGIONumbers EVALRAbout This Guidexix ElementElement xx ILE RPG for AS/400 Programmers GuideChanges to this Guidexxii ILE RPG for AS/400 Programmers Guide ILE RPG Introduction 2 ILE RPG for AS/400 Programmers Guide Chapter 1. Overview RPG IV SpecificationsRPG IV Overview sectionCycle Programming RPG IV OverviewFigure 1. RPG Program Logic Cycle Indicators Subprocedure logicRPG IV Overview The firstProgram Operation CodesExample of an ILE RPG Example of an ILE RPG ProgramProgram Control SpecificationsFile Description Specifications Example of an ILE RPG Program Output SpecificationsNAME RATEExample of an ILE RPG Program A SubprocedureREGISTER Chapter 1. Overview of the RPG IV Programming9 LanguageThe Entire Source Program Example of an ILE RPG ProgramThis program creates a printed output of employees pay for the weekExample of an ILE RPG Program Figure 4 Part 2 of 3. A Sample Payroll Calculation ProgramChapter 1. Overview of the RPG IV Programming11Language Interacting with the System UsingOS/400 System UsingApplication Development ToolsAS/400 Tools for AS/400AS/400 Tools IBM VisualAge RPG and Cooperative Development Environment for AS/400¹ Program verification- performs, at the workstation, the full range o AS/400 Tools16 ILE RPG for AS/400 Programmers Guide AS/400 ToolsChapter 2. RPG Programming in ILE Program CreationRPG Programming in ILE RPG Programming in ILE or CRTSRVPGMFigure 5. Program Creation in ILE Program Management Program Callin ILE Bindable APIs Source DebuggingRPG Programming in ILE shownRPG Programming in ILE Multithreaded Applicationssuppo THREAD*SEREALIZE22 ILE RPG for AS/400 Programmers Guide RPG Programming in ILEStrategy 1 OPM-Compatible Application Chapter 3. Program Creation StrategiesMethod OPM-Compatible ApplicationExample of OPM-Compatible Program Effect of ILEOPM-Compatible Application ILE Program Using CRTBNDRPG UsingRelated Information CRTBNDRPGUsing Example of ILE ProgramILE Program Using CRTBNDRPG Figure 7. ILE Program Using CRTBNDRPGCRTRPGMOD ILE Application Using CRTRPGMODStrategy 3 ILE Application Related InformationILE Application Using CRTRPGMOD ScenarioMethod Single-Language ILE ApplicationMixed-Language ILE Application Scenario ILE Application Using CRTRPGMODFigure 8. Single-Language Application Using CRTRPGMOD and CRTPGM Advanced Application Scenario ILE Application Using CRTRPGMODMixed-Language Application A Strategy to Avoid A Strategy to AvoidService Related InformationA Strategy to Avoid the default activation group and any named activationWhen splitMultiple Procedures Module Chapter 4. Creating an Application Using Multiple ProceduresPrototyped Calls Multiple Procedures ModuleMODULE Prototype for procedure FmtCust Note the PR on definition Multiple Procedures Modulespecification. It has two output parameters 13. Prototype for FmtCust ProcedureMultiple Example of Module withExample of Module with Multiple Procedures NumToC Proceduresin Fmt module Example of Module with Multiple ProceduresExample of Module with Multiple Procedures The Entire ARRSRPT ProgramARRSRPT *PGM ARRSRPT *MODULE Main Procedure InArrears FmtCust Figure 22 PartFigure 22 Part Example of Module with Multiple ProceduresILE RPG Complete Source for ARRSRPT Module 42 ILE RPG for AS/400 Programmers GuideChapter 4. Creating an Application Using Multiple43 Procedures Example of Module with Multiple ProceduresSUBDUR DaysLate*DARRSRPT Output for ARRSRPTCoding Considerations General ConsiderationsCoding Considerations Subprocedure Considerations Main Procedure ConsiderationsProgram Creation Coding ConsiderationsMain Procedures SubproceduresFor Further Information For Further Information Prototyped CallCreating Application50 ILE RPG for AS/400 Programmers Guide File StatementsChapter 5. Entering SourceUsing SEU Using the Source Entry UtilityUsing SEU Procedure EMPTYPE returns a string representing the employee Using SEUtype indicated by the parameter CODE 28. Source for EMPRPT memberUsing SQL Statements Using SQL Statementsfor AS/400 SQL Programming manual and theDB2 UDB for AS/400 SQL Using SQL StatementsReference for more Refer toADTS thefor AS/400 Source EntryUsing the CRTBNDRPG Command CommandUsing the CRTBNDRPG CRTBNDRPGListing Using the CRTBNDRPG CommandOptions CreationCreating a Program for Source Debugging Using the CRTBNDRPG CommandConsiderations Binding Creating a Program with StaticUsing the CRTBNDRPG Command Using Command¹ WRKOUTQ queue-name Creating an OPM-CompatiblePart Using the CRTBNDRPG CommandA Sample Payroll Calculation Program Figure 32 Part 2 of 2. A Sample Payroll Calculation ProgramUsing a Compiler Listing Using a Compiler ListingListing Obtaining a CompilerCustomizing a Page Heading Customizing a Compiler Listinga Compiler Listing UsingIndenting Structured Operations Customizing the SpacingUsing a Compiler Listing The /SPACEListing ErrorsCompilation UsingUsing In-Line Diagnostic Messages Using aCompiler Listing Using Additional-Diagnostic Messages Correcting Run-time ErrorsBrowsing a Compiler Listing Using SEU Using a Compiler ListingMaintenance Using a Compiler Listing forCoordinating Listing Options with Debug View Options Using a Compiler ListingData AreaChapter 6. Creating a Program with the CRTBNDRPG Command71 Accessing the RETURNCODE Data Area72 ILE RPG for AS/400 Programmers Guide Accessing the RETURNCODE Data Area7. Creating Commandsa Module Object ChapterCommand Using the CRTRPGMODCreating a Module Object Creating a Module Object Creating a NOMAIN ModuleCreating a Module Object COPY TRANSPFigure 36 Part 1 of 3. Source for TRANSSVC member Part Creating a Module ObjectSource for TRANSSVC member PartCreating a Module for Creating a Module ObjectDebugging Creating a Module Object Source for TRANSRPT moduleOFLIND*INOF Additional Examples Related CL CommandsModules Behavior of Bound ILEBinding Modules into a ProgramBinding Modules into a Program Using into aCRTPGM Binding Modules into a Program GroupValue Concepts for Binding Modules into a ProgramCRTRPGMOD MODULEMYLIB/TRANSRPT CRTRPGMOD MODULEMYLIB/TRANSSVCUsing a Binder Listing Using a Binder ListingRelated CL Commands Additional ExamplesChanging a Module or Changing a Module or ProgramBASIC FULLLevel Using the UPDPGM CommandChanging the Optimization Changing a Module or ProgramSize Removing ObservabilityReducing an Objects Changing a Module or ProgramChanging a 90 ILE RPG for AS/400 Programmers Guide Changing a Module or ProgramChapter 8. Creating a Service Program Service Program OverviewService Program Overview Strategies for Creating Service Programs Creating a Service Program Using CRTSRVPGMCreating a Service Program Changing A Service Program Related CL commandsa Service Program Using CRTSRVPGM Sample Service Program Sample Service ProgramSample Service Program Figure 42 Part 1 of 2. Source for Service Program CvtToHexChapter 8. Creating a Service Program95 Source for Service Program CvtToHex Sample Service Program42 Part 96 ILE RPG for AS/400 Programmers GuideSample Service Program Creating the Service Program43. Source for /COPY Member with Prototype for CvtToHex Figure 44. Source for Binder Language for CvtToHexSample Service Program Binding to a ProgramMODUL 98 ILE RPG for AS/400 Programmers GuideProgram to test Service Program CVTTOHEX Sample Service ProgramSample Binder Listing Updating the Serviceadd a to anSample Service Program Chapter 8. Creating a Service Program101Basic Binder listing for CVTHEXPGM 102 ILE RPG for AS/400 Programmers Guide Sample Service ProgramChapter 9. Running a Program Running a Program Using the CL CALL CommandPassing Parameters using the CALLRunning a Program Using the CL CALL Command Part Running a Program Using the CL CALL CommandILE RPG Program that Requires Parameters at Run Time PartApplication Running a Program From a Menu-Driven ApplicationRunning a Program From a Running a Program From a Menu-Driven Application Figure 50. Data Description Specification of an Application MenuA* CMDPROMPT Figure 51. Source for Menu ProgramCommand Replying to Run-Time Inquiry MessagesReplying to Run-Time Inquiry Ending an ILE Program GroupsManaging Activation Managing Activation Groups Specifying an ActivationGroup Default CompatibilityRunning in the OPM Deleting an Activation Reclaim Resources CommandGroup Managing Activation GroupsManaging the Default Heap Using RPG Operations Managing Dynamically-AllocatedStorage Managing Dynamically-Allocated Storage Name?ENDDO Managing Dynamically-Allocated Storage Chapter 9. Running a Program115next@ Managing Dynamically-Allocated Storage 116 ILE RPG for AS/400 Programmers Guidename@ 52 Part Managing Dynamically-Allocated Storage4 of 5. Memory Management - Build a Linked List of Names Chapter 9. Running a Program117Heap Storage Problems Managing Dynamically-Allocated Storageof 5. Memory Management - Build a Linked List of Names Managing Your Own Heap Managing Dynamically-Allocated StorageBindable APIs Managing Dynamically-Allocated Storage SeeAPI theReference54. /COPY file DYNARRI containing prototypes for DYNARRAY module Part Managing Dynamically-Allocated Storageof 2. Global variables and local prototypes for DYNARRAY Chapter 9. Running a Program121Managing Dynamically-Allocated Storage Figure 56 on page 123 shows the subprocedures in DYNARRAYFigure 55 Part 2 ofDYNARRAY Subprocedures DYNARRAY SubproceduresManaging Dynamically-Allocated Storage PartManaging Dynamically-Allocated Storage DYNARRAY SubproceduresPart 3 of 124 ILE RPG for AS/400 Programmers GuideDYNARRAY Subprocedures DYNARRAY SubproceduresManaging Dynamically-Allocated Storage PartManaging Dynamically-Allocated Storage The logic of the subprocedures is as followsChapter 10. Calling Programs and Procedures Program/Procedure Call OverviewProgram/Procedure Call Overview Calling Programs Calling ProceduresProgram/Procedure Call Overview callsProgram/Procedure Call Overview The Call StackThe call stack stackRecursive Calls Program/Procedure Call Overview59. Three Modules, each with subprocedures Parameter-Passing Considerations Program/Procedure Call Overview60. Recursive Call Stack To Be Avoided 132 ILE RPG for AS/400 Programmers Guide Program/Procedure Call OverviewUsing the CALLP Operation Using a PrototypedCall Calling within an Expression Using a Prototyped CallPassing Prototyped Parameters Examples of Free-Form CallParameter Passing Styles Passing by ReferencePassing by Value Passing Prototyped Parameters2 * MinLengthFirst + LengthLast + 1 %sizeName Passing Passing Prototyped ParametersUsing Operational Descriptors Passing Prototyped ParametersPrototype for ILE CEE API CEETSTA with CONST Parameter Passing Prototyped Parameters Omitting ParametersLen returns a 10-digit integer value. The parameter is a character string passed by read-only referenceLeaving Out Parameters Passing *OMITPassing Prototyped Parameters 67. Prototype for System API QCMDEXC with Optional ParameterChecking for the Number Passing Prototyped ParametersPassed Passing Prototyped Parameters Source for procedure FMTADDR3. Concatenate the complete address 4. Return 68 PartFigure 68 Part 2 of 2. Source for procedure FMTADDR 69. Source for /COPY member with Prototype for Procedure FMTADDRPassing Prototyped Parameters Passing Prototyped Parameters Source for procedure PRTADDR70 Part DIM2Parameters Passing Less Data Than RequiredInterlanguage Calls Order of EvaluationPassing Prototyped Parameters effectCalling Considerations InterlanguageUsing Call OperationsUsing V4R4M0CALLB only Using the Fixed-Form Call OperationsExamples of CALL and CALLB Passing Parameters Using PARMOperations PLISTthe Fixed-Form Call Operations Using the PLIST OperationProcedure Returning from a Main ProcedureNormal End Returning from a CalledAbnormal End Returning from a Called Program or ProcedureReturning from a Subprocedure Returning from a Called Program or Procedurewithout Using Bindable APIs Returning using ILE BindableAPIs Examples of Using Bindable APIs Calling a Graphics RoutineCalling a Graphics Routine Calling Special Routines Multithreading ConsiderationsMultithreading Considerations How to AcrossShare Data to Avoid Deadlock Multithreading ConsiderationsModules Deadlock Example Considerations¹ Debug an Integrated Language Environment application by using the Debugging and Exception HandlingThis section describes how to Language Environment source debugger162 ILE RPG for AS/400 Programmers Guide Chapter 11. Debugging Programs The ILE Source DebuggerThe ILE Source Debugger The ILE Source Debugger Debug CommandsATTR EQUATEThe ILE Source Debugger 3. EnterPF1 HelpTBREAK THREADPreparing a Program for Preparing a Program for DebuggingCreating a Root Source View for DebuggingCRTRPGMOD or Creating a COPY Source a Listing ViewPreparing a Program for Debugging CreatingView a StatementProgram for Debugging CreatingStarting the ILE Source Debugger Starting the ILE SourceSTRDBG Example Setting Debug OptionsStarting the ILE Source Debugger Display Module Source display for program DEBUGEXOPM source debug support field, and Example of Removing ILE Programs from a Debug Session ServiceExample of Adding a Adding/Removing Programs from a Debug SessionViewing the Program Source Viewing the Program SourceViewing a Different Viewing the Program SourceModule Module Changing the View of a79. Source View of ILE C procedure cproc Viewing the Program SourceSetting and Removing Breakpoints Setting and Removing BreakpointsBreakpoints Setting and RemovingSetting and Removing Breakpoints UnconditionalBreakpoint Setting anSetting and Removing Unconditional Thread Breakpoints Setting and Removing BreakpointsFigure 81. Setting an Unconditional Job Breakpoint Breakpoints Setting and RemovingExample of Setting a Conditional Job Breakpoint Using F13 Setting and Removing BreakpointsLine Command National Language Sort Sequence NLSSSetting and Removing Breakpoints 184 ILE RPG for AS/400 Programmers Guide Setting and Removing BreakpointsSetting Setting and Removing JobUsing StatementSetting a Breakpoint Using Statement View Setting and Removing BreakpointsFigure 84. Sample Section of the Listing with OPTION*NOSRCSTMT Figure 85. Sample Section of the Compiler Listing with OPTION*SRCSTMTSetting and Removing Conditional Thread Breakpoints Using the Work with Module Breakpoints DisplaySetting and Removing Breakpoints Setting and Removing Watch Conditions Debug CommandsRemoving All Job and ConditionsSetting and Removing Watch Conditions Characteristics of WatchesDisplay SourceCommand Setting Watch ConditionsSetting and Removing Watch Conditions Example of a Work with Watch DisplaySetting and Removing Watch Conditions Figure 89. Example of a Display Watch WindowChapter 11. Debugging Programs191 Displaying Active Watches Setting and Removing Watch ConditionsRemoving Watch Conditions Example of Setting a Watch Condition Example of Setting a Watch ConditionStepping Through the Program Object ObjectSTEP number-of-statements OVER Stepping Over Call StatementsStepping Through the Program Object Stepping Into Call StatementsStepping Through the Program Object Stepping Through the Program Object ENTRYPLIST Displaying Data and Expressions Figure 95. Stepping into Subprocedure SwitchStepping Through the Program Object Displaying a Field using the EVAL debug command Stepping Through the Program Objectˆ LASTNAME = Jones Stepping Through the Program Object Unexpected Results when Evaluating VariablesScalar FieldsDisplaying the Contents of a Table Displaying the Contents of an ArrayStepping Through the Program Object variablefield-name isStepping Through the Program Object Displaying Data StructuresDisplaying Indicators Using EVAL with Data StructuresStepping Through the Program Object in Character Format Displaying Fields as Hexadecimal ValuesStepping Through the Program Object DisplayingDisplaying Variable-Length Fields Databy Pointers Displaying Null-Capable FieldsFigure 102. Examples of %SUBSTR using DBGEX Stepping Through the Program ObjectChapter 11. Debugging Programs207 Value FieldsChanging the Value of Fields Equating a Name with a Field, Expression, or Command or CommandDisplaying Attributes of a Field Equating a Name withILE RPG Sample Source for Debug ExamplesExamples Figure 105 Part 1 of 4. Source for Module DBGEX Sample Source for Debug ExamplesSample Source for Debug Examples PARM1 is used when calling RPGPROG programPointers Date, Time, TimestampFigure 105 Part Sample Source for Debug ExamplesSource for Module DBGEX 214 ILE RPG for AS/400 Programmers Guide105 Part 4 of Sample Source for Debug ExamplesSource for Module DBGEX. DBGEX is the main module of the programSample Source for Debug Examples Figure 107. Source for C Procedure cproc. cproc is called by DBGEXchar *cprocunsigned int size, char *inzval char *ptrChapter 12. Handling Exceptions Exception Handling OverviewException Handling Overview Each Exception Handling Overviewboundary is controlreached boundary. A 218 ILE RPG for AS/400 Programmers GuideCall Stack and Exception Message Percolation Exception Handling OverviewILE RPG Exception Handling Exception Handling OverviewMain Exception Handling HandlingINFSR Handling Exception Handling OverviewUsing Exception Handlers Using Exception HandlersException Handler Priority Nested ExceptionsFor other Using Exception Handlerstypes of messagesExample of Unhandled Function Check Using Exception HandlersNote The Using RPG-Specific Handlers Optimization Considerationskeyword, ILE Extender Specifying Error Indicators or the Eblank Using an Error SubroutineBEGSR Using a File Error INFSR SubroutineTRNSUPDT This program is a simple inventory update program If the record is found, update the quantity in the master file Access the product master file using the transaction productIf unexpected error occurs, cause inquiry message to be issued numberspec Using a Program Error SubroutineExample of *PSSR Subroutine in Main Procedure ‘*DETC’Chapter 12. Handling Exceptions233 234 ILE RPG for AS/400 Programmers Guide 113. Example of Subprocedure *PSSR Subroutine with GOTOAvoiding MOVE Specifying a Return Point Using a Condition Handler ILE Condition HandlersILE Condition Handlers RPGHDLR RPG exception handling procedure ILE Condition Handlers Action codes areSHOWERR CEEHDLR ConditionILE Condition Handlers Show exception handling using a user-definedILE Condition Handlers Register the handler and generate errorsCancel UsingHandlers APIsa local procedure Define the prototype for the cancel handler. This procedure isProcedure SubProc. Call Enabler. Since this call will fail define a local *PSSR subroutine to handle the errorEnabling and Coding a Cancel Handler for a Subprocedure Procedure Enabler. This procedure enables a cancel handlerFigure 118 Part 3 of119. Output from CANHDLR program Problems when ILE CL Monitors for Notify and Status MessagesHandler definitions If this is CPF4906, handle the notify msg, otherwise percolate120. ILE Condition Handler that Ignores CPF4906 Chapter 12. Handling Exceptions249 121. How to Ignore Status and Notify Messages250 ILE RPG for AS/400 Programmers Guide Using the DUMP Operation Code Using the DUMP Operation CodeChapter 13. Obtaining a Dump Obtaining an ILE RPG Formatted DumpDump a Formattedof a Program Status InformationDump Feedback Areasof a Figure 123. Feedback Areas section of Formatted Dump Example of a Formatted DumpData Information of aDump Example of a Formatted Dump Figure 125 Part 1 of 2. Data section of Formatted Dump256 ILE RPG for AS/400 Programmers Guide Example of a Formatted Dump Example of a Formatted Dump Working with Files and Devices 260 ILE RPG for AS/400 Programmers Guide Chapter 14. Defining Files Associating Files with Input/Output DevicesAssociating Files with Input/Output Devices Associating Files with Input/Output Devices DeviceNaming Files Types of File DescriptionsTypes of File Descriptions Program-Described Using Files withFiles Example of Some Typical Relationships betweenDefining Externally Described Files Defining Externally DescribedFiles Ignoring Record Formats Renaming Record-Format NamesRenaming Field Names Defining Externally Described FilesModify an Using Input SpecificationsDescription Defining Externally Described FilesDefining Externally Described FilesUsing Output Specifications Filesediting DDS Referin the Level Checking Defining Externally Described FilesOSLSREC Data Management Operations and ILE RPG I/O Operations Defining Program-Described FilesRPG I/O Operations DataOperation Data Management Operations and ILE RPG I/O OperationsOperation 272 ILE RPG for AS/400 Programmers GuideConsiderations FileOverriding and Redirecting File Input and Output Chapter 15. Generaland Output InputInput OutputFile Locking File LockingRecord Locking Record LockingSharing an Open Data PathSpooling SpoolingSRTSEQ/ALTSEQ Output SpoolingSRTSEQ/ALTSEQ in an File280 ILE RPG for AS/400 Programmers Guide SRTSEQ/ALTSEQFiles Chapter 16. AccessingDatabase Files Physical Files and Logical FilesRecord Format Specifications Using Externally Described Disk FilesAccess Path Using Externally Described Disk FilesExample of the Data Description Specifications for a Database File Using Externally Described Disk FilesThe sample DDS are for the customer master logical file CUSMSTL. The fUsing Externally Described Disk Files 140. Example of a field Reference File284 ILE RPG for AS/400 Programmers Guide Valid Keys for a Record FileDisk a Partial ArgumentsReferring to Using Externally Described Disk FilesRecord Blocking and Unblocking ¹ AUsing Externally Described Disk Files Using Program-Described Disk Files Using Program-Described Disk FilesIndexed File ArgumentsChapter 16. Accessing Database 289Files FilesHandling Record Address File Sequential FileUsing Program-Described Disk Files D K1Limits Records Methods for Processing Disk FilesRelative Record Numbers Methods for Processing Disk FilesMethods for Processing Disk Files Consecutive Processingsubsequent textSequential-by-Key Processing DATA DESCRIPTION SPECIFICATIONS DDSFigure 144 on page 294 andExamples of Sequential-by-Key Processing DiskFigure 144. DDS for database file EMPMST physical file Methods for Processing Disk Files145. DDS for database file TRWEEK physical file 146. DDS for database file EMPL1 logical fileChapter 16. Accessing Database 295Files Methods for Processing Disk FilesSequential-by-Key Processing, Example Sequential-by-Key Using READ Methods for Processing Disk Files296 ILE RPG for AS/400 Programmers Guide ENUM for Processing Disk Files298 ILE RPG for AS/400 Programmers Guide Methods for Processing Disk FilesRandom-by-Key Processing Example of Random-by-Key ProcessingMethods for Processing Disk Files Methods for Processing Disk Files Sequential-within-Limits ProcessingDisk Files Examples of Sequential-within-Limits Processing2 Sequential-within-Limits Processing Methods for Processing Disk FilesDDS for record address file LIMITS physical file Methods for Processing Disk Files Relative-Record-Number ProcessingValid File Operations Valid File OperationsChapter 16. Accessing Database 305Files Valid File Operationsan A,P,G,D,T,Z A record-address Valid File OperationsUsing Commitment Control Using Commitment ControlUsing Commitment Control Commitment Control Lockssee theBackup and Recovery manual Abridged forUsing the SpecifyingFiles 1.CRTJRNRCV JRNRCV RECEIVER Example of Using Commitment Control2.CRTJRN JRNJOURNAL JRNRCVRECEIVER 3.STRJRNPF FILEMASTER TRANS JRNJOURNALLCKLVL*ALL Control2CALL. REVISE 3ENDCMTCTLDDM Files CycleDDM Files Commitment Control inPre-V3R1 DDM Using314 ILE RPG for AS/400 Programmers Guide DDM FilesExternally AccessingDevices TypesAccessing Printer Devices Accessing Printer DevicesSpecifying PRINTER Files Handling Page OverflowOverflow Accessing Printer DevicesAccessing Printer Devices Example of Printing a Field on Every Page Example of Printing Headings on Every PageAccessing Printer Devices Chapter 17. Accessing Externally Attached319DevicesUsing the Fetch-Overflow Accessing Printer DevicesPrinting a Field on Every Page Figure 159. Overflow Printing Setting of the Overflow Indicator Accessing Printer DevicesExample of Specifying Fetch Overflow Fetch OverflowAccessing Printer Devices Use of Fetch OverflowChanging Forms Control FileInformation in Accessing Printer Devices FormsLayout of OPM PRTCTL Data Structure Accessing Tape Devices Accessing Tape DevicesUsing Sequential Files Accessing Display DevicesUsing Sequential Files FileUsing SPECIAL Files Using SPECIAL FilesFile Error Using SPECIAL FilesStatus DescriptionSPECIAL Files Example of Using a Special FileUsing SpecificationsUsing SPECIAL Files User-written program USERIOPLISTSPCL Using Externally Described WORKSTN Files Chapter 18. Using WORKSTN FilesUsing Externally Described WORKSTN Files Function¹ Output Using Externally Described WORKSTN FilesUsing Externally Described WORKSTN Files Chapter 18. Using WORKSTN Files333R RESPONSE Specifying Function Key Indicators on Display Device Files DeviceUsing Externally Described WORKSTN Files Processing an Externally Described WORKSTN File Using SubfilesUsing Externally Described WORKSTN Files Chapter 18. Using WORKSTN Files335Using Externally Described WORKSTN Files fieldSubfile Display Use of Subfiles Using Externally Described WORKSTN FilesData Description Specifications for a Subfile Record Format Using Program-Described WORKSTN Files Using Program-Described WORKSTN FilesUsing Program-Described WORKSTN Files withUsing a Program-Described Output SpecificationsCalculation Specifications Input SpecificationsName withoutInput File Valid WORKSTN File OperationsOutput File Combined FileREAD Operation EXFMT OperationWRITE Operation Multiple-Device FilesMultiple-Device Files 344 ILE RPG for AS/400 Programmers Guide Multiple-Device FilesChapter 19. Example of an Interactive Application Database Physical FileDatabase Physical File DDS for a InquiryDisplay Device Main Menu InquiryMain Menu Inquiry CUSMAIN RPG SourceIn addition to describing the constants, fields, line numbers, and hoMain Menu Inquiry Source for module CUSMAIN348 ILE RPG for AS/400 Programmers Guide File Maintenance File MaintenanceCUSMSTL1 DDS for a LogicalFile Maintenance DisplayFile DeviceFile Maintenance Figure 174 Part 2 of 2. DDS for display device file MNTMENUChapter 19. Example of an Interactive 351Application CUSMNT RPG Source File MaintenanceDSPATRPR File Maintenance Chapter 19. Example of an Interactive 353ApplicationADD NEW CUSTOMER TO FILE File Maintenance SET MAINTENANCE MODE354 ILE RPG for AS/400 Programmers Guide F6 Update File MaintenanceCustomer File Maintenance Display Mode prompt screen F3 End JobCustomer File Maintenance Display Mode screen File MaintenanceCustomer File Maintenance Add Mode prompt screen 356 ILE RPG for AS/400 Programmers GuideFile Maintenance YORKTOWNChapter 19. Example of an Interactive 357Application Search by Search by Zip CodeFile Display SZIPMENU DDSFile DeviceSearch by Zip Code 14DSPATRHIPROMPT SCHZIP RPG Source Search by Zip CodeChapter 19. Example of an Interactive 361Application 362 ILE RPG for AS/400 Programmers Guide Search by Zip Codeis written to the screen as shown in Figure 186 on page The subfileSearch and Inquiry by Name Search and Inquiry by NameFile CUSMSTL3 DDSFile DeviceSearch and Inquiry by Name SNAMMENU DDS for a DisplaySearch and Inquiry by Name SCHNAM RPG SourceChapter 19. Example of an Interactive 367Application Search and Inquiry by Name¹ To Search and Inquiry by NameSUBROUTINE requests The usermore information bySearch and Inquiry by Name 192. Customer Search and Inquiry by Name detailed information screen370 ILE RPG for AS/400 Programmers Guide  Copyright IBM Corp. 1994 Appendixes372 ILE RPG for AS/400 Programmers Guide and ILE RPG/400AS/400 AppendixRunning Differences Between OPM RPG/400 and ILE RPGDebugging and Exception RPG/400 Differences Between OPM RPG/400 ILE RPGDBCS Data in Character Fields ILE RPGDBCS ILE RPG 378 ILE RPG for AS/400 Programmers GuideDifferences Between OPM RPG/400 Conversion Overview Appendix B. UsingConversion Conversion OverviewFile Considerations File Record LengthConversion Overview Conversion Aid Tool Requirements The Log FileFile OverviewConverting Your Source Wont DoConverting Your Source What the ConversionConverting Your Source The CVTRPGSRC Commandmember namesFROMFILE Converting Your Sourcesource-file-name LIBLTOFILE Converting Your SourceQRPGLESRC NONEConverting Your Source Defaults Converting a Member UsingSource a File Converting All Members in a FilePerforming a Trial Conversion Converting Your SourceConverting Auto Report Obtaining Conversion ReportsSource Members Converting Your Sourcea Data Inserting Specification TemplatesExample of Source Conversion Example of Source Conversionof Source Conversion ExampleTo convert this source, enter The converted source is shown in Figure 195 on pageExample of Source Conversion Figure 195. Converted RPG IV Source for TEST1ARR1 Analyzing Your Conversion Analyzing Your ConversionUsing the Conversion ReportAnalyzing Your Conversion Your Sample Source Section of Conversion ReportSample Message Summary of Conversion Report Using the Log File Analyzing Your ConversionCPYF FROMFILEQRPGLE/QARNCVTLG TOFILEMYLIB/QRNCVTLG CRTFILE*YES Appendix B. Using the RPG III to RPG IV397 Conversion Aid Analyzing Your Conversion200. DDS for model log file QARNCVTLG in library QRPGLE Compilation Errors in Existing RPG III Code Resolving Conversion ProblemsUnsupported RPG III Features Resolving Conversion ProblemsConversion RPG III Source for TEST2RPG III Source for COPYDS1 Resolving Conversion Problems Context-Sensitive ProblemsUse of Externally StructuresResolving Conversion Problems Initializing Merging an Array with an Externally Described DS SubfieldResolving Conversion Problems 207. RPG III source using external data structure with arrayResolving Conversion Problems Run-time Differences210. RPG III source with renamed and initialized external subfield RPG IV source with two definitions for renamed subfield404 ILE RPG for AS/400 Programmers Guide Resolving Conversion ProblemsUsing CL Commands Appendix C. The Create CommandsHow to Interpret Syntax Diagrams Reading Syntax DiagramsCRTBNDRPG Command CRTBNDRPG CommandAppendix C. The Create Commands407 CRTBNDRPG Command3library-name/32 3description32Description of the CRTBNDRPG Command CRTBNDRPG CommandOPTION Details LIBL CRTBNDRPG CommandCURLIB SRCMBR410 ILE RPG for AS/400 Programmers Guide CRTBNDRPG CommandDEBUGIO StatementNumber = sourceID * 1000000 + sourceSEUsequencenumberEVENTF CommandDBGVIEW STMTCRTBNDRPG Command character-valueEXPDDS, and sort-table-name CRTBNDRPG CommandLANGIDUNQ LANGIDSHRREPLACE CRTBNDRPG CommandCRTBNDRPG Command 416 ILE RPG for AS/400 Programmers GuideLIBCRTAUT V2R3M5 target-releaseCommand binding-directory-nameUSRCTL ENTRYEXIT CRTBNDRPG CommandCRTRPGMOD Command CRTRPGMOD CommandAppendix C. The Create Commands421 CRTRPGMOD CommandCRTRPGMOD Command Description of the CRTRPGMOD commandof CRTRPGMOD 422 ILE RPG for AS/400 Programmers GuideCompiler Listings Appendix D. Compiler ListingsPrologue Compiler ListingReading a Compiler Listings2/ Module or Program Compiler Listings3/ Source member 4/ SourceSection Compiler ListingsSample Section of the Listing with OPTION*NOSRCSTMT Appendix D. Compiler Listings427 ListingsCompiler Listings Figure 217 Part 1 of 3. Sample Source Part of the Listing428 ILE RPG for AS/400 Programmers Guide Compiler Listings Figure 217 Part 2 of 3. Sample Source Part of the ListingAppendix D. Compiler Listings429 1a/ *NOSRCSTMT Source Heading Compiler ListingsLine Number Ruler LineAdditional DiagnosticSpecifications ListingsCOPY Member Table Output Buffer PositionsSample Additional Diagnostic Messages with OPTION*NOSRCSTMT Sample Additional Diagnostic Messages with OPTION*SRCSTMTCompiler Listings Compile-Time Data1/ Total Number of Characters Altered 2/ Character to be AlteredCross-Reference Table Key Field InformationCompiler Listings Figure 223. Sample Key Field InformationExternal References List Compiler ListingsFigure 224. Sample Cross-Reference Table with OPTION*NOSRCSTMT Final Summary Message SummaryCompiler Listings Figure 225. Sample External ReferencesCode Generation and Binding Errors Compiler ListingsFigure 227. Sample Final Summary 438 ILE RPG for AS/400 Programmers Guide Compiler ListingsADTS/400 BibliographyProgramming DevelopmentFORTRAN/400 GDDMAS/400 Bibliography442 ILE RPG for AS/400 Programmers Guide Special continuedSee Add Page CALL CL commands control-record format, subfile DBCS continued debugging continued NLSS NOOPT 364accesssummary Page Page alsoDISK See long alsoPARM creationcontinued methodscontinuedcallcontinued alsoILE debuggingcontinued programcontinuedWORKSTN Page WORKSTN file definition 331 examples 345 externally described ÉÂÔÙ Part Number 99H3778 Program Number 5769-RG1 Printed in U.S.A99H3778 SC09-2507-02